Didit ID Verification API

Didit ID Verification API

Overview

Verifies an identity document from images (or PDFs) of its front and back in one synchronous call. Classifies the document automatically (you never declare the country or type), reads the visual zone with OCR, decodes the MRZ and barcodes, cross-checks dates, number formats and MRZ check digits, and by default screens both images for screen replays, printed copies and portrait manipulation. Returns the extracted fields, an Approved or Declined status and a warnings list.

Key constraints:

• Formats: JPEG, PNG, WebP, TIFF or PDF (extensions jpg, jpeg, png, webp, tiff, pdf). Encrypted PDFs need front_image_password / back_image_password
• Maximum upload size: 10 MB per side (larger files get 400). Images are compressed server-side
• Send the full, uncropped capture with all four corners visible; the service detects, aligns and crops the document itself
• Send back_image whenever the document has a back: many ID cards carry the MRZ or barcode there, and a missing back leaves those fields empty without a warning

Coverage: 14,000+ document types from 220+ countries and territories: passports, national ID cards, driver's licenses, residence permits and more.

Pricing: $0.20 per call that returns 200 (Approved or Declined); 400 responses are not billed, and standalone calls have no free tier. These are the list prices until 1 November 2026, when Didit pricing changes and the 500 free checks a month become $10 of free credit a month. Check didit.me/pricing for current prices. Digital ID wallets are billed separately (see Digital ID Wallets).

Sandbox: sandbox API keys skip processing and billing and return a static Approved mock (a fictional "Sandbox User" USA identity card) after request validation. Nothing is stored.

API Reference: https://docs.didit.me/standalone-apis/id-verification Feature Guide: https://docs.didit.me/core-technology/id-verification/overview Warnings: https://docs.didit.me/core-technology/id-verification/warnings-id-verification Supported Documents: https://docs.didit.me/core-technology/id-verification/supported-documents-id-verification

Authentication

Every request needs the x-api-key header. Use your application's API key from the Didit Business Console under Developers > API keys, or create an account and key programmatically (see Getting Started). Named keys with custom access need Sessions write to run standalone checks; a key limited to some workflows or to approved sessions cannot run them.

Getting Started (No Account Yet?)

If you don't have a Didit API key, create one in 2 API calls:

1. Register: POST https://apx.didit.me/auth/v2/programmatic/register/ with {"email": "[email protected]", "password": "MyStr0ng!Pass"}
2. Check email for a 6-character verification code
3. Verify: POST https://apx.didit.me/auth/v2/programmatic/verify-email/ with {"email": "[email protected]", "code": "A3K9F2"}. The key is in the response at application.api_key.

To add credits: GET /v3/billing/balance/ to check, POST /v3/billing/top-up/ with {"amount_in_dollars": 50} for a Stripe checkout link.

See the didit-verification-management skill for full platform management (workflows, sessions, users, billing).