Didit Database Validation

Didit Database Validation API

Overview

Verifies personal data and identity documents against trusted government and financial databases. Prevents synthetic identity fraud and ensures identity authenticity.

Key constraints:

• Requires at least the national ID/document number for the target country
• Coverage: 18 countries (primarily Latin America + Spain)
• Results: full_match, partial_match, or no_match
• Only charged per successful query — no charge if insufficient data

Matching methods:

| Method | Description | Starting Price | |---|---|---| | 1x1 | Single data source validation | $0.05 | | 2x2 | Two data sources cross-validation | $0.30 |

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

---

Authentication

All requests require x-api-key header. Get your key from Didit Business Console → API & Webhooks, or via programmatic registration (see below).

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": "you@gmail.com", "password": "MyStr0ng!Pass"}
2. Check email for a 6-character OTP code
3. Verify: POST https://apx.didit.me/auth/v2/programmatic/verify-email/ with {"email": "you@gmail.com", "code": "A3K9F2"} → response includes 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).

---

Endpoint

POST https://verification.didit.me/v3/database-validation/

Headers

| Header | Value | Required | |---|---|---| | x-api-key | Your API key | Yes | | Content-Type | application/json | Yes |

Body (JSON)

| Parameter | Type | Required | Description | |---|---|---|---| | id_number | string | Yes | Universal ID number — auto-maps to correct country field | | first_name | string | No | First name for matching | | last_name | string | No | Last name for matching | | date_of_birth | string | No | DOB in YYYY-MM-DD (required for some countries) | | issuing_state | string | No | ISO 3166-1 alpha-3 country code | | save_api_request | boolean | No | Save in Business Console | | vendor_data | string | No | Your identifier for session tracking |

The id_number field auto-maps to the correct country-specific field:

| Country | Mapped Field | Document | Format | |---|---|---|---| | ARG | document_number | DNI | — | | BOL | document_number | CI | — | | BRA | tax_number | CPF | 11 digits | | CHL | personal_number | RUT | — | | COL | personal_number | Cedula | — | | CRI | personal_number | Cedula | — | | DOM | personal_number | Cedula | 11 digits | | ECU | personal_number | Cedula | 10 digits | | ESP | personal_number | DNI/NIE | — | | GTM | document_number | DPI | — | | HND | document_number | DNI | — | | MEX | personal_number | CURP | 18 chars | | PAN | document_number | Cedula | — | | PER | personal_number | DNI | 8 digits | | PRY | document_number | CI | — | | SLV | document_number | DUI | — | | URY | personal_number | CI | — | | VEN | document_number | Cedula | — |

Example

import requests

response = requests.post(
    "https://verification.didit.me/v3/database-validation/",
    headers={"x-api-key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
        "id_number": "12345678",
        "first_name": "Carlos",
        "last_name": "Garcia",
        "issuing_state": "PER",
    },
)
print(response.json())

const response = await fetch("https://verification.didit.me/v3/database-validation/", {
  method: "POST",
  headers: { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    id_number: "12345678",
    first_name: "Carlos",
    last_name: "Garcia",
    issuing_state: "PER",
  }),
});

Response (200 OK)

{
  "request_id": "a1b2c3d4-...",
  "database_validation": {
    "status": "Approved",
    "match_type": "full_match",
    "issuing_state": "PER",
    "validation_type": "1x1",
    "screened_data": {
      "personal_number": "12345678",
      "first_name": "Carlos",
      "last_name": "Garcia"
    },
    "validations": {
      "full_name": "full_match",
      "identification_number": "full_match"
    }
  }
}

Status Values & Handling

| Status | Meaning | Action | |---|---|---| | "Approved" | Full match against government records | Identity confirmed | | "Declined" | No match found | Identity could not be verified | | "In Review" | Partial match or insufficient data | Review screened_data and validations |

Error Responses

| Code | Meaning | Action | |---|---|---| | 400 | Invalid request | Check ID number format for target country | | 401 | Invalid API key | Verify x-api-key header | | 403 | Insufficient credits | Top up at business.didit.me |

---

Matching Logic

Name Matching

| Result | Criteria | |---|---| | Full Match | Full name concatenation at 85% similarity (Levenshtein), OR First + Last both full match | | Partial Match | Any single name component full match | | No Match | No component reaches 70% similarity |

> Individual name components use 70% Levenshtein threshold. Example: "Christophel" vs "Christopher" = Full Match; "Chris" vs "Christopher" = No Match.

1x1 Decision

| Match Type | Name | ID Number | |---|---|---| | full_match | Full Match | Full Match | | partial_match | Partial Match | Full Match | | no_match | All other combinations | — |

2x2 Decision

Requires matching against 2 independent data sources:

| Match Type | Condition | |---|---| | full_match | Both sources confirm name + ID | | partial_match | One source confirms | | no_match | Neither source confirms |

> DOB and ID number matching is exact only — no fuzzy matching.

---

Warning Tags

| Tag | Description | |---|---| | COULD_NOT_PERFORM_DATABASE_VALIDATION | Missing required data — provide ID number, name, and country | | DATABASE_VALIDATION_PARTIAL_MATCH | Partial match found — requires investigation | | DATABASE_VALIDATION_NO_MATCH | No match found in government records |

> When COULD_NOT_PERFORM_DATABASE_VALIDATION fires, session goes to "In Review". Validation auto-retriggers once missing data is provided.

---

Supported Countries

| Country | Method | Coverage | Required Input | |---|---|---|---| | Argentina | 1x1 | 95% | Document number | | Bolivia | 1x1 | 95% | Document number + DOB | | Brazil | 1x1 | 95% | Tax number (CPF) | | Chile | 1x1 | 95% | Personal number (RUT) | | Colombia | 1x1 | 95% | Document number + type | | Costa Rica | 1x1 | 95% | Personal number | | Dominican Republic | 1x1 | 95% | Personal number | | Ecuador | 1x1 / 2x2 | 90-96% | Personal number | | El Salvador | 1x1 | 95% | Document number + DOB | | Guatemala | 1x1 | 95% | Document number | | Honduras | 1x1 | 95% | Document number | | Mexico | 1x1 | 95% | Personal number (CURP) | | Panama | 1x1 | 95% | Document number + DOB | | Paraguay | 1x1 | 95% | Document number | | Peru | 1x1 / 2x2 | 95-99% | Personal number | | Spain | 1x1 | 95% | Personal number + doc type + expiry | | Uruguay | 1x1 | 95% | Personal number + DOB | | Venezuela | 1x1 | 95% | Document number |

---

Utility Scripts

validate_database.py: Validate identity against government databases from the command line.

# Requires: pip install requests
export DIDIT_API_KEY="your_api_key"
python scripts/validate_database.py --id-number 12345678 --country PER --first-name Carlos --last-name Garcia
python scripts/validate_database.py --id-number GARC850315HDFRRL09 --country MEX

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: didit-protocol
• Source: didit-protocol/skills
• License: MIT

Install and usage instructions live in the source repository linked above.