Get a phone number
const url = 'https://api.caller9.app/v1/numbers/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.caller9.app/v1/numbers/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'Authorization: Bearer <token>'Returns a number together with its current routing. A number is routed to exactly one of: a studio (assignments), a direct forward (forward), or a SIP trunk (trunk) — or none of them.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Phone number ID (UUID), not the phone number itself.
Responses
Section titled “Responses”The number and its routing.
object
A phone number (DID) owned by an organization.
object
Number ID.
The phone number, E.164 (e.g. +15551234567).
Display name.
1 if outbound calls from this number offer HD-voice codecs. Managed by Caller 9 support.
Always null for numbers returned by the API.
Studio assignment (at most one entry in practice).
object
Direct forward destination, or null if the number is not forwarded.
A direct, unconditional forward destination for a number. Exactly one of sip_address / phone_number is set, matching dest_type.
object
Present on the PUT response; omitted when embedded in GET /v1/numbers/{number}.
Normalized SIP URI (sip:user@host).
E.164 phone number.
Example
{ "number": { "hd_voice_outbound": 0 }, "assignments": [ { "role": "primary" } ], "forward": { "dest_type": "sip" }}Missing, invalid, expired or revoked API key.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Not found, or belongs to another organization.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Too many requests for this API key. Retry after Retry-After seconds.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Headers
Section titled “Headers”Seconds until the rate-limit window resets.