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
.
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.
Return | Description | Possible values |
---|---|---|
success |
Determines if the query was successful | true false |
code |
Return code | 100 – Query successful202 – Invalid number500 – Not enough credits600 – 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"
}
]