Get Trunk Health

Get the health status of a SIP trunk by probing the endpoint with SIP OPTIONS.

GET /v1/sip/status

Get Trunk Health

cURL

curl --request GET \
  --url https://api.bland.ai/v1/sip/status \
  --header 'authorization: <authorization>'

Response

{
  "data": {
    "status": "healthy",
    "response_time_ms": 42,
    "checked_at": "2026-03-09T12:00:00Z"
  },
  "errors": null
}

Headers

authorization · string · required

Your API key for authentication.

Query Parameters

phone_number · string · required

The phone number to check health for. Must be in E.164 format.

Response

status · string

Health status: "healthy", "unreachable", or "unchecked". Inbound-only trunks show "unchecked" since there is no outbound endpoint to probe.

response_time_ms · number

Response time of the SIP OPTIONS probe in milliseconds. null if unreachable or unchecked.

checked_at · string

ISO 8601 timestamp of when the health check was performed.

Example Request

curl -X GET 'https://api.bland.ai/v1/sip/status?phone_number=%2B14150000000' \
  -H "Authorization: Bearer <token>"

Response

{
  "data": {
    "status": "healthy",
    "response_time_ms": 42,
    "checked_at": "2026-03-09T12:00:00Z"
  },
  "errors": null
}

---

Docs for agents: llm.txt