endpoint.pe

Empresas · Fuente: SUNAT

API de consulta RUC

Consulta cualquier RUC y recibe la ficha resumida de SUNAT: razón social, estado, condición, dirección fiscal con ubigeo, padrones y la cantidad de trabajadores, locales y representantes. Ideal para validar clientes y proveedores antes de facturar.

Empieza gratisVer precios

Cómo consultarla

Haz una petición GET con tu token en la cabecera Authorization y recibe la respuesta en JSON. Elige tu lenguaje, copia el código y reemplaza TU_TOKEN por el de tu cuenta.

GET https://api.endpoint.pe/v1/ruc/20131312955Obtener mi token gratis
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é datos devuelve

Fuente oficial: SUNAT. Cada respuesta trae siempre los mismos campos, en JSON.
ruc

Número de RUC consultado.

razon_social

Nombre o razón social registrada.

nombre_comercial

Nombre comercial declarado, si lo tiene.

tipo_contribuyente

Sociedad anónima cerrada, persona natural con negocio, etc.

estado

Estado del contribuyente: ACTIVO, BAJA, SUSPENSIÓN TEMPORAL…

condicion

Condición de domicilio: HABIDO o NO HABIDO.

fecha_inscripcion

Fecha de inscripción en el RUC (AAAA-MM-DD).

fecha_inicio_actividades

Fecha de inicio de actividades (AAAA-MM-DD).

direccion

Dirección del domicilio fiscal.

direccion_completa

Dirección seguida de departamento, provincia y distrito.

departamento, provincia, distrito

Ubicación del domicilio fiscal.

ubigeo, ubigeo_reniec

Código de ubigeo SUNAT (INEI) y su equivalente RENIEC.

es_agente_de_retencion

true si está en el padrón de agentes de retención de IGV.

es_agente_de_percepcion

true si es agente de percepción de IGV (venta interna).

es_agente_de_percepcion_combustible

true si es agente de percepción de IGV por combustible.

es_buen_contribuyente

true si está en el régimen de buenos contribuyentes.

cantidad_trabajadores

Trabajadores declarados en el último periodo disponible.

cantidad_establecimientos

Locales anexos registrados.

cantidad_representantes

Representantes legales registrados.

Qué es la consulta de RUC por API y para qué sirve

El RUC (Registro Único de Contribuyentes) es el número de 11 dígitos con el que SUNAT identifica a cada empresa y persona natural con negocio en el Perú. Antes de facturar, pagar o firmar con un cliente o proveedor conviene saber si ese RUC existe, si está activo y si el contribuyente está habido en su domicilio fiscal.

La API de consulta RUC de endpoint.pe responde esas preguntas en una sola llamada HTTP: envías el número y recibes, en JSON, la razón social, el nombre comercial, el tipo de contribuyente, el estado y la condición, la dirección fiscal con su departamento, provincia y distrito, el ubigeo (en código SUNAT y RENIEC), las fechas de inscripción e inicio de actividades, si figura en los padrones de agentes de retención, agentes de percepción o buenos contribuyentes, y la cantidad de trabajadores, locales anexos y representantes legales registrados.

Los datos provienen del padrón público de SUNAT y reflejan su última actualización. Para los detalles de locales, representantes y trabajadores existen endpoints propios, y la búsqueda por nombre está en la API de razón social.

Para qué se usa la API de consulta RUC

Validar clientes antes de facturar

Comprueba que el RUC existe, está ACTIVO y HABIDO, y completa la razón social y la dirección fiscal sin errores de tipeo.

Evaluar proveedores

Revisa el estado, la antigüedad, los padrones de retención y percepción y el tamaño de la empresa antes de aprobar una compra.

Autocompletar formularios

Tu usuario escribe el RUC y tu sistema rellena el resto: menos campos, menos errores y registros limpios desde el inicio.

Otras APIs que te pueden servir

Ver API

Consulta por razón social

Encuentra el RUC de una empresa a partir de su nombre.

Ver API

Establecimientos anexos

Locales y sucursales registrados de un RUC.

Ver API

Representantes legales

Nombre, documento, cargo y fecha de nombramiento.

Preguntas frecuentes

Preguntas sobre la API de consulta RUC

Si tu duda no está aquí, escríbenos y te responde una persona del equipo.

Our Blog

Guías relacionadas en el blog

Cómo funcionan estos datos en el Perú y cómo integrarlos en tu sistema.

Qué es el RUC y cómo está compuesto: los 11 dígitos explicados
SUNAT

Qué es el RUC y cómo está compuesto: los 11 dígitos explicados

El RUC es el número con el que SUNAT identifica a cada contribuyente. Te explicamos qué es el RUC, qué significan sus 11 dígitos y qué datos públicos revela.

Equipo endpoint.pe•02 mar. 2026
Qué significan ACTIVO y HABIDO en SUNAT: estado y condición del RUC
SUNAT

Qué significan ACTIVO y HABIDO en SUNAT: estado y condición del RUC

ACTIVO y HABIDO son dos datos distintos del RUC: el estado del contribuyente y la condición del domicilio. Qué significa cada valor y cómo afecta al facturar.

Equipo endpoint.pe•12 mar. 2026
Cómo consultar un RUC en SUNAT paso a paso (y cuándo usar una API)
SUNAT

Cómo consultar un RUC en SUNAT paso a paso (y cuándo usar una API)

Guía para consultar un RUC en SUNAT por número, por nombre o por DNI: qué datos muestra la consulta pública, sus límites y cuándo conviene pasar a una API.

Equipo endpoint.pe•17 mar. 2026
Cómo validar un RUC con el dígito verificador (JavaScript y Python)
SUNAT

Cómo validar un RUC con el dígito verificador (JavaScript y Python)

Aprende a validar un RUC antes de consultarlo: el algoritmo del dígito verificador paso a paso, con código en JavaScript y Python, y por qué no basta con eso.

Equipo endpoint.pe•07 mar. 2026

Deja de copiar datos a mano. Automatízalo hoy mismo

Crea tu cuenta, copia tu token y empieza hoy con 150 consultas gratis al mes.

Empieza gratisHablar con ventas