DMVerify API Documentation

Our API lets you decode the hidden Document Discriminator (DD) on California IDs and return the DMV office name—no PII, no guesswork.

Base URL

POST https://api.dmverify.com/api.php

Authentication

Include your API key in one of these headers:

X-API-KEY: YOUR_API_KEY

or

Authorization: Bearer YOUR_API_KEY

Request

Send a JSON body with the DD string under dd_number:

{
  "dd_number": "23/32/202066388/ASDR/23"
}

Response

Success (HTTP 200):

{
  "success": true,
  "office_name": "Sacramento",
  "calls_remaining": 7
}

Error (HTTP 4xx):

{
  "success": false,
  "error": "Invalid DD number format."
}

Error Codes

HTTP Status	Error	Meaning
400	Invalid DD number format.	DD string too short or malformed.
400	DD number not found	No matching DMV office code.
401	Missing API key.	No valid key provided.
401	Unknown API key.	Key not recognized.
403	Access denied.	Trial expired or not authorized.
429	Monthly quota exceeded.	No calls left this month.
500	Database connection failed	Server misconfiguration.

Rate Limiting & Quotas

Each account gets a monthly quota (default 10 free calls). Quotas reset at midnight UTC on the first of each month.

Support & Contact

If you have questions or need higher quotas, email support@dmverify.com.