Skip to main content

Retrieve a number



Retrieve the details of a number. The ID in the path can either be the telephone number (e.g. +12124567890) or object ID.


Path Parameters

    id stringrequired

    Telephone number (ex: +12124567890) or object ID of number to update


200: Number updated


    id stringrequired
    connection_id stringrequired
    number_val_e164 stringrequired
    ignore_tech_prefix booleanrequired

    Default value: true

    DEPRECATED - Use enable_tech_prefix on API requests

    enable_tech_prefix booleanrequired

    Default value: false

    translated_number stringrequired
    forwards_to stringrequired

    the number that this number should be forwarded to; when this is set, forwarding_type must also be set

    forwarding_type stringrequired

    sets when this number should have its calls forwarded; valid values are 'always' and 'on-failure'

    tag_list string[]required
    status integerrequired

    Default value: 1

    Purchase Pending = 1, Purchase Failed = 2, Port Pending = 3, Active = 4, Deleted = 5, Port Failed = 6, Emergency Only = 7, Ported Out = 8, Port Out Pending = 9

    purchase_failure_reason stringrequired

    reason(s) why the last attempt to purchase this number failed

    e911_enabled boolean

    Default value: false

    e911_address_id string
    emergency_status string

    Possible values: [disabled, active, provisioning, deprovisioning]

    Default value: disabled

    address_id string

    use this property to reference an Address record if required for a number record

    usage_payment_method stringrequired

    Possible values: [pay-per-minute, channel]

    Default value: pay-per-minute

    setting for whether a number is billed per minute or uses your concurrent channels

    enable_rtp_auto_adjust booleanrequired

    Default value: true

    When RTP Auto-Adjust is enabled, the destination RTP address port will be automatically changed to match the source of the incoming RTP packets.

    cnam_listing_enabled booleanrequired

    Default value: false

    Enable CNAM listings for this number. Requires cnam_listing_details to also be filled in.

    cnam_listing_details stringrequired

    The CNAM listing details for this number. Must be alphanumeric characters or spaces with a maximum length of 15. Requires cnam_listing_enabled to also be set.

    external_pin string

    External PINs are used to ensure that phone numbers on your account cannot be ported to another carrier without your consent. This has an account level default but may also be specified per phone number. External PINs must be 4 numeric digits ('3456').

    t38_fax_gateway_enabled boolean

    Default value: false

    accept_any_rtp_packets_enabled boolean

    Default value: false

    number_val stringrequired

    DEPRECATION WARNING! Please use number_val_e164 or contact [email protected] if you depend on this key.

    inbound_call_recording_enabled booleanrequired

    Default value: false

    When enabled, any inbound call to this number will be recorded.

    inbound_call_recording_format stringrequired

    Possible values: [wav, mp3]

    Default value: wav

    The audio file format for calls being recorded.

    inbound_call_recording_channels string

    Possible values: [single, dual]

    Default value: single

    When using 'dual' channels, final audio file will be stereo recorded with the first leg on channel A, and the rest on channel B.

    billing_group_id string

    The ID of the Billing Group to which the number is assigned. Defaults to null (for no group assigned).

400: Bad request

401: Unauthorized

404: Resource not found