--- title: "Retrieve an incoming phone number" method: GET path: "/Accounts/{AccountSid}/IncomingPhoneNumbers/{Sid}" tags: ["Incoming Phone Numbers"] --- # Retrieve an incoming phone number `GET /Accounts/{AccountSid}/IncomingPhoneNumbers/{Sid}` Retrieve an incoming phone number. #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes). ## Path parameters - `AccountSid` string, uuid, required - `Sid` string, uuid, required ## Response `200` The request has succeeded. - IncomingPhoneNumberResponse — Response containing a single incoming phone number. - `account_id` string, uuid, required — The unique identifier for the account that is associated with this phone number. - `account_sid` string, uuid, required — The unique identifier for the account that is associated with this phone number. - `address_requirements` 'none' | 'any' | 'local' | 'foreign', required — Address requirements. - `address_sid` string, nullable, required — The unique identifier for the address associated with this phone number. Always null. - `api_version` string, required — The version of the SignalWire API. - `beta` boolean, required — New numbers on SignalWire are marked as beta. Always false. - `capabilities` IncomingPhoneNumberCapabilities, required — Phone number capabilities. - `voice` boolean, required — Whether or not voice is enabled. - `sms` boolean, required — Whether or not SMS is enabled. - `mms` boolean, required — Whether or not MMS is enabled. - `fax` boolean, required — Whether or not fax is enabled. - `country_code` string, required — The ISO 3166-1 alpha-2 country code for this phone number. - `date_created` string, required — The date, in RFC 2822 format, this phone number was created. - `date_updated` string, required — The date, in RFC 2822 format, this phone number was updated. - `emergency_address_sid` string, nullable, required — The unique identifier of the address associated with E911 for this phone number, or null if not set. - `emergency_status` string, required — Whether the phone route has an active E911 address associated. 'Active' or 'Inactive'. - `friendly_name` string, required — A formatted version of the number. - `identity_sid` string, nullable, required — The unique identifier for the identity associated with this phone number. Always null. - `origin` 'signalwire' | 'hosted', required — Phone number origin. - `phone_number` string, required — The incoming number in E.164 format. - `sid` string, required — The unique identifier for this phone number. - `sms_application_sid` string, nullable, required — The unique identifier for the application associated with SMS handling on this phone number, or null if not set. - `sms_fallback_method` string, required — Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. - `sms_fallback_url` string, nullable, required — The URL to request if errors occur when fetching SmsUrl, or null if not set. - `sms_method` string, required — Whether the request to SmsUrl is a `GET` or a `POST`. - `sms_url` string, nullable, required — The URL to request when an incoming SMS is received, or null if not set. - `status_callback` string, nullable, required — The URL to request to pass status updates to, or null if not set. - `status_callback_method` string, required — Whether the request to StatusCallback is a `GET` or a `POST`. - `trunk_sid` string, nullable, required — The unique identifier for the Trunk associated with this phone number. Always null. - `uri` string, required — The URI for this number. - `verification_status` string — The verification status for toll-free numbers. Only present for toll-free numbers. - `voice_application_sid` string, nullable, required — The unique identifier for the application associated with call handling on this phone number, or null if not set. - `voice_caller_id_lookup` boolean, nullable, required — Whether or not to look up a caller's name in the database. Always null. - `voice_fallback_method` string, required — Whether the request to VoiceFallbackUrl is a `GET` or a `POST`. - `voice_fallback_url` string, nullable, required — The URL to request if errors occur when fetching `Url`, or null if not set. - `voice_method` string, required — Whether the request to Url is a `GET` or a `POST`. - `voice_url` string, nullable, required — The URL to request when an incoming call is received, or null if not set. ## Other responses - `400` — The request was invalid or cannot be processed. Check the error details for more information. - `401` — Authentication failed. Please verify your credentials and try again. - `404` — The requested resource was not found. Please verify the resource identifier. ## Changes - **2026-01-19** `d5fbaaddfa3e` — 13 breaking, 4 warning, 39 info - the response property `address_sid` became nullable for the status `200` - the response property `emergency_address_sid` became nullable for the status `200` - the response property `identity_sid` became nullable for the status `200` - the response property `sms_application_sid` became nullable for the status `200` - …52 more - **2026-01-15** `a10b019314cd` — 2 warning - removed the optional property `account_id` from the response with the `200` status - removed the optional property `country_code` from the response with the `200` status - **2026-01-15** `518ffc8751b7` — 2 info - added the optional property `account_id` to the response with the `200` status - added the optional property `country_code` to the response with the `200` status - **2026-01-15** `686ef84c2abc` — 5 breaking - the response property `emergency_address_sid` became nullable for the status `200` - the response property `sms_application_sid` became nullable for the status `200` - the response property `sms_fallback_url` became nullable for the status `200` - the response property `sms_url` became nullable for the status `200` - …1 more - …earlier changes not shown [Full history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/IncomingPhoneNumbers/:Sid/get.md) --- [API](https://skmtc.dev/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.dev/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/revisions/8891278c1908/schema)