Articles in this support section discuss Telebroad's legacy APIs. To learn about the current version of Telebroad APIs, which offer additional authentication options and support for advanced features, please go to https://developers.telebroad.com/.
Function and Response Fields
The GET/cnam request returns the Caller ID Name for any nationwide mobile or landline phone number registered with the CNAM repositories.
While it is designed for ten-digit external numbers you can also use it with internal shortened Telebroad PBX numbers, but do expect the response to be mostly "Out of area". It will work fine for most Telebroad ten-digit caller ID numbers (assigned to internal PBX numbers), usually returning a company address rather than a person's name.
No special access privileges are required for using the request and it can be used by any active registered Telebroad user.
The request returns the following field:
- result - the name associated with the requested phone number as it is registered in the CNAM repositories, or an error message if it cannot be obtained.
Parameters
Parameter | Type | Operation |
number | String | The phone number for which the CNAM information is requested. You need to use an eleven-digit format and always include 1 before a ten-digit number, otherwise it will not be found in the CNAM repositories and the response will be "Out of area". |
Example
To get the list of SMS lines for a user, use this syntax:
HTTPS method: GET
webserv.telebroad.com/api/teleconsole/rest/cnam?number=12033508477
Response:
If the number is found in the CNAM repositories -
{
"error": null,
"result": "Ben Robson"
}
If the number is internal or shorter than the eleven-digit format -
{
"error": null,
"result": "Out of area"
}
If the number is eleven-digit format but is not found in the CNAM repositories -
{
"error": null,
"result": "INVALID NUMBER"
}