Overview

The Do-Not-Call-DNC API allows you to check whether a phone number exists in the DNC database in real time. It enables seamless integration of DNC scrubbing services into your applications and systems.

Designed for speed and reliability, this API provides fast phone number validation against DNC records to help maintain compliance and streamline your calling workflows.

Access to Do-Not-Call-DNC API is available exclusively to users with an active Unlimited-Scrub plan.

All responses are returned in JSON format unless otherwise specified.

Authentication

Authentication is performed using an API Key. Your API KEY is available in your subscription dashboard. This key can be included either in the request header (X-API-KEY) or as a query parameter (apikey).

Header:

X-API-KEY: API KEY

Query String:

?apikey=API_KEY

Endpoint

GET /api/v1/check/?apikey={API_KEY}&phone={PHONE_NUMBER}

Query Parameters

apikey (string): Required unless provided in X-API-KEY header field.
phone (string): Required Phone number to check (10-digits only recommended)

Responses

{
  "success": true,
  "phone": "9254047311",
  "is_dnc": true,
  "status": "DNC",
  "timestamp": "2025-12-31 18:10:58"
}

success: Indicates the request was processed successfully
phone: The normalized phone number that was checked
is_dnc: Boolean indicating if number is on DNC list
status: Human-readable status ("DNC" or "NOT DNC")

{
  "error": "Missing parameters"
}

{
  "error": "Invalid API Key"
}

{
  "error": "Invalid phone number"
}

Example Request

curl -X GET "https://donotcalldnc.com/api/v1/check/?phone=9254047311" ^
-H "X-API-KEY: API KEY"

Error Codes

• 200 - Success
• 400 - Missing or invalid parameters
• 401 - Invalid API key
• 500 - Server error

Notes

• Phone numbers are normalized automatically
• Invalid requests are rejected immediately
• Optimized for fast real-time lookup