For Developers

DND Filter API — Real-Time DND Status Checking

A simple REST API for checking the DND status of Indian mobile numbers programmatically — plug it into your CRM, lead form, or campaign platform so lists are filtered before a promotional message ever gets queued.

TODO [CONFIRM before publishing]: the base URL, auth header name, exact endpoint paths, and sample responses below are illustrative placeholders following our existing API conventions. Replace them with the real base URL, authentication scheme, and verified request/response payloads from the DND Filter API team before this page goes live — a developer will copy-paste these examples.

The DND Filter API lets your application check whether a mobile number is DND-registered without a human using the web-based checker. It's the same underlying data — the official TRAI/NCPR registry — exposed as a REST endpoint so you can filter numbers automatically as part of your own signup flow, CRM sync, or campaign pipeline.

Getting Started & Authentication

Every request is authenticated with an API key issued from your MetaReach developer dashboard. Include it as a bearer token in the Authorization header of every request.

# TODO: confirm real base URL & header name Authorization: Bearer YOUR_API_KEY Content-Type: application/json

Don't have a key yet? Contact our team to get access, or reach out on WhatsApp for fast setup.

Endpoints

POSTSingle Number Check

Check DND status for one mobile number and get an instant response.

# TODO: confirm real endpoint path curl -X POST https://api.metareachmarketing.com/v1/dnd/check \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"mobile": "91XXXXXXXXXX"}'

Example response (illustrative — TODO confirm real schema):

{ "mobile": "91XXXXXXXXXX", "dnd_status": "DND", "category": "full_block", "checked_at": "2026-08-16T10:00:00Z" }

POSTBulk Number Check

Check DND status for an array of numbers in a single request instead of looping single calls.

# TODO: confirm real endpoint path & batch size limit curl -X POST https://api.metareachmarketing.com/v1/dnd/bulk-check \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"numbers": ["91XXXXXXXXXX", "91YYYYYYYYYY"]}'
FieldTypeDescription
mobile / numbersstring / array10-digit Indian mobile number(s), with or without country code — confirm accepted format.
dnd_statusstringDND or NON_DND for each number checked.
categorystringFull block vs. partial/category-wise block, where applicable.

Rate Limits & Pricing

API access is billed per call, with volume-based rates for higher usage — the same underlying pricing model as the DND Number Checker. Rate limits apply per API key based on your plan.

PlanRate LimitPrice
StandardIllustrative: 60 requests/min₹2/check
High-VolumeIllustrative: customCustom — contact sales

Frequently Asked Questions

Sign up for a developer account and generate an API key from your dashboard. Contact our team if you need help getting started or want a key issued directly.
Yes. A single-check endpoint accepts one mobile number per request and returns its DND status instantly. A bulk-check endpoint accepts an array of numbers in one request for checking many numbers programmatically without looping single calls.
The API checks numbers against the official TRAI/NCPR DND registry, the same authoritative source used for the web-based DND Number Checker and DND Scrubbing Service.
Yes, API usage is subject to rate limits tied to your plan. Contact our team to confirm current limits and discuss higher-throughput plans for high-volume integrations.
Pricing is based on the number of API calls made per billing cycle, with volume-based rates for higher usage. Contact our team for a quote matched to your expected call volume.
The API is a standard REST/JSON interface, callable from any language that can make HTTP requests. Documentation includes examples in cURL, PHP, and Node.js, matching the same integration pattern used across MetaReach's other messaging APIs.

Related Services

Prefer a web interface over an API? Use the DND Number Checker for manual single or bulk lookups. Managing a large recurring database? See the DND Scrubbing Service. Looking for our general messaging API? Check the main SMS & WhatsApp API page.


Our Happy Clients

Trusted by 500+ Businesses Across India

From startups to enterprises — brands that grow with MetaReach


WhatsApp Facebook Instagram YouTube LinkedIn X / Twitter

☎ Instant Call Back FREE
or request a call back

We'll call you back within 5 minutes