latestOpenAPI 3.1.02026-08-233001841.3 MB

0dcf3303e9d7

phone_numbers

Retrieve a single phone number

get/phone_number/{id}/

Path parameters

idstring required

Query parameters

_fieldsstring

Comma-separated list of fields to include in the response.

Response

Successful response

address_idstring nullable required
bundle_idstring nullable required
carrier'twilio' | 'plivo' required
carrier_type'local' | 'national' | 'mobile' | 'tollfree' | 'shortcode' required
countrystring nullable required
date_createdstring date-time required
date_updatedstring date-time required
forward_tostring nullable
forward_to_enabledboolean
forward_to_formattedstring nullable
idstring required
inbound_ring_durationinteger nullable

Number of seconds we ring this number on inbound calls before moving on (e.g. to voicemail). null means the default of 30 seconds is used.

is_group_numberboolean required

Deprecated. The distinction between personal and group numbers is being removed, and is_group_number will be removed in a future update.

is_premiumboolean required
is_verifiedboolean required
labelstring required
last_billed_pricenumber nullable required
mms_enabledboolean required
next_billing_onstring date-time nullable required
numberstring required
number_formattedstring required
organization_idstring required
participantsstring[]
phone_numbersstring[]
phone_numbers_formattedstring[]
press_1_to_acceptboolean
sms_enabledboolean required
supports_mms_to_countriesstring[] required
supports_sms_to_countriesstring[] required
type'internal' | 'external' | 'virtual' required
user_idstring nullable required

Deprecated. Set to the sole member's user ID for single-member numbers, otherwise null. user_id will be removed in a future update.

voicemail_greeting_urlstring nullable
was_portedboolean