Skip to main content
POST
/
v1
/
sip
/
parse-destination
Parse SIP Destination
curl --request POST \
  --url https://api.bland.ai/v1/sip/parse-destination \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "input": "<string>"
}
'
{
  "data": {
    "valid": true,
    "parsed": {
      "host": "your.provider.com",
      "port": 5061,
      "transport": "tls",
      "is_private_ip": false,
      "normalized": "sip:your.provider.com:5061;transport=tls"
    }
  },
  "errors": null
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body

​
input
string
required
The SIP destination to parse. Accepts flexible formats — a hostname or IP (sip.provider.com, 203.0.113.10), a full SIP URI (sip:user@host:5061;transport=tls), or shorthand (tls://host, host:5061).

​
Response

​
valid
boolean
Whether the input could be parsed into a usable SIP destination.
​
parsed
object
The parsed destination when valid is true, otherwise null.
Use the parsed host, port, and transport to populate the sip_endpoint and options of a trunk or a POST /v1/sip/attach request.
Example Request
curl -X POST https://api.bland.ai/v1/sip/parse-destination \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "sip:your.provider.com:5061;transport=tls"
  }'

{
  "data": {
    "valid": true,
    "parsed": {
      "host": "your.provider.com",
      "port": 5061,
      "transport": "tls",
      "is_private_ip": false,
      "normalized": "sip:your.provider.com:5061;transport=tls"
    }
  },
  "errors": null
}
Docs for agents: llms.txt