didit-database-validation
Integrate Didit Database Validation API to verify personal data against government databases. Use when the user wants to validate identity against government records, verify national ID numbers, check CPF/CURP/DNI/cedula numbers, perform identity database lookups, validate identity documents against official sources, or implement database verification for Latin American or Spanish identity documents using Didit. Supports 18 countries with 1x1 and 2x2 matching methods.
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- didit-database-validation
- version
- 1.0.0
- metadata
- { "openclaw": { "emoji": "🗄️", "homepage": "https://docs.didit.me", "requires": { "env": [ "DIDIT_API_KEY" ] }, "primaryEnv": "DIDIT_API_KEY" } }
- description
- Integrate Didit Database Validation API to verify personal data against government databases. Use when the user wants to validate identity against government records, verify national ID numbers, check CPF/CURP/DNI/cedula numbers, perform identity database lookups, validate identity documents against official sources, or implement database verification for Latin American or Spanish identity documents using Didit. Supports 18 countries with 1x1 and 2x2 matching methods.
03 SKILL.md 正文
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, orno_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:
- Register:
POST https://apx.didit.me/auth/v2/programmatic/register/with{"email": "you@gmail.com", "password": "MyStr0ng!Pass"} - Check email for a 6-character OTP code
- Verify:
POST https://apx.didit.me/auth/v2/programmatic/verify-email/with{"email": "you@gmail.com", "code": "A3K9F2"}→ response includesapi_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_VALIDATIONfires, 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
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.