numbers
Get a specific phone number's details
Retrieves detailed information about a specific phone number, including its assignment (user, IVR, conference), country, capabilities, and configuration. The number is identified by its phone number in E.164 format without the + prefix (e.g., 33140000000).
Permission: Numbers Read required.
Monitoring impact:
- OFF: Returns the number only if it is assigned to you. Requesting a number belonging to another user returns 404.
- ON: Returns details for any number in the team.
get/numbers/{number}
Path parameters
numberinteger required
The phone number in E.164 format without the + prefix (e.g., 33140000000 for a French number).
Response
Successful operation — returns the number details.
Example response
{
"number": 33184800000,
"label": "myfavoritenumber",
"type": "PHONE",
"user_id": 60907,
"ivr_id": 60908,
"conference_id": 60908,
"format": {
"raw": 184800000,
"country_code": "33",
"country": "FR",
"e164": "+33184800000",
"international": "+33 1 84 80 00 00",
"international_alt": "33184800000",
"national": "01 84 80 00 00",
"national_alt": "0184800000",
"rfc3966": "tel:+33-1-84-80-00-00"
}
}