> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a phone number

> Get one phone number.

<Note>
  This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](/api-reference/introduction#plan-access).
</Note>

<ParamField path="id" type="string" required>
  Phone number UUID
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.nedzo.ai/v1/phone-numbers/4d1f6b52-8c0e-4a51-9b7d-2f3c4e5a6b7c" \
      -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "4d1f6b52-8c0e-4a51-9b7d-2f3c4e5a6b7c",
    "workspaceId": "19c3b12f-ec54-43ad-8686-00e921f1befd",
    "number": "+14155551234",
    "status": "active",
    "type": "inbound_outbound",
    "friendlyName": "Main line",
    "inboundAgentId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "chatAgentId": null,
    "fallbackEnabled": false,
    "fallbackNumber": null,
    "fallbackRingDuration": 20,
    "activeHours": null,
    "monthlyPriceCents": 99,
    "purchasedAt": "2026-10-11T12:00:00Z",
    "createdAt": "2026-10-11T12:00:00Z",
    "updatedAt": "2026-10-11T12:00:00Z"
  }
  ```
</ResponseExample>

See [List phone numbers](/api-reference/phone-numbers/list#fields) for what each field means. A number outside this API key's scope returns `404`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.