ACME CORPORATION

Indicates whether the result was found in cache (true) or required an SS7 lookup (false)

Error message (only present when status is "error")

The caller name associated with the phone number

Indicates whether the number exists in the database

Local Routing Number for the queried number

Indicates whether the number has been ported (true) or not (false)

Service Provider ID for the carrier serving this number

IP Whitelist Authentication

This API uses IP whitelist authentication. Your server's IP address must be registered with
Ringer before making API calls. Contact support@ringer.tel to register your IP address.


X-Forwarded-For

Ringer API Support

The Ringer Telique API provides access to telecommunications data, 
including caller name (CNAM) data, line type information, and more.

The API also includes services for checking phone numbers against 
Do Not Originate (DNO) and Do Not Call (DNC) databases, as well as 
STIR/SHAKEN call authentication validation.

## Authentication
This API uses IP whitelist authentication. Your server's IP address must be registered with
Ringer before making API calls. Contact support@ringer.tel to register your IP address.


MIT License

Telique API

Retrieve Carrier Identification Code (CIC) information for the specified parameters.

Complex Routing Number (10-digit toll-free number)

Local Access and Transport Area (3-digit)

lata

Retrieve Carrier Identification Code (CIC) information in plain text format.

Automatic Number Identification (10-digit)

Retrieve Carrier Identification Code (CIC) information including Responsible Organization (ROR) data.

Retrieve Carrier Identification Code (CIC) and Responsible Organization (ROR) information in plain text format.

Get CIC information with ROR (plain text)

Alternative method to perform a CNAM lookup using a POST request with form data.


Bad request - Missing or invalid phone number

Retrieve Caller Name (CNAM) information for a phone number.
This endpoint performs a CNAM (Caller Name) lookup for a specified phone number.
It first checks the database cache for existing records, and if not found,
performs an SS7 network lookup to retrieve the caller name information.


phoneNumber

Bad request - Invalid phone number format

Check if a phone number is in the Do Not Call (DNC) database.
Returns a JSON response indicating whether the number exists in the database.


Check if a phone number is in the Do Not Call (DNC) database.
Returns an XML response indicating whether the number exists in the database.


Retrieve a report of DNC updates by area code (NPA).


Check if a phone number is in the Do Not Originate (DNO) database.
Returns a JSON response indicating whether the number exists in the database.


Check if a phone number is in the Do Not Originate (DNO) database.
Returns an XML response indicating whether the number exists in the database.


Returns the Local Routing Number (LRN) and Service Provider ID (SPID) 
for a specified 10-digit North American phone number in plain text format.
This information is used to correctly route calls to numbers that have been ported 
from one carrier to another.

Response format: LRN;SPID (semicolon-separated)
If SPID is not available, only the LRN will be returned.

Note: Content-Type is always text/plain - no JSON or XML support for LRN queries.


10-digit North American telephone number (NANP format)

Retrieve Responsible Organization (ROR) information for the specified CRN.

Retrieve Responsible Organization (ROR) information in plain text format.

Validates STIR/SHAKEN call authentication by checking the provided identity token.


Telique API Documentation