Skip to main content
GET
/
v1
/
sip
Get SIP Config
curl --request GET \
  --url https://api.bland.ai/v1/sip \
  --header 'authorization: <authorization>'
{
  "data": {
    "inbound": {
      "number": "+14150000000",
      "id": "abc123",
      "org_id": "org_456",
      "direction": "inbound",
      "sip_endpoint": null,
      "created_at": "2026-03-09T12:00:00Z",
      "updated_at": "2026-03-09T12:00:00Z",
      "headers": null,
      "options": {
        "auth_mode": "ip"
      }
    },
    "outbound": {
      "number": "+14150000000",
      "id": "def789",
      "org_id": "org_456",
      "direction": "outbound",
      "sip_endpoint": "sip:trunk.provider.com",
      "created_at": "2026-03-09T12:00:00Z",
      "updated_at": "2026-03-09T12:00:00Z",
      "headers": null,
      "options": {
        "port": 5061,
        "transport": "tls",
        "secure_media": true
      }
    }
  },
  "errors": null
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Query Parameters

​
phone_number
string
required
The phone number to fetch SIP configuration for. Must be in E.164 format.

​
Response

​
data.inbound
object
Inbound SIP configuration, or null if not configured. Includes number, id, org_id, direction, sip_endpoint, headers, options, created_at, and updated_at. Sensitive fields (credentials) are redacted.
​
data.outbound
object
Outbound SIP configuration, or null if not configured. Same fields as inbound.
Example Request
curl -X GET 'https://api.bland.ai/v1/sip?phone_number=%2B14150000000' \
  -H "Authorization: Bearer <token>"

{
  "data": {
    "inbound": {
      "number": "+14150000000",
      "id": "abc123",
      "org_id": "org_456",
      "direction": "inbound",
      "sip_endpoint": null,
      "created_at": "2026-03-09T12:00:00Z",
      "updated_at": "2026-03-09T12:00:00Z",
      "headers": null,
      "options": {
        "auth_mode": "ip"
      }
    },
    "outbound": {
      "number": "+14150000000",
      "id": "def789",
      "org_id": "org_456",
      "direction": "outbound",
      "sip_endpoint": "sip:trunk.provider.com",
      "created_at": "2026-03-09T12:00:00Z",
      "updated_at": "2026-03-09T12:00:00Z",
      "headers": null,
      "options": {
        "port": 5061,
        "transport": "tls",
        "secure_media": true
      }
    }
  },
  "errors": null
}