1. Home
  2. Docs
  3. Gateway
  4. HTTP Api
  5. Number format Lookup

Number format Lookup

Query the national and international format of any mobile phone number. In addition, you will receive the corresponding network operator for the phone number as information (without porting information). Read more about our number validation products.

Please address your request to the following URL:

https://gateway.sms77.io/api/lookup

Required Parameters

In addition to the data for authentication the following parameters are required:

ParameterDescriptionPossible values
typeQuery of the number formatformat
numberThe number to be queried. The format is almost arbitrary – our gateway automatically formats the number correctly.491632429751
00491632429751
0163-2429751

Return

The information is returned as JSON formatted.

ParameterDescriptionPossible values / Example
successQuery successfultrue
false
internationalInternational format of the queried phone number E.164.+491632429751
international_formattedInternational number.+49 163 2429751
nationalNational format of the queried phone number.0163 2429751
country_isoCountry code of the phone number in the format ISO 3166-1 alpha-2 (two letters).DE
country_nameThe full name of the country of the queried phone number in English.Germany
country_codeCountry code of the queried number (international without leading “00”).49
carrierNetwork operator to whom the call number was originally assignedEplus

Example

The format of the number 01632429751 is queried here:

Request:
https://gateway.sms77.io/api/lookup?p=api-key&type=format&number=491632429751

Response:

{
  "success": true,
  "national": "0163 2429751",
  "international": "+491632429751",
  "international_formatted": "+49 163 2429751",
  "country_name": "Germany",
  "country_code": "49",
  "country_iso": "DE",
  "carrier": "Eplus"
}
Was this article helpful to you? Yes No
Menu