Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Format phone number.

 

Endpoint ID:6010
Method:GET
URL:

 /services/phonenumber/format/{phoneNumber}/{phoneNumberFormat=E164}?countryCode={countryCode}&countryCodeFormat={countryCodeFormat}

 phoneNumber

Phone number to be formatted.

Valid examples

  • +4529254029
  • 29254029 (valid only if country code is specified)
  phoneNumberFormat

 Desired format, if not specified default is set to E164.

Valid format options are

  • E164 - Default value. ( Its a general format for international telephone numbers prefixed with the character + (plus sign) and country dial code. Example :  +4529254029 )
  • National - ( Its a general format numbers without character + (plus sign) and country dial code. Example: 29254029 )

  • International - ( Its is like E164 format with spaces between numbers. Example: +45 29 25 40 29 )
  • RFC3966 - (The "tel" URI describes resources identified by telephone numbers. Example : tel:+45-29-25-40-29)

  • Custom - (Used for legacy phone number beautifier implementation  Example : 4529254029)
 countryCode

Optional value to identify country of phoneNumber.

 countryCodeFormat 

Optional value to identify countryCode format.

Valid values are

  • ISO2 ( ISO 3166-1 alpha-2 – two letter country codes )
  • ISO3 ( ISO 3166-1 alpha-3 – three letter country codes )
  • ISON ( ISO 3166-1 numeric – three digit country codes )
  • Internet ( Top level domain names on web )
  • Custom ( Used for legacy phone number beautifier implementation )
Request body:None

Response body:

JSON data with information about the valid phone number 

 

Example – Parse +4529254029
{
	"phoneNumber":+4529254029
	"countryCode": "DK",
	"countryDialCode": "45",
	"numberType": "FixedLineOrMobile"
}

   

Status codes:200

Phone number is validated successfully.

 400

The following sub codes may be returned:

 

400.1Invalid Phone number.
400.2Phone number must be in international format if country code is not specified.
400.3Invalid Country code format.
 404

No matching country code found for country code format. 

 

 

 

 

 

  • No labels