Phone number formatting

Learn about the utility tools provided by Sinch that help with correct phone number formatting.

The phone number should be specified according to the E.164 number formatting ( recommendation and should be prefixed with a +. For example, to verify the US phone number 415 555 0101, the phone number should be specified as +14155550101. The + is the required prefix and the US country code 1 prepended to the local subscriber number.

The Sinch SDK provides APIs for parsing and formatting phone numbers. The primary class for this functionality is SinchPhoneNumberUtils. A key thing when parsing user input as a phone number is the concept of default region. If a user enters their number in a local format, the parsing must know which region / country to assume. Example:

// Get user's current country Iso by carrier info
let defaultCountryIso = SinchPhoneNumberUtils.defaultCountryIso
WARNING: Important

When passing a number as a String to create a Verification object, the string should contain a number in E.164 format.

A number that has been typed can be formatted as E.164 by using SinchPhoneNumberUtils.formatNumberToE164 method or e164Number property of PhoneNumberUITextField.

Was this page helpful?