Referencia de la API

Generada desde la especificación OpenAPI 3.1, la misma que usa nuestro servidor.

Descárgala para Postman, Insomnia o un generador de clientes: openapi.json.

GET /v1/ruc/{ruc}

Consultar un RUC

Cobra 1 consulta sólo si el RUC existe en el padrón.

Parámetro	En	Formato	Ejemplo
`ruc` *	ruta	`^\d{11}$`	20131312955

Respuesta	Descripción
`200`	Encontrado
`400`	`ruc_invalido`, `lote_invalido`, `ubigeo_invalido`
`401`	`clave_faltante`, `clave_invalida`
`403`	`lote_no_permitido`, `ip_no_permitida`, `cuenta_suspendida`
`404`	`no_encontrado`, `ruta_no_existe`
`429`	`limite_por_segundo`, `limite_por_minuto`, `cuota_agotada`, `demasiados_intentos`

Requiere Authorization: Bearer.

Consultar varios RUC

Planes Pro (50) y Empresa (100). Cobra una consulta por cada RUC encontrado.

Respuesta	Descripción
`200`	Resultados en el mismo orden
`400`	`ruc_invalido`, `lote_invalido`, `ubigeo_invalido`
`401`	`clave_faltante`, `clave_invalida`
`403`	`lote_no_permitido`, `ip_no_permitida`, `cuenta_suspendida`
`429`	`limite_por_segundo`, `limite_por_minuto`, `cuota_agotada`, `demasiados_intentos`

Requiere Authorization: Bearer.

Traducir un ubigeo

No gasta consultas.

Parámetro	En	Formato	Ejemplo
`codigo` *	ruta	`^\d{6}$`	150101

Respuesta	Descripción
`200`	Lugar
`400`	`ruc_invalido`, `lote_invalido`, `ubigeo_invalido`
`401`	`clave_faltante`, `clave_invalida`
`404`	`no_encontrado`, `ruta_no_existe`
`429`	`limite_por_segundo`, `limite_por_minuto`, `cuota_agotada`, `demasiados_intentos`

Requiere Authorization: Bearer.

Tu consumo

Plan, periodo, consultas usadas y créditos. No gasta consultas.

Respuesta	Descripción
`200`	Consumo
`401`	`clave_faltante`, `clave_invalida`
`429`	`limite_por_segundo`, `limite_por_minuto`, `cuota_agotada`, `demasiados_intentos`

Requiere Authorization: Bearer.

Estado del padrón

Público, sin clave. Fecha del padrón y número de RUC.

Respuesta	Descripción
`200`	Estado

Sin clave.