---
title: "Get a phone number"
method: GET
path: "/numbers/{phone_number_slug}"
tags: ["phoneNumbers"]
---

# Get a phone number

`GET /numbers/{phone_number_slug}`

Retrieves detailed information about a specific phone number.

## Path parameters

- `phone_number_slug` string, required

## Query parameters

- `workspace` string, required

## Headers

- `Authorization` string, required

## Response `200`

200

- PhoneNumbersGetPhoneNumberResponse200
  - `slug` string — The phone number slug (phone number without the leading +).
  - `address_requirement` string — Address requirement for the phone number.
  - `phone_number` string — The full phone number in E.164 format.
  - `friendly_name` string — A human-readable name for the phone number.
  - `is_sms_capable` boolean — Whether the phone number can send and receive SMS.
  - `is_voice_capable` boolean — Whether the phone number can make and receive voice calls.
  - `iso_country` string — ISO country code for the phone number.
  - `locality` string — The locality or city associated with the phone number.
  - `sip_auth_username` string, nullable — SIP authentication username, if configured.
  - `sip_outbound_proxy` string, nullable — SIP outbound proxy, if configured.
  - `sip_term_uri` string — SIP termination URI.
  - `uac_enabled` boolean — Whether outbound SIP registration (REGISTER) is enabled for this number.
  - `uac_register_expires` integer, nullable — SIP registration refresh interval in seconds when registration is enabled.
  - `sid` string — Phone number SID from the provider.
  - `provider_name` string — Name of the telephony provider. Common values include `twilio`, `telnyx`, `vonage`, `ring_central`, `ringcx`, `custom`, `zoom`, and `five9`.
  - `region` string — The region associated with the phone number.
  - `is_available` boolean — Whether the number is available for inbound assignment.
  - `agency_workspace_id` string, nullable — Agency workspace ID, if applicable.
  - `workspace_id` string — The workspace ID the phone number belongs to.
  - `created_at` string, date-time — Timestamp when the phone number was created.
  - `updated_at` string, date-time, nullable — Timestamp when the phone number was last updated.
  - `assistants` string[] — List of assistant IDs attached to this phone number.

## Other responses

- `400` — 400

---

[API](https://skmtc.net/synthflow/apis/platform-api.md) · [All operations](https://skmtc.net/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthflow/platform-api/versions/decb652b52e0/schema)