API de consulta de empresas en Costa Rica: verifica una cédula jurídica (NITE)

Actualizado en noviembre de 2026

Esta guía muestra cómo consultar una empresa en Costa Rica por cédula jurídica 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.

Registros empresariales en Costa Rica

Las empresas costarricenses se identifican con su cédula jurídica, que asigna el Registro Nacional. Tiene diez dígitos y el prefijo indica el tipo de entidad; por ejemplo, las sociedades anónimas empiezan por 3-101.

El endpoint de Verifik usa el tipo de documento NITE y devuelve la razón social registrada para ese número. Es una forma rápida de confirmar que un proveedor o comercio existe antes de una debida diligencia más profunda.

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 jurídica de Costa Rica

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

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

{
  "data": {
    "businessName": "ENLACES CASUALES COSTA RICA SOCIEDAD ANONIMA",
    "documentNumber": "3101122876",
    "documentType": "NITE"
  },
  "signature": {
    "dateTime": "October 10, 2025 5:18 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "U6IYC"
}

Una consulta exitosa devuelve HTTP 200 con un objeto data que contiene: businessName, documentNumber, documentType. 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/company

• 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido; revisa la cabecera Authorization.
• 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 (“documentType must be one of: [NITE]”): 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

• Envía los diez dígitos sin guiones (3-101-122876 pasa a 3101122876).
• documentType debe ser NITE; otros valores devuelven 409.
• La respuesta solo devuelve la razón social. Compárala con el nombre legal del contrato.
• Para verificar al representante legal, consulta también la cédula de esa persona.

Datos personales y términos de uso

Los registros empresariales pueden incluir datos personales de socios, dignatarios o representantes. 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 cédula costarricense
• API de consulta de RUC en Panamá
• 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.