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
}