API Reference › Phone Verification & DNC
Get One DNC Job
GET /v2/api/dnc/queue/{id}
Cost: Free.
Rate limit: No limit.
Mode: Sync
Retrieve the status and results of a DNC scrub job. When complete, two download URLs are provided: download_url (all phones including ones with DNC flags) and clean_download_url (only phones with no DNC flags).
This endpoint is version-independent: /v1/api/dnc/queue/:id and /v2/api/dnc/queue/:id are the same endpoint and return the same JSON for any queue you own. The CSV columns depend on which version created the scrub:
- v1: phone, label, national_dnc, state_dnc, dma, litigator, phone_type, is_clean
- v2: phone, label, national_dnc, state_dnc, state_dnc_list, litigator, is_clean
Note: While the queue is still pending, the fields phones_checked, phones_clean, and credits_deducted are omitted from the response. They appear once the scrub completes.
Related endpoints: DNC Scrub (v1) · DNC Scrub from a Trace (v1) · DNC Lookup (v1)
Fields
id (required): DNC Queue ID
Responses
200: Success.
403: DNC queue belongs to another account
404: No DNC queue with that ID