endpoint.pe

Primeros pasos

Crea tu cuenta, genera una API key y haz tu primera consulta en menos de cinco minutos.

1. Crea tu cuenta

Regístrate con tu correo. Te enviaremos un enlace de verificación: hace falta verificar el correo para crear API keys. El plan gratis incluye 150 créditos al mes que se renuevan solos, sin tarjeta.

2. Genera una API key

En el panel, entra a API keys y pulsa "Crear API key". Ponle un nombre que identifique al sistema que la va a usar, por ejemplo "Facturación" o "CRM".

Las claves tienen la forma ep_live_ seguida de 40 caracteres. Puedes tener hasta 10 activas a la vez.

3. Haz tu primera consulta

Reemplaza TU_TOKEN por tu clave:

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

Respuesta:

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  }}

Lo que necesitas está en data. meta te dice de dónde salió el dato, cuándo se consultó, cuánto costó y cuántos créditos te quedan.

4. Pruébala sin escribir código

El Playground del panel hace la misma petición desde el navegador: eliges la API, escribes el dato y ves la respuesta, las cabeceras y el curl equivalente para copiarlo a tu código.

Siguientes pasos

  • Autenticación: cómo enviar el token y qué pasa si falla.
  • Formato de respuesta: el envoltorio y las cabeceras de créditos.
  • Errores: códigos HTTP y cómo manejarlos.
  • La referencia de cada API, en el menú de la izquierda.