Didit Database Validation API

Didit Database Validation API

Overview

Verifies personal data against the authoritative source for a country (civil registry, tax authority, electoral roll or biometric registry) and returns a per-field comparison, a per-service outcome code and the registry record. Use it to catch synthetic identities and ID numbers that do not belong to the person.

Pricing: per service, from $0.05 (Dominican Republic dom_cedula) to $7.00 per query; most Latin American national ID services are $0.20 (billed once per service the registry answered, including no-match and not-found answers; 400 rejections and services the source never answered are free; 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.

Key constraints:

• issuing_state is ISO 3166-1 alpha-3 (BRA, PER, ARG). Alpha-2 codes (BR) return 400 "Invalid issuing state".
• Each country exposes one or more services (service_id). Without services, exactly one default service runs. Spain, Kenya, Zambia and most non-Latin-American services have no default: name them in services.
• Required fields depend on the selected services. Missing or malformed fields return 400 before any registry call (never billed).
• Send JSON, or multipart/form-data when a service needs a selfie (Argentina arg_renaper, Panama pan_cedula_sib, other biometric services).
• Results per field: full_match, partial_match, no_match. Overall status: Approved, Declined or In Review.

Coverage: the public catalog listed 123 live services in 45 countries plus a global (GLB) group on 2026-10-12: 17 Latin American countries, Spain, South Africa, Kenya, Zambia, Nigeria and identity, credit, residential and phone datasets in Europe, North America and Asia-Pacific. Read the live list (no API key needed):

GET https://verification.didit.me/v1/organization/database-validation-countries/

It returns { "<ISO3>": { "country_iso3", "country_name", "region", "services": [ { "service_id", "service_name", "coverage", "default_price_usd", "required_fields", "requires_any_fields", "optional_fields", "requires_consent", "requires_onboarding", "supports_selfie", ... } ] } }. Services with requires_onboarding: true return 400 until Didit support activates them for your organization.

API Reference: https://docs.didit.me/standalone-apis/database-validation Feature Guide: https://docs.didit.me/core-technology/database-validation/overview Supported Countries: https://docs.didit.me/core-technology/database-validation/database-validation-supported-countries Prices per service: https://docs.didit.me/getting-started/database-validation-pricing

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