DNC Plus API Documentation

DNC Plus API uses GET/POST methods and supports only HTTPS with TLS v1.2+. Determines if the phone number is present on national, state, or Direct Marketing Association do not call lists. It also identifies the phone number connection status, line type, and if the phone number is associated with a known TCPA litigator or serial plaintiff.

Before using, please make sure you have a SAN number from https://telemarketing.donotcall.gov/profile/create.aspx

Required Input Parameters:

Output(OPTIONAL) set to “json” or “xml”. Omitting this defaults to XML
Phone10 numeric digits ONLY
TokenUnique PW given by RealValidation

Response Fields:

Response FieldDescription
Phone10 numeric digits ONLY
RESPONSECODE“OK” or corresponding error code – see Appendix A
RESPONSEMSGBlank or corresponding error message – see Appendix A
national_dnc“Y”, “N”, “?” indicating a “yes”, “no”, or “timeout” presence on the national DNC list
state_dnc“Y”, “N”, “?” indicating a “yes”, “no”, or “timeout” presence on the state DNC list
dma“Y”, “N”, “?” indicating a “yes”, “no”, or “timeout” presence on the DMA list
litigator“Y”, “N”, “?” indicating a “yes”, “no”, or “timeout” if a known DNC litigator
Iscell“Y” means Cell phone, “N” means Landline (“V” is for VoIP if enabled on account)
Status(See Appendix A below)
error_text(See Appendix A below)

Example API Call


Result in XML

<?xml version= "1.0 " encoding= "UTF-8 "?>

Result in JSON


Appendix A:

StatusError TextDescription
-1Missing numberMissing or badly formatted number
102The user is invalidThe phone number does not exist
unauthorized< blank >incorrect token or suspended account
invalid-phonePhone number does not exist
connectedTypically connected
connected-75Connected 75% of the time
pendingNot completed yet
disconnectedTypically disconnected
disconnected-70Disconnected 70% of the time
unreachableNot reachable
invalid phonePhone not valid
restrictedCan’t be dialed
ERRORbad phone number
ERRORmissing token
unauthorizedtoken is not valid
invalid-formatphone or zip are not in a valid format
invalid-phonephone number is not valid
bad-zip-codezip code is not valid
server-unavailablevarious messagesContact support

Not super techie… integrate DNC Plus into your favorite CRM, forms, and apps using Zapier or Integrately.

DNC Plus API Doc
DNC Plus API 060222

Before you go...

Are you currently using a
phone validation service?

Scroll to Top