Scrub a list of phone numbers against DNC sources (bulk)
Batch counterpart of GET /compliance/dnc/check: pre-flight a whole contact list or campaign audience against every Do-Not-Call source the send path enforces — contacts you have marked Do-Not-Call, your DNC and suppression lists, cross-channel STOP replies, platform-wide DNC, recorded consent opt-outs, the US FTC/state/TCR feed, and — scoped by the optional country filter — the UK TPS/CTPS, Australia DNC Register, and India NDNC national registers — in one request. Returns a per-number verdict plus a summary (on_dnc / clear counts). Read-only — it performs no send; use it before an outbound SMS / Voice campaign to remove numbers the send path’s compliance gate would block. Duplicate numbers are de-duplicated before scrubbing. Send at most 500 numbers per request and page larger lists. Gated identically to dnc/check: once a federal/state/TCR feed snapshot is synced (federal_feeds_synced: true) it serves directly, otherwise it requires your organization’s Do-Not-Call opt-in to be enabled (HTTP 403 DNC_SYNC_NOT_ENABLED until it is).
Authorizations
Dashboard JWT token from Clerk
Headers
Stripe-style idempotency token. Pass a stable, client-generated value (1-255 chars) to dedupe retries on transient timeouts. The same key+credential+path replays the original response for 24h on 2xx (5min on 4xx, 30s on 5xx). Returns 409 if a concurrent request with the same key is already in flight; replayed responses include the Idempotency-Replay: true response header.
1 - 255Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Body
E.164 numbers to scrub (e.g. ["+14155551234", "+442071838750"]). Duplicates are removed before scrubbing.
1 - 500 elementsOptional ISO 3166-1 alpha-2 country code (e.g. GB, AU, IN) applied to every number as a per-jurisdiction filter on the international national-registry scrub.
Response
Successful response.