> ## 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 de validation en base de données : KYC par registres
> Vérifiez l'identité via registres officiels avec Didit : dès $0.05/contrôle, 60+ pays et correspondance faciale biométrique.
La **Validation en base de données** de Didit vérifie les données d'identité d'une personne auprès de la source faisant autorité pour ce pays — le registre d'état civil national, l'administration fiscale, la liste électorale, le bureau de crédit ou le registre biométrique qui a initialement délivré le document. Chaque vérification renvoie une correspondance champ par champ (`identification_number`, `first_name`, `last_name`, `date_of_birth` et les champs d'adresse lorsque le service les utilise), ainsi qu'un résultat agrégé et les détails du dossier sous-jacent lorsqu'ils sont disponibles.Il s'agit de la défense la plus solide contre la fraude à l'identité synthétique : un DNI ou un CPF réel volé échouera à la vérification du registre, et un numéro inventé ne figurera pas du tout dans la base de données officielle. La validation en base de données s'associe à notre correspondance faciale biométrique dans les pays où le registre conserve une photo officielle (l'Argentine via RENAPER, le Panama via le Tribunal Electoral SIB / SIB Plus) afin que vous puissiez confirmer non seulement qu'un numéro est réel, mais que la **personne devant la caméra en est bien le titulaire**.
Prompt d'intégration de la validation en base de données
\
\````# 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````
\
## Pourquoi Didit- **Les tarifs à l'appel les plus bas.** À partir de **\$0.05** par vérification (République dominicaine) jusqu'à **\$7.00** pour les sources spécialisées les plus onéreuses. Le prix est fixé par service et non par pays — un service associé à un registre qui facture un tarif de gros élevé est tarifé en conséquence (la carte d'identité finlandaise est à **\$2.10**). Consultez toujours le tarif du service exact que vous prévoyez d'appeler dans le [tableau des tarifs par service](https://docs.didit.me/fr/getting-started/database-validation-pricing.md). Aucun minimum mensuel, aucun frais de plateforme, aucune facturation par siège — seules les requêtes réussies sont facturées.
- **La plus rapide à intégrer.** [Inscrivez-vous](https://business.didit.me/), récupérez une clé API sur la console, et vous pouvez appeler `POST /v3/database-validation/` en quelques minutes. Aucun appel commercial, aucun cycle d'approvisionnement, aucune formalité de preuve de concept — Didit est entièrement en libre-service.
- **Accès direct aux sources faisant autorité.** 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 — et non de l'extraction de données chez des agrégateurs.
- **Correspondance faciale biométrique lorsque le registre dispose d'une photo officielle enregistrée.** Un niveau de confiance supérieur à celui de l'OCR, sans travail d'intégration supplémentaire.
- **Latence adaptée à la production.** p95 généralement inférieur à 1.5 s de bout en bout, disponibilité trimestrielle de 99.9%.La leçon de l'Academy sur la lecture d'un résultat de vérification aborde la validation en base de données à 11:05 et montre les résultats avec correspondance complète, correspondance partielle et sans correspondance.[Validation en base de données : correspondance complète, partielle et absence de correspondance — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=665\&rel=0\&playsinline=1)## Couverture mondialeSurvolez n'importe quel pays mis en évidence pour voir chaque service de validation en base de données que nous y exploitons, le domaine de données (Identité, Financier, Biométrique, Adresse, Télécom, …) et le prix par appel. Les pays actifs sont prêts pour la production dès aujourd'hui ; les autres sont raccordés sur demande dès qu'un client en fait la demande.Live Database Validation coverageProduction-ready countries and the cheapest live service available in each.LIVEShow on-demand catalog countries ()
| Pays |
\ISO3 |
\Service |
\Description |
\Prix (USD) |
|---|
\
## Poursuivre la lecture- [Méthodes de correspondance](https://docs.didit.me/fr/core-technology/database-validation/database-validation-matching-methods.md) — comment les résultats 1×1 / 2×2 sont dérivés et comment réagir en conséquence.
- [Codes de résultat](https://docs.didit.me/fr/core-technology/database-validation/database-validation-outcome-codes.md) — la liste complète des codes de réponse des fournisseurs (personne décédée, mineur, document non trouvé, incohérence biométrique, …) et leur correspondance avec les décisions de session.
- [Avertissements](https://docs.didit.me/fr/core-technology/database-validation/database-validation-warnings.md) — ce que nous signalons lorsqu'un service ne peut pas s'exécuter en raison de données manquantes.
- [Rapports](https://docs.didit.me/fr/core-technology/database-validation/database-validation-report.md) — exports mensuels de facturation par service avec pays, identifiant de service, utilisation, prix unitaire et coût total.
- [Pays pris en charge](https://docs.didit.me/fr/core-technology/database-validation/database-validation-supported-countries.md) — une vue tabulaire statique de tous les pays que nous couvrons aujourd'hui.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.