Check phone number against DNC registry

curl --request GET \
  --url https://api.meerapi.com/check_phone_number \
  --header 'Authorization: Bearer <token>'

{
  "do_not_call": true,
  "timestamp": "2025-12-16T14:32:10.123456789Z",
  "dnc_list_source": "https://us.gov"
}

Check phone number against DNC registry

Validates a phone number and checks if it appears in any Do Not Call registries. Returns DNC status and source information if found.

Note: Phone numbers should follow the E.164 format for best results - i.e. +<country-code> <phone-number>.

For countries like the USA or Canada there isn’t much difference between dialing locally or internationally, i.e. +1 (678) 123-4567 versus (678) 123-4567. For countries like the United Kingdom however, there’s a bigger difference between local and international format, i.e. 01000822380 would become +44 1000822380 - notice we drop the leading 0. We will still try our best to match your number to our database, but know that this has limitations.

Rate Limiting: This endpoint counts against your monthly request limit.

Resellers: If you are a reseller, you must provide the X-Forwarded-Host header containing the domain name of the customer on whose behalf this request is being made.

GET

/

check_phone_number

Check phone number against DNC registry

curl --request GET \
  --url https://api.meerapi.com/check_phone_number \
  --header 'Authorization: Bearer <token>'

{
  "do_not_call": true,
  "timestamp": "2025-12-16T14:32:10.123456789Z",
  "dnc_list_source": "https://us.gov"
}

Authorizations

Authorization

string

header

required

API key authentication. Provide your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

You can also omit the "Bearer" prefix:

Authorization: YOUR_API_KEY

Headers

X-Forwarded-Host

string

The domain name of the end customer consuming the API. Required for resellers — if you are integrating the Meer API on behalf of customers, you must set this header to the customer's domain (e.g., customer.example.com) on every request. This is used for per-customer attribution, rate limiting, and compliance tracking. Direct (non-reseller) API consumers may omit this header.

Query Parameters

phone_number

string

required

Phone number to check (e.164 format recommended, e.g., +1234567890)

Response

Successfully checked phone number

do_not_call

boolean

required

Whether the phone number is on a Do Not Call list

Example:

true

timestamp

string<date-time>

required

RFC3339 timestamp of when the check was performed

Example:

"2025-12-16T14:32:10.123456789Z"

dnc_list_source

string | null

The source of the DNC listing (null if not on any list)

Example:

"National Do Not Call Registry"