1. Home
  2. Gateway
  3. HTTP Api
  4. CNAM Lookup

CNAM Lookup

Via CNAM Lookup you can query the Caller ID name for any phone number worldwide. Please note that not every phone number has an entry. Since the data is collected from various sources you could get geographical locations, company names/names or the network operator in response.

Please address your request to the URL
https://gateway.sms77.io/api/lookup

Required Parameters

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

Parameter Description Examples
type CNAM query cnam
number Demanding mobile phone number 491761234567890
0176-1234567890
00491761234567890

Response

The data is returned as JSON formatted. If the number is invalid, you will otherwise receive the error code 202, if there is another error, you will receive the code 600.

Return Description Possible values
success Query successful true
false
code Return code 100 – Query successful
202 – invalid number
500 – Not enough credits
600 – Unknown error
number E.164 formatted phone number +4915126716517
name Caller ID Name. Maximum 15 characters ...

Example

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

Response:

{
    "success": "true",
    "Code": "100",
    "number": "+4915126716517",
    "name": "TELEKOM SMS"
}
Was this article helpful to you? Yes 2 No 2
Menu