INinkbox
Phone Numbers

Get Phone Number

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

Request

  • Base URL
    https://api.inkbox.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.inkbox.ai/api/v1/phone/numbers/{phone_number_id}
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

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
inbound_filter_mode'whitelist' | 'blacklist'
outbound_filter_mode'whitelist' | 'blacklist'
countrystring

ISO 3166-1 alpha-2 country code (e.g. 'US' or 'GB').

statestring nullable

2-letter US state abbreviation for LOCAL numbers (e.g. 'NY'). Null when unknown or not applicable, including numbers without a US state.

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

  • bccaac47e654Revision changes
    • info

      added the optional property to the response with the status

  • f3dcdb50fbaaRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status