API de verificación de cédula uruguaya (CCUY): nombre y fecha de nacimiento

Actualizado en noviembre de 2026

Esta guía muestra cómo verificar cédula en Uruguay 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: cédula en Uruguay

La cédula de identidad uruguaya la emite la Dirección Nacional de Identificación Civil (DNIC), del Ministerio del Interior. Es el documento que se usa para abrir cuentas, contratar servicios y casi cualquier trámite formal, por lo que es la base natural del KYC en el país.

El endpoint de Verifik usa el tipo de documento CCUY y exige la fecha de nacimiento del titular. El registro solo se devuelve cuando el número y la fecha coinciden.

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 cédula de Uruguay

Endpoint: GET https://api.verifik.co/v2/uy/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/uy/cedula?documentType=CCUY&documentNumber=12345678&dateOfBirth=15/03/1990' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

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

{
  "data": {
    "documentType": "CCUY",
    "documentNumber": "12*****89",
    "firstName": "A**",
    "lastName": "G*****",
    "fullName": "A** G*****"
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "January 16, 2024 3:44 PM"
  },
  "id": "UY001"
}

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

• 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido; revisa la cabecera Authorization.
• 403 FORBIDDEN (“Access forbidden”): el token es válido pero no tiene acceso a este endpoint; revisa tu plan o permisos.
• 404 NotFound (“Record not found”): no se encontró registro; no lo trates como coincidencia y envía el caso a revisión o pide otro documento.
• 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

• Pide la fecha de nacimiento en el mismo paso que el número de cédula; es obligatoria (409 missing dateOfBirth si falta).
• Formatea la fecha como DD/MM/YYYY antes de enviarla, sin importar cómo la capture tu formulario.
• Compara el fullName devuelto con el nombre ingresado usando una coincidencia tolerante (tildes, dos apellidos).
• Trata el 404 como “sin coincidencia” y pide al usuario revisar número y fecha en lugar de reintentar automáticamente.

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 CIC paraguaya
• API de verificación de DNI argentino
• 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.