Ir al contenido

Beta privada · apertura 23 de diciembre

Consulta un RUC

GET /v1/ruc/{ruc}

Razón social, estado, condición y dirección desde el padrón reducido de SUNAT. Gratis hasta el cupo mensual de tu plan; luego se descuenta del saldo.

Dato Valor
Permiso datos:leer
Cobro Lectura medida: cuenta contra tu cupo gratis o tu saldo, y puede dar 402.
Idempotency-Key No aplica
Herramienta MCP ruc_consultar (Próximamente)
Nombre En Requerido Tipo Descripción
ruc path Sí string RUC del emisor o contribuyente.
X-Request-Id header No string Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl "https://api-sandbox.opennexum.com/v1/ruc/20000000001" \
-H "Authorization: Bearer onx_test_…"

Datos del contribuyente.

Campo Tipo Requerido Descripción
ruc string Sí RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT).
razon_social string Sí
estado string | null Sí Estado en SUNAT, por ejemplo ACTIVO o BAJA DE OFICIO; null si el padrón no lo trae.
condicion string | null Sí Condición de domicilio, por ejemplo HABIDO o NO HABIDO; null si el padrón no la trae.
ubigeo string | null Sí
direccion string | null Sí
departamento string | null Sí Del ubigeo, con la tabla del INEI; null si el ubigeo no está en ella.
provincia string | null Sí
distrito string | null Sí
padron_actualizado_al string (date) Sí Fecha del padrón reducido de SUNAT que respondió.

Cada código tiene su explicación en Errores.