Twilio API (unofficial showcase)
GET/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{Sid}.json

Retrieve an incoming phone number

Retrieves an incoming phone number belonging to an account. Use the account SID and the phone number's SID to identify the resource.

2 parameters
AccountSidstringrequired
The SID of the account that created the incoming phone number. Must use the `AC` prefix followed by 32 hexadecimal characters.
Sidstringrequired
The unique SID of the incoming phone number to retrieve. Must use the `PN` prefix followed by 32 hexadecimal characters.

1 status code
200Returns the incoming phone number resource, including its account and address SIDs, phone number, capabilities, configuration, and creation and update timestamps.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this IncomingPhoneNumber resource.
address_sidstringoptional
The SID of the Address resource associated with the phone number.
address_requirementsstringoptional
Whether the phone number requires an [Address](https://www.twilio.com/docs/usage/api/address) registered with Twilio. Can be: `none`, `any`, `local`, or `foreign`.
Allowed:noneanylocalforeign
api_versionstringoptional
The API version used to start a new TwiML session.
betabooleanoptional
Whether the phone number is new to the Twilio platform. Can be: `true` or `false`.
capabilitiesobjectoptional
The set of Boolean properties that indicate whether a phone number can receive calls or messages. Capabilities are `Voice`, `SMS`, and `MMS` and each capability can be: `true` or `false`.
date_createdstringoptional
The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
date_updatedstringoptional
The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
friendly_namestringoptional
The string that you assigned to describe the resource.
identity_sidstringoptional
The SID of the Identity resource that we associate with the phone number. Some regions require an Identity to meet local regulations.
phone_numberstringoptional
The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number.
originstringoptional
The phone number's origin. `twilio` identifies Twilio-owned phone numbers and `hosted` identifies hosted phone numbers.
sidstringoptional
The unique string that that we created to identify this IncomingPhoneNumber resource.
sms_application_sidstringoptional
The SID of the application that handles SMS messages sent to the phone number. If an `sms_application_sid` is present, we ignore all `sms_*_url` values and use those of the application.
sms_fallback_methodstringoptional
The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
sms_fallback_urlstringoptional
The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`.
sms_methodstringoptional
The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
sms_urlstringoptional
The URL we call when the phone number receives an incoming SMS message.
status_callbackstringoptional
The URL we call using the `status_callback_method` to send status information to your application.
status_callback_methodstringoptional
The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`.
Allowed:GETPOST
trunk_sidstringoptional
The SID of the Trunk that handles calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa.
uristringoptional
The URI of the resource, relative to `https://api.twilio.com`.
voice_receive_modestringoptional
Allowed:voicefax
voice_application_sidstringoptional
The SID of the application that handles calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa.
voice_caller_id_lookupbooleanoptional
Whether we look up the caller's caller-ID name from the CNAM database ($0.01 per look up). Can be: `true` or `false`.
voice_fallback_methodstringoptional
The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
voice_fallback_urlstringoptional
The URL that we call when an error occurs retrieving or executing the TwiML requested by `url`.
voice_methodstringoptional
The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
voice_urlstringoptional
The URL we call when the phone number receives a call. The `voice_url` will not be used if a `voice_application_sid` or a `trunk_sid` is set.
emergency_statusstringoptional
The parameter displays if emergency calling is enabled for this number. Active numbers may place emergency calls by dialing valid emergency numbers for the country.
Allowed:ActiveInactive
emergency_address_sidstringoptional
The SID of the emergency address configuration that we use for emergency calling from this phone number.
emergency_address_statusstringoptional
The status of address registration with emergency services. A registered emergency address will be used during handling of emergency calls from this number.
Allowed:registeredunregisteredpending-registrationregistration-failurepending-unregistrationunregistration-failure
bundle_sidstringoptional
The SID of the Bundle resource that you associate with the phone number. Some regions require a Bundle to meet local Regulations.
statusstringoptional
typestringoptional
The phone number type.

Error handling

The AccountSid path parameter must be a 34-character account SID beginning with AC, and the Sid path parameter must be a 34-character incoming phone number SID beginning with PN. Each SID must contain 32 hexadecimal characters after its prefix.