Consulta RUC

Obtén información completa de un contribuyente a partir de su número de RUC.

Endpoint

GET /api/contribuyentes/{ruc}

Parámetros

Parámetro	Tipo	Ubicación	Requerido	Descripción
`ruc`	string	path	Sí	Número de RUC (11 dígitos)

Headers

Header	Requerido	Descripción
`X-API-KEY`	Sí	Tu API Key de KipuDev

Ejemplo de solicitud

curl -X GET "https://api.kipudev.com/api/contribuyentes/20131312955" \
  -H "X-API-KEY: tu-api-key"

Respuesta exitosa

{
  "ruc": "20131312955",
  "razonSocial": "SUNAT - SUPERINTENDENCIA NACIONAL DE ADUANAS Y DE ADMINISTRACION TRIBUTARIA",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "direccion": "AV. GARCILASO DE LA VEGA NRO. 1472 LIMA - LIMA - LIMA",
  "ubigeo": "150101",
  "departamento": "LIMA",
  "provincia": "LIMA",
  "distrito": "LIMA",
  "tipo": "GOBIERNO CENTRAL",
  "actividadEconomica": "ADMINISTRACION PUBLICA EN GENERAL",
  "fechaInscripcion": "1993-03-01",
  "fechaInicioActividades": "1993-03-01"
}

Campos de respuesta

Campo	Tipo	Descripción
`ruc`	string	Número de RUC
`razonSocial`	string	Nombre o razón social
`estado`	string	Estado del contribuyente (ACTIVO, BAJA, SUSPENSIÓN)
`condicion`	string	Condición domiciliaria (HABIDO, NO HABIDO, NO HALLADO)
`direccion`	string	Dirección fiscal completa
`ubigeo`	string	Código de ubigeo (6 dígitos)
`departamento`	string	Departamento
`provincia`	string	Provincia
`distrito`	string	Distrito
`tipo`	string	Tipo de contribuyente
`actividadEconomica`	string	Actividad económica principal
`fechaInscripcion`	string	Fecha de inscripción en SUNAT
`fechaInicioActividades`	string	Fecha de inicio de actividades

Estados del contribuyente

Estado	Descripción
`ACTIVO`	El contribuyente está activo y habilitado
`BAJA PROVISIONAL`	Baja temporal
`BAJA DEFINITIVA`	Dado de baja permanentemente
`SUSPENSIÓN TEMPORAL`	Actividades suspendidas temporalmente

Condición domiciliaria

Condición	Descripción
`HABIDO`	Domicilio fiscal verificado
`NO HABIDO`	No se pudo verificar el domicilio
`NO HALLADO`	No se encontró al contribuyente
`PENDIENTE`	Verificación pendiente

Errores

Código	Error	Descripción
400	`RUC inválido`	El RUC debe tener 11 dígitos numéricos
404	`Contribuyente no encontrado`	No existe un contribuyente con ese RUC

{
  "error": "Contribuyente no encontrado",
  "code": "NOT_FOUND"
}

Los datos provienen de la base de datos del padrón reducido de SUNAT, actualizada diariamente.

Rate Limiting

Este endpoint consume 1 consulta de tu cuota diaria.

Headers de respuesta incluidos:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 2025-12-20T00:00:00Z