List Numbers
curl --request GET \
--url https://api.bland.ai/v1/inbound \
--header 'authorization: <authorization>'{
"inbound_numbers": [
{
"created_at": "2023-11-27T17:21:38.33359+00:00",
"phone_number": "+18005551234",
"prompt": "When you receive a call, recite a random poem from 'Sunset Boulevard' and then ask, 'How may I assist you in your poetic journey today?'",
"webhook": "https://api.example.com/poetry-line",
"voice_id": 2,
"dynamic_data": [/* Use [Dynamic Data](/api-reference/endpoint/dynamic_validate) to make API requests mid-call */],
"interruption_threshold": null,
"first_sentence": null,
"reduce_latency": true,
"transfer_phone_number": null,
"voice_settings": null,
"record": false,
"max_duration": 30
},
{
"created_at": "2023-11-25T21:42:22.325993+00:00",
"phone_number": "+18005559876",
"prompt": "Answer with 'You've reached the Secret Society of Enigmatic Enthusiasts. Please state the password or leave a message after the beep.'",
"webhook": "https://mysteryclub.example.com/inbound-call-hook",
"voice_id": 1,
"dynamic_data": null,
"interruption_threshold": null,
"first_sentence": null,
"reduce_latency": true,
"transfer_phone_number": null,
"voice_settings": null,
"record": false,
"max_duration": 30
},
//...
]
}
Numbers
List Numbers
Retrieves a list of all inbound phone numbers configured for your account, along with their associated settings.
GET
/
v1
/
inbound
List Numbers
curl --request GET \
--url https://api.bland.ai/v1/inbound \
--header 'authorization: <authorization>'{
"inbound_numbers": [
{
"created_at": "2023-11-27T17:21:38.33359+00:00",
"phone_number": "+18005551234",
"prompt": "When you receive a call, recite a random poem from 'Sunset Boulevard' and then ask, 'How may I assist you in your poetic journey today?'",
"webhook": "https://api.example.com/poetry-line",
"voice_id": 2,
"dynamic_data": [/* Use [Dynamic Data](/api-reference/endpoint/dynamic_validate) to make API requests mid-call */],
"interruption_threshold": null,
"first_sentence": null,
"reduce_latency": true,
"transfer_phone_number": null,
"voice_settings": null,
"record": false,
"max_duration": 30
},
{
"created_at": "2023-11-25T21:42:22.325993+00:00",
"phone_number": "+18005559876",
"prompt": "Answer with 'You've reached the Secret Society of Enigmatic Enthusiasts. Please state the password or leave a message after the beep.'",
"webhook": "https://mysteryclub.example.com/inbound-call-hook",
"voice_id": 1,
"dynamic_data": null,
"interruption_threshold": null,
"first_sentence": null,
"reduce_latency": true,
"transfer_phone_number": null,
"voice_settings": null,
"record": false,
"max_duration": 30
},
//...
]
}
Headers
Your API key for authentication.
Use your own Twilio account and only return inbound numbers associated with that account sid (optional).Learn more about BYOT here.
Response
An array of objects, each representing an inbound phone number and its configuration.
{
"inbound_numbers": [
{
"created_at": "2023-11-27T17:21:38.33359+00:00",
"phone_number": "+18005551234",
"prompt": "When you receive a call, recite a random poem from 'Sunset Boulevard' and then ask, 'How may I assist you in your poetic journey today?'",
"webhook": "https://api.example.com/poetry-line",
"voice_id": 2,
"dynamic_data": [/* Use [Dynamic Data](/api-reference/endpoint/dynamic_validate) to make API requests mid-call */],
"interruption_threshold": null,
"first_sentence": null,
"reduce_latency": true,
"transfer_phone_number": null,
"voice_settings": null,
"record": false,
"max_duration": 30
},
{
"created_at": "2023-11-25T21:42:22.325993+00:00",
"phone_number": "+18005559876",
"prompt": "Answer with 'You've reached the Secret Society of Enigmatic Enthusiasts. Please state the password or leave a message after the beep.'",
"webhook": "https://mysteryclub.example.com/inbound-call-hook",
"voice_id": 1,
"dynamic_data": null,
"interruption_threshold": null,
"first_sentence": null,
"reduce_latency": true,
"transfer_phone_number": null,
"voice_settings": null,
"record": false,
"max_duration": 30
},
//...
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I