1. Home
  2. Gateway
  3. HTTP Api
  4. 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:

Parameter Description Possible values
type Query of the number format format
number The 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.

Parameter Description Possible values / Example
success Query successful true
false
international International format of the queried phone number E.164. +491632429751
international_formatted International number. +49 163 2429751
national National format of the queried phone number. 0163 2429751
country_iso Country code of the phone number in the format ISO 3166-1 alpha-2 (two letters). DE
country_name The full name of the country of the queried phone number in English. Germany
country_code Country code of the queried number (international without leading “00”). 49
carrier Network operator to whom the call number was originally assigned Eplus
network_type The type of network for the requested number. fixed_line
fixed_line_or_mobile
mobile
pager
personal_number
premium_rate
shared_cost
toll_free
uan
unknown
voicemail
voip

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",
  "network_type": "mobile"
}
Was this article helpful to you? Yes No
Menu