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

# List Phone Numbers

> Retrieve a list of all phone numbers.

<Note>
  Retrieve your API Key from your [VozAgent Dashboard](https://app.vozagent.ai/settings/api).
</Note>

## Query parameters

<ParamField query="status" type="string">
  Filter by status: `active`, `inactive`, or `pending`.
</ParamField>

<ParamField query="provider" type="string">
  Filter by provider: `twilio`, `vapi`, `telnyx`, etc.
</ParamField>

## Response

Returns an array of phone number objects with their configuration.

<ResponseField name="id" type="string">
  Unique phone number identifier.
</ResponseField>

<ResponseField name="phone_number" type="string">
  Phone number in E.164 format.
</ResponseField>

<ResponseField name="label" type="string">
  Display label for the number.
</ResponseField>

<ResponseField name="provider" type="string">
  Telephony provider.
</ResponseField>

<ResponseField name="status" type="string">
  Current status.
</ResponseField>

<ResponseField name="assistant_id" type="string">
  Linked inbound assistant ID.
</ResponseField>

<ResponseField name="sms_enabled" type="boolean">
  Whether SMS is enabled.
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl https://api.vozagent.ai/v1/phone-numbers \
    -H "Authorization: Bearer <token>"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  [
    {
      "id": "pn-a1b2c3d4-e5f6-a7b8-c9d0",
      "phone_number": "+15551234567",
      "label": "Main Line",
      "provider": "twilio",
      "status": "active",
      "assistant_id": "a1b2c3d4-e5f6-a7b8",
      "sms_enabled": true,
      "monthly_cost_cents": 200,
      "created_at": "2024-01-10T09:00:00Z"
    },
    {
      "id": "pn-b2c3d4e5-f6a7-b8c9-d0e1",
      "phone_number": "+15559876543",
      "label": "Sales Line",
      "provider": "vapi",
      "status": "active",
      "assistant_id": null,
      "sms_enabled": false,
      "monthly_cost_cents": 150,
      "created_at": "2024-01-12T14:30:00Z"
    }
  ]
  ```
</ResponseExample>