> ## 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 через госреестры
> API проверки по госреестрам Didit: от $0.05/check с оплатой за запрос. 60+ стран, биометрическое сравнение лиц при наличии фото.
**Проверка по базам данных** Didit сверяет идентификационные данные человека с официальным источником в соответствующей стране — национальным реестром актов гражданского состояния, налоговой службой, списком избирателей, кредитным бюро или биометрическим реестром, который изначально выдал документ. Каждая проверка возвращает результат сопоставления по каждому полю (`identification_number`, `first_name`, `last_name`, `date_of_birth` и поля адреса, если сервис их использует), а также агрегированный результат и исходные данные записи, если они доступны.Это самая надёжная защита от мошенничества с синтетическими личностями: украденный реальный DNI или CPF не пройдёт проверку в реестре, а сфабрикованного номера в официальной базе данных просто не окажется. Проверка по базам данных работает в связке с нашей биометрической функцией сравнения лиц в странах, где реестр хранит официальную фотографию (Аргентина через RENAPER, Панама через Tribunal Electoral SIB / SIB Plus). Благодаря этому вы можете убедиться не только в подлинности номера, но и в том, что **человек перед камерой действительно является его владельцем**.
Промпт для интеграции проверки по базам данных
\
\````# 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````
\
## Почему Didit- **Самые низкие цены с оплатой за запрос.** От **\$0.05** за проверку (Доминиканская Республика) до **\$7.00** для самых дорогих специализированных источников. Цена устанавливается за сервис, а не за страну — если реестр взимает высокую оптовую ставку, цена формируется соответственно (национальное удостоверение Финляндии стоит **\$2.10**). Актуальный тариф для конкретного сервиса всегда можно посмотреть в [таблице цен по сервисам](https://docs.didit.me/ru/getting-started/database-validation-pricing.md). Никаких ежемесячных минимумов, плат за платформу или тарификации за места — оплачиваются только успешные запросы.
- **Самая быстрая интеграция.** [Зарегистрируйтесь](https://business.didit.me/), получите API-ключ в консоли и вызывайте `POST /v3/database-validation/` уже через несколько минут. Никаких звонков в отдел продаж, циклов закупки и документов для проверки концепции — 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%.Урок Didit Academy по чтению результатов верификации доходит до проверки по базам данных на отметке 11:05 и демонстрирует полное и частичное совпадение, а также отсутствие совпадения.[Проверка по базам данных: полное, частичное совпадение и отсутствие совпадений — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=665\&rel=0\&playsinline=1)## Глобальное покрытиеНаведите курсор на любую подсвеченную страну, чтобы увидеть все доступные в ней сервисы проверки по базам данных, категорию данных (идентификационные данные, финансовые данные, биометрические данные, адресные данные, телекоммуникационные данные, …) и цену за запрос. Страны, доступные в продакшне, готовы к использованию уже сегодня; остальные подключаются по запросу клиента.Live Database Validation coverageProduction-ready countries and the cheapest live service available in each.LIVEShow on-demand catalog countries ()
| Страна |
\ISO3 |
\Услуга |
\Описание |
\Цена (USD) |
|---|
\
## Что читать дальше- [Методы сопоставления](https://docs.didit.me/ru/core-technology/database-validation/database-validation-matching-methods.md) — как формируются результаты 1×1 / 2×2 и как на них реагировать.
- [Коды результатов](https://docs.didit.me/ru/core-technology/database-validation/database-validation-outcome-codes.md) — полный список кодов ответов провайдеров (умерший, несовершеннолетний, документ не найден, биометрическое несовпадение, …) и их сопоставление с решениями по сессиям.
- [Предупреждения](https://docs.didit.me/ru/core-technology/database-validation/database-validation-warnings.md) — что отображается, когда сервис не может быть запущен из-за отсутствия данных.
- [Отчёты](https://docs.didit.me/ru/core-technology/database-validation/database-validation-report.md) — ежемесячные выгрузки биллинга по сервисам с указанием страны, идентификатора сервиса, объёма использования, цены за единицу и общей стоимости.
- [Поддерживаемые страны](https://docs.didit.me/ru/core-technology/database-validation/database-validation-supported-countries.md) — статическая таблица со всеми странами, которые поддерживаются на сегодняшний день.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.