endpoint.pe

Consulta RUC

Ficha resumida de un contribuyente a partir de su RUC, con datos del padrón de SUNAT: razón social, estado, condición, domicilio fiscal, padrones y cantidad de trabajadores, locales y representantes.

GEThttps://api.endpoint.pe/v1/ruc/{ruc}
Fuente:
SUNAT
Costo:
1 crédito por consulta con resultado
Estado:
Disponible
Probar en el playground Página de la API

Devuelve la ficha resumida de un contribuyente tal como figura en el padrón de SUNAT: identificación, estado y condición, domicilio fiscal con su ubigeo, si pertenece a los padrones de agentes de retención, percepción y buenos contribuyentes, y tres cantidades que resumen su tamaño: trabajadores del último periodo declarado, locales anexos y representantes legales. Es la consulta para validar a un cliente o proveedor antes de facturar.

Parámetros

NombreDóndeFormato
rucRuta11 dígitos. Empieza en 10, 15, 16, 17 o 20 y el último dígito es el verificador (módulo 11). Si no cumple, la API responde 422 sin consultar la fuente.

Ejemplo

terminal
curl 'https://api.endpoint.pe/v1/ruc/20131312955' \  -H 'Authorization: Bearer TU_TOKEN'
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  }}

Campos de data

CampoDescripción
rucNúmero de RUC consultado.
razon_socialNombre o razón social registrada.
nombre_comercialNombre comercial declarado, si lo tiene.
tipo_contribuyenteSociedad anónima cerrada, persona natural con negocio, etc.
estadoEstado del contribuyente: ACTIVO, BAJA, SUSPENSIÓN TEMPORAL…
condicionCondición de domicilio: HABIDO o NO HABIDO.
fecha_inscripcionFecha de inscripción en el RUC (AAAA-MM-DD).
fecha_inicio_actividadesFecha de inicio de actividades (AAAA-MM-DD).
direccionDirección del domicilio fiscal.
direccion_completaDirección seguida de departamento, provincia y distrito.
departamento, provincia, distritoUbicación del domicilio fiscal.
ubigeo, ubigeo_reniecCódigo de ubigeo SUNAT (INEI) y su equivalente RENIEC.
es_agente_de_retenciontrue si está en el padrón de agentes de retención de IGV.
es_agente_de_percepciontrue si es agente de percepción de IGV (venta interna).
es_agente_de_percepcion_combustibletrue si es agente de percepción de IGV por combustible.
es_buen_contribuyentetrue si está en el régimen de buenos contribuyentes.
cantidad_trabajadoresTrabajadores declarados en el último periodo disponible.
cantidad_establecimientosLocales anexos registrados.
cantidad_representantesRepresentantes legales registrados.

Detalles

  • estado (ACTIVO, bajas y suspensiones) y condicion (HABIDO o NO HABIDO) llegan tal como los publica SUNAT. Qué implica cada uno: activo y habido, no habido y RUC dado de baja o suspendido.
  • nombre_comercial, tipo_contribuyente, las dos fechas y los cuatro campos es_* salen de la ficha completa de SUNAT. Cuando el RUC no tiene esa ficha (ocurre con muchas personas naturales) llegan en null: significa "sin información", no "no".
  • cantidad_trabajadores es la cifra del último periodo declarado. El detalle mes a mes está en Trabajadores; los locales, en Establecimientos anexos; las personas, en Representantes legales.
  • ubigeo es el código INEI que usa SUNAT y ubigeo_reniec su equivalente en la codificación de RENIEC. Para convertirlo en nombres o listar distritos usa Ubigeo.
  • Si solo tienes el nombre de la empresa, búscala primero con Consulta por razón social.
  • Cómo está compuesto el número y qué diferencia hay entre un RUC 10 y un RUC 20: Qué es el RUC y RUC 10 y RUC 20.

Errores

HTTPerrorCuándo
404no_encontradoEl RUC no está inscrito en el padrón. No descuenta créditos.
422validaciondetalles.ruc: "RUC inválido: deben ser 11 dígitos con dígito verificador correcto."

Los demás códigos (401, 402, 403, 502) son comunes a todas las APIs: Errores.

Relacionados