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

The following parameters are required in addition to authentication:

Parameter Description Possible values
type The number format query type for the request. format
number The number(s) to be queried.
Multiple entries can be separated by comma.
The format is almost arbitrary – our gateway automatically formats the number correctly.
491632429751,491771783130
00491632429751
0163-2429751

Response explanation

The information is returned as JSON formatted.

Parameter Description Possible values / Example
carrier Network operator to whom the call number was originally assigned. Eplus
country_code Country code of the queried number – international without leading “00”. 49
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
international International E.164 format of the queried phone number. +491632429751
international_formatted The international number. +49 163 2429751
national National format of the queried phone number. 0163 2429751
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
success Query successful true
false

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:

{
  "carrier": "Eplus",
  "country_code": "49",
  "country_iso": "DE",
  "country_name": "Germany",
  "international": "+491632429751",
  "international_formatted": "+49 163 2429751",
  "national": "0163 2429751",
  "network_type": "mobile",
  "success": true
}