Sign in
Phone Numbers

Get Phone Number

get/api/v1/phone/numbers/{phone_number_id}

Path parameters

phone_number_idstring uuid required

Response

Successful Response

idstring uuid required
numberstring required
type'local' | 'toll_free' required
status'active' | 'paused' | 'released' required
sms_status'pending' | 'ready' | 'assignment_failed' required
sms_error_codestring nullable
sms_error_detailstring nullable
sms_ready_atstring date-time nullable
incoming_call_action'auto_accept' | 'auto_reject' | 'webhook' | 'hosted_agent' | 'forward' required
client_websocket_urlstring nullable required
incoming_call_webhook_urlstring nullable required
forwarding_target_type'phone' | 'sip'
forwarding_phone_numberstring nullable
forwarding_sip_uristring nullable
filter_mode'whitelist' | 'blacklist' required
statestring nullable

2-letter US state abbreviation for LOCAL numbers (e.g. 'NY'). Null for toll-free numbers.

agent_identity_idstring uuid nullable

ID of the agent identity that owns this phone number, or null if the number is standalone (not tied to any agent).

created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this endpoint across all 1 revision of this API.