« Back to the developer index

The Caller ID Validate API

The CID Validate API provides a simple way to determine if a number is valid within the Australian numbering scheme. This is also our first API to not require an API key to use; there is however rate limiting in place to stop abuse.

The API returns the service type, holder and exchange information where available. The service also makes an attempt to identify if a number is valid for a consumer, though this check should not be treated as a business/residential check.

The request to our API is a standard HTTP GET request as follows:

Parameters

format (required)

valid options are text, json, xml, phps.

key (optional)

32 characters long, provided when you join the developer program

q (required)

valid South Africa phone number

Example Query Results

Text

JSON

XML

PHPS