> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.
# データベース検証API - 政府レジストリで行うKYC
> Diditのデータベース検証は、政府レジストリと照合する従量課金の本人確認APIです。1回$0.05から、60+の国で提供し、写真を保有するレジストリでは顔照合にも対応します。
Diditの**データベース検証**は、本人のID情報を、その国の信頼できる一次情報源(そもそも書類を発行した国の住民登録簿、税務当局、選挙人名簿、信用情報機関、生体情報レジストリ)と照合します。各チェックは、フィールドごとの一致結果(`identification_number`、`first_name`、`last_name`、`date_of_birth`、サービスが利用する場合は住所フィールド)に加え、総合結果と、取得できる場合は元のレコード詳細を返します。合成ID詐欺に対する最も強力な防御策です。盗まれた実在のDNIやCPFはレジストリ照会で失敗し、でっち上げた番号は公式データベースにそもそも存在しません。レジストリが公式の顔写真を保有している国(RENAPER経由のアルゼンチン、Tribunal Electoral SIB / SIB Plus経由のパナマ)では、データベース検証をDiditの生体顔照合と組み合わせることで、番号が実在することだけでなく、**カメラの前にいる本人がその番号の持ち主であること**まで確認できます。
データベース検証の連携プロンプト
Copy prompt to clipboard
\
\````# Goal
Integrate Didit Database Validation (verify identity data against authoritative national registries) into your app. Pick ONE mode.
\# Mode A — Session-based
Use this when Database Validation runs as a step in a hosted Didit flow. Fields are auto-fed into the registry lookup from the steps in front of it — ID Verification, NFC, Liveness, Phone/Email Verification, Proof of Address, Document AI or a Questionnaire. An ID Verification step is not required.
1\. Add the DATABASE_VALIDATION feature to the workflow (Business Console or POST /v3/workflows/). Optionally pin specific services per country.
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user (or mount the Web/Mobile SDK).
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.
Decision surface: `database_validations[]` array on the decision payload.
\# Mode B — Standalone API (server-to-server)
Use when you already have the identity data and want a one-shot registry check.
POST https://verification.didit.me/v3/database-validation/
multipart/form-data — x-api-key: YOUR_API_KEY
curl example (Brazil CPF):
\```bash
curl -X POST 'https://verification.didit.me/v3/database-validation/' \
-H "x-api-key: $DIDIT_API_KEY" \
-F "issuing_state=BRA" \
-F "identification_number=00000000191" \
-F "first_name=Jane" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-15" \
-F "vendor_data=user-1234"
\```
Returns: { request_id, database_validation: { match_type: "full_match"|"partial_match"|"no_match", validation_type, services_used, match_score, validations: [{ service, status, matched_fields, record_details }], warnings: [...] } }.
\# Important behaviour
\- Use `identification_number` (universal field) — Didit maps it to CPF/RUT/CURP/DNI/etc. by issuing_state.
\- Omit `services` to run the country's default service only. Pass `services=["bra_cpf"]` (etc.) to choose which services run — list several to run more than one.
\- Argentina (`arg_renaper`) and Panama (`pan_sib`) take an extra `selfie` (JPG/PNG/WebP up to 2 MB) and `gender` for biometric face-match against the registry photo.
\- Services flagged `requires_consent=true` in the catalog require `consent=true` (HTTP 400 otherwise).
\- Billing is **per successful service hit** — multi-service requests can produce multiple usage events.
\# Status / match_type
status: "Approved" | "In Review" | "Declined" (per the partial-match / no-match actions configured on the workflow)
match_type: "full_match" | "partial_match" | "no_match"
\# Warnings (LogWarningChoices.DATABASE_VALIDATION)
warnings[] risk codes include:
DATABASE_VALIDATION_NO_MATCH, DATABASE_VALIDATION_PARTIAL_MATCH, COULD_NOT_PERFORM_DATABASE_VALIDATION (biometric outcomes surface via per-service outcome_code, e.g. BIOMETRIC_NO_MATCH).
Full catalogue: /core-technology/database-validation/database-validation-warnings.
\# Failure modes to handle
\- HTTP 400 — service id not eligible for issuing_state, missing required field, missing consent for PAYGO services.
\- HTTP 502 with validation_errors[] — every selected upstream service failed; request is **not billed** and a COULD_NOT_PERFORM_DATABASE_VALIDATION log is written. Retry later or fall back to OCR-only.
\- match_type="no_match" — record not in registry; treat as synthetic identity per policy.
\- match_type="partial_match" — some fields match, others don't (e.g. DOB matches, name doesn't); route to review.
\# See also
\- Canonical schema: /reference/data-models#database-validation
\- Per-feature report: /core-technology/database-validation/database-validation-report
\- Risk catalogue: /core-technology/database-validation/database-validation-warnings
\- Outcome codes: /core-technology/database-validation/database-validation-outcome-codes
\- Full integration playbook: /integration/integration-prompt````
\
Paste into
## Diditが選ばれる理由- **従量課金で最安水準の料金。** 1回の確認あたり、**\$0.05**(ドミニカ共和国)から、最も高額な専門ソースの\*\*\$7.00**まで。料金は国ごとではなくサービスごとに設定されており、卸売料金が高いレジストリはそれに応じた価格になります(フィンランドの国民IDは**\$2.10\*\*です)。呼び出す予定のサービスの料金は、必ず[サービス別の料金表](https://docs.didit.me/getting-started/database-validation-pricing.md)で確認してください。月額の最低料金、プラットフォーム利用料、ユーザー単位の課金はなく、成功したクエリにのみ課金されます。
- **最短で導入可能。** [サインアップ](https://business.didit.me/)し、コンソールからAPIキーを取得すれば、数分で`POST /v3/database-validation/`を呼び出せます。営業との打ち合わせ、調達手続き、PoCの書類は不要で、Diditは完全にセルフサービスです。
- **一次情報源へ直接アクセス。** RENAPER、Receita Federal (SERPRO)、Tribunal Electoral、RENAPO、RENAP、RNP、RNPN、Junta Central Electoral、Registraduría Nacional、SEGIP、Servicio de Registro Civil、Tribunal Supremo de Elecciones、Dirección General de la Policía - アグリゲーターによるスクレイピングではありません。
- **レジストリに公式の顔写真がある場合は生体顔照合。** 追加の連携作業なしで、OCRより高い信頼度が得られます。
- **本番運用に耐えるレイテンシ。** エンドツーエンドでp95は通常1.5秒未満、四半期ごとの可用性は99.9%です。Academyの「検証結果の読み方」のレッスンでは、11:05からデータベース検証を取り上げ、完全一致、部分一致、不一致の結果を確認します。[データベース検証: 完全一致、部分一致、不一致 — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=665\&rel=0\&playsinline=1)## 対応地域ハイライトされた国にカーソルを合わせると、その国で提供しているすべてのデータベース検証サービス、データ領域(ID、金融、生体、住所、通信など)、1回あたりの料金が表示されます。提供中の国はすぐに本番で利用でき、それ以外の国は、お客様のご要望に応じて順次対応します。Live Database Validation coverageProduction-ready countries and the cheapest live service available in each.LIVEShow on-demand catalog countries ()
| Country |
\ISO3 |
\Service |
\Description |
\Price (USD) |
|---|
\
## 関連ドキュメント- [一致方式](https://docs.didit.me/core-technology/database-validation/database-validation-matching-methods.md) — 1×1 / 2×2の結果の導出方法と、それへの対応方法。
- [結果コード](https://docs.didit.me/core-technology/database-validation/database-validation-outcome-codes.md) — プロバイダーのレスポンスコードの一覧(死亡、未成年、書類が見つからない、生体の不一致など)と、セッションの判定へのマッピング。
- [警告](https://docs.didit.me/core-technology/database-validation/database-validation-warnings.md) — データ不足でサービスを実行できなかった場合に表示される内容。
- [レポート](https://docs.didit.me/core-technology/database-validation/database-validation-report.md) — 国、サービスID、利用量、単価、合計コストを含む、サービスごとの月次請求エクスポート。
- [対応国](https://docs.didit.me/core-technology/database-validation/database-validation-supported-countries.md) — 現在対応しているすべての国を一覧にした表。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.