API de verificación de CUI en Guatemala: valida el DPI con fecha de nacimiento

Actualizado en noviembre de 2026

Esta guía muestra cómo verificar CUI en Guatemala 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: CUI en Guatemala

El Documento Personal de Identificación (DPI) de Guatemala lo emite el RENAP, Registro Nacional de las Personas. Su número clave es el Código Único de Identificación (CUI), de 13 dígitos, cuyos últimos dígitos identifican el departamento y municipio de inscripción.

El endpoint de Verifik usa el tipo de documento CUI más la fecha de nacimiento y devuelve el nombre del titular separado en nombres, apellidos y partes del nombre.

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 CUI de Guatemala

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

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

curl --location --request GET 'https://api.verifik.co/v2/gt/cedula?documentType=CUI&documentNumber=1234567890101&dateOfBirth=12/03/1984' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

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

{
  "data": {
    "arrayName": [
      "E****",
      "R******",
      "R******",
      "M******"
    ],
    "documentNumber": "22*********03",
    "documentType": "CUI",
    "firstName": "E**** R******",
    "fullName": "E**** R****** R****** M******",
    "lastName": "R****** M******"
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "January 16, 2024 3:44 PM"
  },
  "id": "GT001"
}

Una consulta exitosa devuelve HTTP 200 con un objeto data que contiene: arrayName, documentNumber, documentType, firstName, fullName, lastName. 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/gt/cedula

• 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido; revisa la cabecera Authorization.
• 409 MissingParameter (“missing documentType missing documentNumber 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

• Los tres parámetros son obligatorios. Si falta alguno, la API responde 409 MissingParameter indicando cuál.
• Envía la fecha como DD/MM/YYYY, por ejemplo 12/03/1984.
• Quita los espacios que los usuarios copian del DPI (viene impreso en grupos de 4-5-4 dígitos).
• Usa arrayName para comparar nombres con varios nombres de pila o apellido de casada.

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

• API de verificación de DUI salvadoreño
• API de verificación de DNI hondureño
• Documentación del endpoint (español)
• Documentación en inglés

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.