---
title: "Get Phone Number"
method: GET
path: "/contacts/{contactId}/phone-numbers/{phoneId}"
tags: ["contacts"]
---

# Get Phone Number

`GET /contacts/{contactId}/phone-numbers/{phoneId}`

Use this endpoint to get the phone number for a specific phoneId associated with a specific contact.

## Path parameters

- `contactId` string, uuid, required
- `phoneId` string, uuid, required

## Response `200`

OK

- PhoneNumber
  - `id` string, uuid — The GUID of the Phone Number.
  - `_link` string — The URI of the Phone Number.
  - `number` string — 10 digit phone number.
  - `ext` string
  - `type` 'Home' | 'Mobile' | 'Work'
  - `primary` boolean — Is this phone number the primary phone number for the related entity?
  - `smsOptOut` boolean, nullable — This value specifies if SMS messaging is active for this contact number.

## Other responses

- `400` — Bad Request - The server cannot process the request due to a client error. Common causes: - Invalid request format - Missing required fields - Validation errors in the request data
- `401` — Unauthorized - Authentication is required or has failed. Common causes: - Missing API key - Invalid API key - Expired or deactivated API key
- `404` — Not Found - The requested resource does not exist. Common causes: - Invalid subscription ID - Subscription has been deleted - URL path contains typos or incorrect values

---

[API](https://skmtc.net/acculynx/apis/acculynx-api-v2.md) · [All operations](https://skmtc.net/acculynx/apis/acculynx-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/acculynx/acculynx-api-v2/revisions/3a9e3886e400/schema)