Verificación instantánea de cédulas de identidad en El Salvador

API de verificación de DUI en El Salvador: valida el Documento Único de Identidad

Tabla de Contenidos
Comparte este artículo

Actualizado en noviembre de 2026

Esta guía muestra cómo verificar DUI en El Salvador con la API de Verifik: el endpoint, sus parámetros, una solicitud que puedes pegar en la terminal, la respuesta y los errores documentados, y qué revisar al llevarlo a producción. Todo lo que sigue proviene de la documentación oficial del endpoint.

Sobre el documento: DUI en El Salvador

El Documento Único de Identidad (DUI) es el documento nacional de El Salvador; lo emite el Registro Nacional de las Personas Naturales (RNPN) a ciudadanos desde los 18 años. El número tiene nueve dígitos, normalmente impresos como ocho dígitos, un guion y un dígito verificador.

El DUI también funciona como número tributario de las personas naturales, por lo que aparece en banca, nómina y remesas. El endpoint de Verifik recibe el DUI y la fecha de nacimiento y devuelve el nombre completo del titular.

Para seguir esta guía con tu propia integración, abre una cuenta en Verifik y genera tu token de acceso.

Cómo consultar la API de DUI de El Salvador

Endpoint: GET https://api.verifik.co/v2/sv/dui. Envía tu token en la cabecera Authorization: Bearer. Parámetros, según la documentación:

ParámetroObligatorioDescripción
documentNumberSíNúmero DUI sin espacios.
dateOfBirthSíFecha de nacimiento en formato DD/MM/YYYY.

Ejemplo de solicitud con valores de ejemplo (reemplázalos por los datos de tu usuario):

curl --location --request GET 'https://api.verifik.co/v2/sv/dui?documentNumber=012345678&dateOfBirth=15/03/1990' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Respuesta 200 de la documentación (datos personales enmascarados):

{
  "data": {
    "documentNumber": "12*****89",
    "fullName": "J*** P****"
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "January 16, 2024 3:44 PM"
  },
  "id": "SV001"
}

Una consulta exitosa devuelve HTTP 200 con un objeto data que contiene: documentNumber, fullName. Toda respuesta incluye además una signature (fecha y “Certified by Verifik.co”) y un id único que puedes guardar como evidencia de la verificación.

Errores documentados de /v2/sv/dui

  • 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido; revisa la cabecera Authorization.
  • 409 MissingParameter (“missing dateOfBirth”): falta un parámetro obligatorio o tiene un valor no válido; corrige la solicitud en vez de reintentarla igual.
  • 500 InternalServerError (“Server error”): error del servidor o de la fuente; reintenta con backoff y registra el id de la solicitud.

Consejos de integración

  • Quita los espacios del DUI antes de enviarlo; la documentación pide el número sin espacios.
  • La fecha de nacimiento es obligatoria y debe ir como DD/MM/YYYY (si falta, 409 missing dateOfBirth).
  • La respuesta solo devuelve fullName, así que prevé un paso de comparación de nombre en tu sistema.
  • En onboarding de remesas y billeteras, combina la consulta del DUI con una prueba de vida por selfie para frenar documentos prestados.

Datos personales y términos de uso

Las consultas de identidad tratan datos personales. Usa la API solo con una finalidad legítima que puedas documentar, como onboarding, prevención de fraude o verificación contractual, obtén el consentimiento cuando la ley local lo exija y conserva solo los campos que necesites. El uso se rige por los términos y condiciones de smartCHECK.

Precios

Cada solicitud exitosa consume créditos de tu plan de Verifik. Los planes vigentes y el costo por endpoint están en la página de precios de smartCHECK.

Guías y documentación relacionadas

Empieza a probar

Crea una cuenta en Verifik para obtener tu token de API, o agenda una reunión si quieres revisar cobertura y volúmenes con el equipo.

Miguel Treviño - Cofundador y CTO, Verifik

Preguntas frecuentes

➖

¿Qué datos devuelve el endpoint del DUI?

La respuesta documentada devuelve documentNumber y fullName, además del bloque signature de Verifik.

➕

¿Qué endpoint verifica DUI en El Salvador?

GET https://api.verifik.co/v2/sv/dui, con los parámetros documentNumber, dateOfBirth y tu token Bearer.

➕

¿Qué errores puede devolver el endpoint de DUI de El Salvador?

La documentación lista HTTP 401, 409, 500. En resumen: 409 suele indicar un parámetro faltante o no válido; un 500 es un error del servidor o de la fuente; conviene reintentar más tarde.

➕

¿Cómo se cobra la consulta de DUI de El Salvador?

Cada solicitud exitosa consume créditos de tu plan de Verifik. Consulta la página de precios de smartCHECK para ver los planes vigentes.

Explora otros artículos