Skip to main content
POST
/
v1
/
sip
/
test-call
Send SIP Test Call
curl --request POST \
  --url https://api.bland.ai/v1/sip/test-call \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "phone_number": "<string>"
}
'
{
  "data": {
    "call_id": "tc_abc123",
    "message": "Test call initiated"
  },
  "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.

​
Body

​
phone_number
string
required
The phone number with an outbound SIP configuration to test. Must be in E.164 format.

​
Response

​
call_id
string
A unique call identifier. Use this to poll the test call status.
​
message
string
Confirmation message.
Test calls are rate-limited to 10 per 15 minutes per organization.
Example Request
curl -X POST https://api.bland.ai/v1/sip/test-call \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+14150000000"
  }'

{
  "data": {
    "call_id": "tc_abc123",
    "message": "Test call initiated"
  },
  "errors": null
}
Docs for agents: llms.txt