Skip to main content
GET
/
v1
/
sip
/
numbers
List SIP Numbers
curl --request GET \
  --url https://api.bland.ai/v1/sip/numbers \
  --header 'authorization: <authorization>'
{
  "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
}

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.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Response

​
data.numbers
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"
Example Request
curl -X GET https://api.bland.ai/v1/sip/numbers \
  -H "Authorization: Bearer <token>"

{
  "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
}
Docs for agents: llms.txt