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 lookup type cnam
number Mobile phone number(s) – specify multiple entries separated by comma 491761234567890
0176-1234567890
00491761234567890
491761234567890,456789012345

Response

The data is returned as JSON formatted. Returns a simple object for one number and an array of objects for multiple entries.

Response explanation
Return Description Possible values
success Determines if the query was 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 ...

Examples

Looking up a single number

Querying for a single phone number returns a plain JSON object.

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

Response:

{
    "code": "100",
    "name": "GERMANY",
    "number": "+4915126716517",
    "success": "true"
}

Looking up multiple numbers

Querying for multiple phone numbers returns a JSON array of objects.

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

Response:

[
    {
        "code": "100",
        "name": "GERMANY",
        "number": "+4915126716517",
        "success": "true"
    },
    {
        "code": "100",
        "name": "POLAND",
        "number": "+48732484001",
        "success": "true"
    }
]