Check DNC Status
Check Do Not Call (DNC) registry status and phone type for an array of phone numbers. This is a lightweight endpoint that returns only DNC status and phone type — no full person enrichment.
Each request accepts up to 1,000 items in the
phones array.Body Parameters
body phonesarrayrequiredArray of phone number objects to check (max 1,000).
Phone object properties
body numberstringrequiredPhone number. Can include formatting (dashes, spaces, parentheses) — the API normalizes automatically.
Response Fields
Matched Result
| Field | Type | Description |
input | object | Echo of the original input object |
matched | boolean | true |
do_not_call | boolean | Whether the requested phone number is on the Do Not Call registry. Omitted if exact phone metadata is unavailable. |
phone_type | string | wireless, landline, voip, or unknown. Omitted if exact phone metadata is unavailable. |
Unmatched Result
| Field | Type | Description |
input | object | Echo of the original input object |
matched | boolean | false |
match_failure | object | Structured failure with code and reason |
Totals
| Field | Type | Description |
submitted | integer | Number of phones in the request array |
matched | integer | Number of phones that matched a person record |
unmatched | integer | Number of phones that did not match |
Credits
Each matched phone number consumes 1 credit. Unmatched numbers are free. Credits are deduplicated within your billing period — checking the same phone number again is free.
Notes
- Phone numbers are normalized automatically — formatting characters (dashes, spaces, parentheses) are stripped before matching.
- The DNC status reflects the national Do Not Call registry. State-level DNC lists are not included.
- This endpoint is optimized for DNC/type lookups. For full person data, use Enrich by Phone instead.
Request example
12345678910curl -X POST "https://api.v2.dealmachine.com/v1/phones/dnc" \ -H "Authorization: Bearer dm_sk_live_xxx" \ -H "Content-Type: application/json" \ -d '{ "phones": [ { "number": "5125551234" }, { "number": "3145559876" }, { "number": "(212) 555-0100" } ] }'
Response example
12345678910111213141516171819202122232425262728293031323334{ "data": [ { "input": { "number": "5125551234" }, "matched": true, "do_not_call": false, "phone_type": "wireless" }, { "input": { "number": "3145559876" }, "matched": true, "do_not_call": true, "phone_type": "landline" }, { "input": { "number": "(212) 555-0100" }, "matched": false, "match_failure": { "code": "no_match", "reason": "No person found with this phone number" } } ], "totals": { "submitted": 3, "matched": 2, "unmatched": 1 }, "credits": { "used": 2, "people": 2, "deduplicated": 0 } }