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 (http://en.wikipedia.org/wiki/E.164) 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:

Copy
Copied
// 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?