Introducción · Documentación de la API

endpoint.pe es una API REST para consultar datos oficiales del Perú desde tu sistema (RUC, DNI, tipo de cambio, ubigeo y más) en JSON y con un solo token.

endpoint.pe te da acceso por HTTP a datos públicos y oficiales del Perú: el padrón de contribuyentes de SUNAT, la identidad de un DNI según RENIEC, el tipo de cambio que publica SUNAT y los códigos de ubigeo del INEI. Todas las APIs comparten el mismo token, el mismo formato de respuesta y el mismo sistema de créditos: integras una y ya sabes integrar las demás.

Cómo funciona

Crea una cuenta y verifica tu correo. Toda cuenta empieza con 150 consultas gratis al mes, sin tarjeta.
Genera una API key en el panel.
Haz peticiones GET a https://api.endpoint.pe/v1/… con la cabecera Authorization: Bearer TU_TOKEN.

terminal

curl 'https://api.endpoint.pe/v1/ruc/20131312955' \  -H 'Authorization: Bearer TU_TOKEN'

La respuesta llega en JSON y siempre con la misma estructura: success, message, data y meta.

respuesta.json

{  "success": true,  "message": "Consulta exitosa",  "data": {    "ruc": "20131312955",    "razon_social": "SUPERINTENDENCIA NACIONAL DE ADUANAS Y DE ADMINISTRACION TRIBUTARIA - SUNAT",    "nombre_comercial": null,    "tipo_contribuyente": "INSTITUCIONES PUBLICAS",    "estado": "ACTIVO",    "condicion": "HABIDO",    "fecha_inscripcion": "1993-05-04",    "fecha_inicio_actividades": "1988-06-09",    "direccion": "AV. GARCILASO DE LA VEGA NRO. 1472",    "direccion_completa": "AV. GARCILASO DE LA VEGA NRO. 1472, LIMA - LIMA - LIMA",    "departamento": "LIMA",    "provincia": "LIMA",    "distrito": "LIMA",    "ubigeo": "150101",    "ubigeo_reniec": "140101",    "es_agente_de_retencion": true,    "es_agente_de_percepcion": false,    "es_agente_de_percepcion_combustible": false,    "es_buen_contribuyente": false,    "cantidad_trabajadores": 12577,    "cantidad_establecimientos": 349,    "cantidad_representantes": 6  },  "meta": {    "fuente": "SUNAT",    "consultado_en": "2026-10-12T07:40:12Z",    "creditos_cobrados": 1,    "creditos_disponibles": 14621  }}

Qué puedes consultar

API	Endpoint	Fuente	Estado
Consulta RUC	GET /v1/ruc/{ruc}	SUNAT	Disponible
Consulta DNI	GET /v1/dni/{dni}	RENIEC	Disponible
Tipo de cambio	GET /v1/tipo-cambio	SUNAT	Disponible
Ubicación	GET /v1/ubigeo/{codigo}	INEI	Disponible
Consulta por razón social	GET /v1/empresas?q={texto}	SUNAT	Disponible
Establecimientos anexos	GET /v1/ruc/{ruc}/anexos	SUNAT	Disponible
Representantes legales	GET /v1/ruc/{ruc}/representantes	SUNAT	Disponible
Trabajadores	GET /v1/ruc/{ruc}/trabajadores	SUNAT	Disponible
Carnet de extranjería	GET /v1/ce/{numero}	Migraciones	Próximamente

Cada API tiene su página en la referencia, con los parámetros, un ejemplo en varios lenguajes y la descripción de cada campo.

Lo esencial

Base: https://api.endpoint.pe. Todas las rutas van bajo /v1 y usan el método GET.
Autenticación: token en la cabecera Authorization, esquema Bearer. Ver Autenticación.
Costo: una consulta con resultado descuenta 1 crédito; una sin resultado (404) no descuenta nada. Ver Créditos y planes.
Errores: success: false, un código estable en error y un mensaje en español en message. Ver Errores.
Formato: JSON en UTF-8, fechas AAAA-MM-DD, solo HTTPS.

Antes de integrar

Prueba cada API sin escribir código en el Playground del panel.
La "Consulta en vivo" de la portada es solo para probar: es pública, no usa token y tiene un tope de consultas por visitante. No la uses desde tu sistema; integra /v1.
Revisa las buenas prácticas antes de salir a producción: caché, reintentos y cuidado del token.