v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14109583546.7 KB

Returns information about a destination phone number, including whether the number type and whether it is valid, the carrier, and more.

post/#X-Amz-Target=PinpointSMSVoiceV2.CarrierLookup

Headers

X-Amz-Target'PinpointSMSVoiceV2.CarrierLookup' required

Request body

PhoneNumberstring required

The phone number that you want to retrieve information about. You can provide the phone number in various formats including special characters such as parentheses, brackets, spaces, hyphens, periods, and commas. The service automatically converts the input to E164 format for processing.

Response

Success

E164PhoneNumberstring required

The phone number in E164 format, sanitized from the original input by removing any formatting characters.

DialingCountryCodestring

The country or region numeric dialing code for the phone number.

IsoCountryCodestring

The two-character country or region code, in ISO 3166-1 alpha-2 format, for the phone number.

Countrystring

The name of the country or region for the phone number.

MCCstring

The phone number's mobile country code, for mobile phone number types

MNCstring

The phone number's mobile network code, for mobile phone number types.

Carrierstring

The carrier or service provider that the phone number is currently registered with. In some countries and regions, this value may be the carrier or service provider that the phone number was originally registered with.

PhoneNumberType'MOBILE' | 'LANDLINE' | 'OTHER' | 'INVALID' required

Describes the type of phone number. Valid values are: MOBILE, LANDLINE, OTHER, and INVALID. Avoid sending SMS or voice messages to INVALID phone numbers, as these numbers are unlikely to belong to actual recipients.