Skip to main content
POST
/
v1
/
phones
/
dnc
curl -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" }
    ]
  }'

{
  "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
  }
}
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

​
phones
array
required
Array of phone number objects to check (max 1,000).
curl -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" }
    ]
  }'

{
  "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
  }
}

​
Response Fields

​
Matched Result

FieldTypeDescription
inputobjectEcho of the original input object
matchedbooleantrue
do_not_callbooleanWhether the phone number is on the Do Not Call registry
phone_typestringPhone line type: wireless, landline, or omitted if unknown

​
Unmatched Result

FieldTypeDescription
inputobjectEcho of the original input object
matchedbooleanfalse
match_failureobjectStructured failure with code and reason

​
Totals

FieldTypeDescription
submittedintegerNumber of phones in the request array
matchedintegerNumber of phones that matched a person record
unmatchedintegerNumber 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.