Last Updated: Friday, January 26, 2018
E.164 Phone Number Support
E.164 is the official format for all international phone numbers that includes a plus sign (+) followed by a country code and phone number.
- U.S.: +12025550132
- U.K.: +441632960964
- Brazil: +5511991234567
Version 2 of the following Platform APIs now accept and return phone numbers in the standard E.164 format.:
The following is a partial API example showing how the E.164 format is displayed.
Platform APIs Accept MDNs in E.164 Format
Version 2 of the APIs only accepts MDNs in E.164 format if they include a country code.
MDNs without a country code are considered invalid.
Subscription Entity Example
Platform APIs Return MDNs in E.164 Format
MDNs are returned in E.164 format. Phone numbers that were stored using Version 1 of the APIs are assumed to be US/Canada (+1) phone numbers.
Person Entity Example
Persons with International MDNs not Returned in Version 1
If you use Version 1 of the Platform APIs, a CountryNotSupported error will be returned if you query for a Person with an MDN that does not follow the E.164 format, for example, if it is a U.S. number and you use 2135551234 instead of +12135551234.