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

# Get phone number

> Retrieve one phone number, with the assistants it answers and dials with.

Returns a single phone number.

## Path parameters

<ParamField path="id" type="string" required>
  UUID of the phone number.
</ParamField>

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.verbeo.ai/v1/phone-number/7d9f3b52-4c1e-4a8e-9b1a-2f6c0d4e8a11" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const id = "7d9f3b52-4c1e-4a8e-9b1a-2f6c0d4e8a11";
  const res = await fetch(`https://api.verbeo.ai/v1/phone-number/${id}`, {
    headers: { Authorization: `Bearer ${process.env.VERBEO_API_KEY}` },
  });
  const { data: number } = await res.json();
  ```

  ```python Python theme={null}
  import os, requests

  number_id = "7d9f3b52-4c1e-4a8e-9b1a-2f6c0d4e8a11"
  res = requests.get(
      f"https://api.verbeo.ai/v1/phone-number/{number_id}",
      headers={"Authorization": f"Bearer {os.environ['VERBEO_API_KEY']}"},
  )
  number = res.json()["data"]
  ```
</CodeGroup>

## Response

`200 OK` with [the phone number object](/api-reference/phone-numbers/overview#the-phone-number-object).

```json theme={null}
{
  "success": true,
  "data": {
    "id": "7d9f3b52-4c1e-4a8e-9b1a-2f6c0d4e8a11",
    "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
    "phone_number": "+14155550123",
    "nickname": "Main line",
    "provider": "livekit_sip",
    "is_active": true,
    "max_cps": 1,
    "inbound_agent_id": "550e8400-e29b-41d4-a716-446655440000",
    "outbound_agent_id": null,
    "inbound_webhook_url": null,
    "created_at": "2026-01-15T10:30:00.123456+00:00",
    "updated_at": "2026-01-22T14:00:00.654321+00:00",
    "inbound_agent_name": "Customer Support",
    "outbound_agent_name": null
  }
}
```

## Errors

| Code | Status | When |
| - | - | - |
| `NOT_FOUND` | 404 | No such phone number, or it belongs to another workspace. The two are deliberately indistinguishable. |
| `VALIDATION_FAILED` | 422 | `id` is not a UUID. |


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