Skip to main content
POST
Check a US phone number against the US DNC list
Submit a US phone number using phone. The operation normalizes accepted numbers to +1 format and returns whether the number is listed on the US Do Not Call (DNC) list. For UK numbers, use the UK DNC Checker.
A successful check costs 1 credit whether listed is true or false. The limit is 5 requests per second per workspace. Validation and lookup failures are not charged.
POST /v1/dnc-check remains supported for existing integrations; it accepts the same request and returns the same response, pricing, and limits as POST /v1/us-dnc-check. Non-US numbers return 422 with code: "unsupported_phone_region" without starting a check. Malformed numbers return 422 with code: "invalid_input". Correct the input before retrying either response. phone_number and mobile_phone are accepted aliases. phone takes precedence when non-null, followed by phone_number, then mobile_phone. Use one field to avoid ambiguity.

Read a successful result

After 429, retry in a later second with bounded exponential backoff. For temporary 502 or 503 responses, retry with increasing delays and a fixed retry limit; contact support if errors persist. The maximum JSON body size is 256 KiB.

Next step

Review Authentication before updating an existing integration.

Authorizations

Authorization
string
header
required

Use an Airscale workspace API key. Never expose the key in client-side code.

Body

application/json
phone
string
required

Recommended phone field. A US phone number, normalized to +1 format.

Minimum string length: 1
phone_number
string

Alias used only if phone is null or absent.

mobile_phone
string

Alias used only if phone and phone_number are null or absent.

Response

The result of a completed DNC check.

status
string
required
Allowed value: "success"
phone
string
required
listed
boolean
required
result
enum<string>
required
Available options:
Listed on DNC,
Not listed on DNC
credits_used
number
required
credits_remaining
number | null
required