Overview

This API enables seamless integration of Do-Not-Call (DNC) lookup services and account-related data into your applications. It is designed for fast, reliable phone number validation against DNC records.

All responses are returned in JSON format unless otherwise specified.

Authentication

All requests must include your Subscription ID as your API Key in the request headers.

Header:

X-API-KEY: Subscription ID

Endpoint

GET https://donotcalldnc.com/api/check/?phone={PHONE_NUMBER}

Request Parameters

phone (string): Phone number to check (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)

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

Notes

• Uses HTTP headers instead of query strings
• Phone numbers are normalized automatically
• Invalid requests are rejected immediately
• Optimized for fast real-time lookup