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

# List SIP Numbers

> List all phone numbers with SIP configurations for your organization.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Response

<ResponseField name="data.numbers" type="array">
  Array of SIP number summaries. Each entry includes:

  * `phone_number` (string) — The phone number in E.164 format
  * `directions` (array) — List of configured directions (`"inbound"`, `"outbound"`)
  * `sip_endpoint` (string) — The SIP endpoint (for outbound)
  * `health_status` (string) — Current health: `"healthy"`, `"unreachable"`, or `"unchecked"`
</ResponseField>

```json Example Request theme={null}
curl -X GET https://api.bland.ai/v1/sip/numbers \
  -H "Authorization: Bearer <token>"
```

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "numbers": [
        {
          "phone_number": "+14150000000",
          "directions": ["inbound", "outbound"],
          "sip_endpoint": "sip:trunk.provider.com",
          "health_status": "healthy"
        },
        {
          "phone_number": "+14150000001",
          "directions": ["inbound"],
          "sip_endpoint": null,
          "health_status": "unchecked"
        }
      ]
    },
    "errors": null
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)