Skip to main content
GET
/
v1
/
inbound
/
{phone_number}
Number Details
curl --request GET \
  --url https://api.bland.ai/v1/inbound/{phone_number} \
  --header 'authorization: <authorization>'
{
    "created_at": "2023-11-27T17:21:38.33359+00:00",
    "phone_number": "+18584139939",
    "prompt": "You're Blandie, the helpful AI assistant. The person calling you has inquired...",
    "webhook": "https://webhook.site/0a0a0a0a-0a0a-0a0a-0a0a-0a0a0a0a0a0",
    "voice_id": 2,
    "dynamic_data": null,
    "max_duration": 30
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
phone_number
string
The inbound phone number to update.Formatting notes:
  • The '+' or '%2B' prefix is optional.
  • Will assume a US country code if no country code is provided.
Valid Examples for +13334445555:
  • %2B13334445555
  • 13334445555
  • 3334445555

​
Response

​
created_at
string
The timestamp when the inbound number was configured.
​
phone_number
string
The specific inbound phone number.
​
prompt
string
The prompt your agent is using.
​
webhook
string
The webhook URL, if any, where transcripts are sent after each call to the number completes.
​
voice
integer
The voice your agent is currently using.For more information, see List Voices.
​
background_track
string
The background track your agent is using.Will be null by default, until an option such as office, cafe, restaurant, or none is applied.
​
pathway_id
string
The pathway_id your agent is using.
​
dynamic_data
string
Any dynamic data associated with the inbound number, if applicable.
​
max_duration
integer
The maximum duration of a call to the inbound number, in minutes.
{
    "created_at": "2023-11-27T17:21:38.33359+00:00",
    "phone_number": "+18584139939",
    "prompt": "You're Blandie, the helpful AI assistant. The person calling you has inquired...",
    "webhook": "https://webhook.site/0a0a0a0a-0a0a-0a0a-0a0a-0a0a0a0a0a0",
    "voice_id": 2,
    "dynamic_data": null,
    "max_duration": 30
}