Documentación

Chequea expone datos públicos peruanos con una interfaz consistente para validación documental, onboarding, compliance y automatización operativa.

RUC y empresa

Valida contribuyentes, normaliza padrones y refuerza onboarding empresarial.

Comprobantes y tipo de cambio

Resuelve validación documental y datos financieros de soporte operativo.

Catálogos y validación

Integra catálogos públicos y validaciones operativas con una interfaz consistente.

Qué puedes resolver con esta API

Validar empresas y contribuyentes con RUC SUNAT
Consultar tipo de cambio BCRP para facturación y valorización
Resolver catálogos públicos (ubigeos INEI) sin normalizar cada fuente
Integrar validaciones documentarias con una sola convención de errores

Qué encontrarás aquí

Guías cortas para empezar rápido
Playground interactivo por endpoint
Referencia API actualizada desde la especificación vigente
Ejemplos listos para copiar
Errores frecuentes y cómo tratarlos

En menos de 5 minutos

Genera una clave API
Haz una consulta simple de RUC o tipo de cambio
Revisa errores y límites
Diseña tu manejo de cuotas y 429

Endpoints disponibles hoy

GET /v1/ruc/{ruc} — consulta de RUC SUNAT
POST /v1/ruc/batch — hasta 100 RUCs por request
GET /v1/ubigeos + /v1/ubigeos/{code} — catálogo INEI (≈ 1 900 distritos)
GET /v1/tipo-cambio — BCRP USD/EUR diario

En la siguiente ola

DNI / RENIEC — consulta de datos de persona natural
CPE / SUNAT — validación de comprobantes de pago electrónicos
Webhooks — notificaciones push para eventos de tu cuenta
SDKs oficiales — Node y Python

Si necesitas alguno antes que llegue, escríbenos a support@chequea.pe — priorizamos según pedidos reales.

Ruta recomendada de lectura

Quickstart Genera tu clave API, prueba tu primer request y valida el flujo base.

Autenticación Entiende scopes, encabezados y consideraciones de seguridad.

Errores Revisa respuestas comunes, validaciones y límites de uso.

Cómo está organizada la referencia

Este portal reúne las guías de integración y la referencia API en una sola experiencia. Cada endpoint incluye su playground, parámetros, respuestas y notas de uso.

Casos de uso típicos

Alta y validación de proveedores con consulta RUC
Enriquecimiento de fichas empresariales (razón social, condición, ubigeo)
Validación de direcciones y catálogos territoriales (ubigeo INEI)
Conversión a soles con tipo de cambio BCRP
Controles básicos de cumplimiento sobre datos públicos disponibles

Cómo pensar la integración

Si buscas validación rápida, empieza por endpoints directos
Si integras varios dominios, revisa los scopes requeridos por endpoint
Si construyes producto para terceros, trata type y status como base de manejo de errores