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

ParameterDescriptionExamples
typeCNAM querycnam
numberDemanding mobile phone number491761234567890
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.

ReturnDescriptionPossible values
successQuery successfultrue
false
codeReturn code 100 – Query successful
202 – invalid number
500 – Not enough credits
600 – Unknown error
NumberE.164 formatted phone number+4915126716517
nameCaller 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 No
Menu