Skip to main content
GET
/
v1
/
sip
/
status
Get Trunk Health
curl --request GET \
  --url https://api.bland.ai/v1/sip/status \
  --header 'authorization: <authorization>'
{
  "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>"
{
  "data": {
    "status": "healthy",
    "response_time_ms": 42,
    "checked_at": "2026-03-09T12:00:00Z"
  },
  "errors": null
}