API de verificación de cédula de Costa Rica (CCCR): nombre y estado de renovación TSE

Actualizado en noviembre de 2026

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

La cédula de identidad de Costa Rica la emite el Tribunal Supremo de Elecciones (TSE) a través del Registro Civil. El número tiene nueve dígitos y el primero suele indicar la provincia de inscripción.

El endpoint de Verifik usa el tipo de documento CCCR y devuelve el nombre registrado. Además resuelve un caso propio de Costa Rica: las cédulas que el TSE exige renovar de forma presencial.

Si ya tienes claro el caso de uso, crea una cuenta y prueba el endpoint desde tu código.

Cómo consultar la API de cédula de Costa Rica

Endpoint: GET https://api.verifik.co/v2/cr/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/cr/cedula?documentType=CCCR&documentNumber=101110111' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

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

{
  "data": {
    "documentType": "CCCR",
    "documentNumber": "01*****01",
    "firstName": "M**** E****",
    "lastName": "L**** G*****",
    "fullName": "M**** E**** L**** G*****"
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "July 27, 2026 3:00 PM"
  }
}

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/cr/cedula

• 400 INVALID_DOCUMENT (“Invalid document number”): el número no pasó la validación; pide al usuario revisarlo antes de reintentar.
• 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido; revisa la cabecera Authorization.
• 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

• Envía el número sin espacios, puntos ni guiones (por ejemplo 101110111, no 1-1110-0111).
• Una cédula que no puede reimprimirse en línea igual responde 200, con status: "requires_renewal" y expired: true, más un message bilingüe. Ramifica tu lógica con esos campos en vez de aprobar todo 200.
• Muestra al usuario message.es o message.en para que sepa que debe renovar el documento en una oficina del TSE.
• Un 400 INVALID_DOCUMENT indica formato incorrecto; valida la longitud antes de llamar.

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 consulta de empresas en Costa Rica
• API de verificación de cédula panameña
• 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.