API de consulta RUC
Datos oficiales, al instante.
Te registras gratis, la activas en tu cuenta y empiezas a consultar en minutos. Pagas solo si necesitas más consultas.
Datos oficiales de SUNAT
El padrón de RUC que publica SUNAT, actualizado cada día: razón social, estado, condición y dirección.
Respuesta en milisegundos
Los datos están en nuestro servidor, no dependemos de que la web de SUNAT responda.
Con ubigeo y distrito
La dirección armada como la escribe SUNAT, con departamento, provincia y distrito.
Tus claves, bajo control
Crea una por sistema, mira cuándo se usó cada una y revócala al instante.
Fácil de integrar
Una petición con tu clave y respuestas en JSON. Ejemplos listos en cURL, JavaScript y PHP.
Soporte en español
Te ayudamos por WhatsApp con la integración, sin tickets ni esperas.
Planes y precios
Empieza gratis y paga solo si necesitas más.
Precios de la API de consulta RUC, que se paga aparte de las demás. Pago anual en soles; el cupo es de consultas al mes y se renueva cada mes.
- 300consultas al mesGratisEmpezar gratis
- 1 000consultas al mesS/ 9 al añoPedir este plan
- 10 000consultas al mesS/ 45 al añoPedir este plan
- 30 000consultas al mesS/ 90 al añoPedir este plan
- 50 000consultas al mesS/ 135 al añoPedir este plan
- 100 000consultas al mesS/ 225 al añoPedir este plan
- 200 000consultas al mesS/ 450 al añoPedir este plan
- 300 000consultas al mesS/ 675 al añoPedir este plan
Se paga en línea desde tu cuenta (tarjeta, Yape, billeteras o PagoEfectivo) y queda activo al aprobarse el pago. Para empezar no necesitas tarjeta: el plan gratis no vence.
Documentación
Tu primera consulta en un minuto.
Actívala en tu cuenta (un clic), crea tu clave y envíala en la cabecera Authorization: Bearer TU_CLAVE (o en X-Api-Key).
Ejemplos
cURL
curl https://zodipe.com/api/v1/ruc/20330791412 \
-H "Authorization: Bearer TU_CLAVE"JavaScript
const respuesta = await fetch('https://zodipe.com/api/v1/ruc/20330791412', {
headers: { Authorization: 'Bearer TU_CLAVE' },
})
const empresa = await respuesta.json()
console.log(empresa.razon_social)PHP
$ch = curl_init('https://zodipe.com/api/v1/ruc/20330791412');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer TU_CLAVE'],
]);
$empresa = json_decode(curl_exec($ch), true);
echo $empresa['razon_social'];Respuesta
GET https://zodipe.com/api/v1/ruc/{ruc}. Los campos vacíos llegan como null; actualizado es la fecha del padrón de SUNAT del que sale el dato.
{
"ruc": "20330791412",
"razon_social": "ORYGEN PERU S.A.A.",
"estado": "ACTIVO",
"condicion": "HABIDO",
"direccion": "PASEO DEL BOSQUE NRO. 500 URB. CHACARILLA DEL ESTANQUE",
"via_tipo": null,
"via_nombre": "PASEO DEL BOSQUE",
"numero": "500",
"interior": null,
"manzana": null,
"lote": null,
"dpto": null,
"kilometro": null,
"zona_tipo": "URB.",
"zona_nombre": "CHACARILLA DEL ESTANQUE",
"ubigeo": "150130",
"departamento": "LIMA",
"provincia": "LIMA",
"distrito": "SAN BORJA",
"actualizado": "2026-09-28"
}Errores y cupo
- 401
- Falta la clave o fue revocada.
- 403
- La API de consulta RUC no está activada en tu cuenta (se activa gratis en «Más servicios») o la clave es de otra API.
- 404
- El RUC no está en el padrón de SUNAT.
- 422
- El RUC no es válido (no gasta consulta).
- 429
- Usaste el cupo del mes o pasaste el límite por minuto (30 en el plan gratis, 120 en los de pago).
Cada respuesta trae en sus cabeceras X-Cupo-Mensual y X-Cupo-Restante. Los errores llegan como {"error": "…"}.
También te puede servir: API de consulta de tipo de cambio.
Para tu empresa
Lo demás que tu empresa necesita, en la misma cuenta.
Con la cuenta de tus APIs también compras tu correo y tu hosting, y lo manejas todo desde el mismo panel.
Correo con el dominio de tu empresa
ventas@tuempresa.com en lugar de un Gmail: 10 cuentas, SSL y soporte en español desde USD 49 al año. Pagas en línea y se activa solo.
Hosting para tu sistema o tu web
PHP, bases de datos, SSL y copias diarias en servidores con soporte en español, para el sistema que consulta la API o la web de tu empresa.
Preguntas frecuentes
Lo que necesitas saber antes de empezar.
¿De verdad es gratis?
Sí. Creas tu cuenta, activas la API y tienes 300 consultas al mes para siempre, sin tarjeta. Si necesitas más, eliges un plan anual.
¿De dónde salen los datos?
Del padrón reducido de RUC que SUNAT publica cada día. Lo actualizamos todas las madrugadas en nuestro servidor.
¿Consultan DNI?
Por ahora no: el DNI es un dato personal que RENIEC no publica. Los RUC de personas naturales con negocio (los que empiezan por 10) sí aparecen con su nombre, como los publica SUNAT.
¿Cómo pago un plan?
En línea, desde tu cuenta: en la sección de la API eliges el plan y lo pagas con tarjeta, Yape, billeteras o PagoEfectivo. Queda activo en cuanto se aprueba el pago. No recibimos depósitos ni transferencias a cuentas. Por ahora no emitimos factura.
¿Qué pasa si me paso del cupo?
La API responde 429 hasta que empiece el mes siguiente o mejores tu plan. No te cobramos nada extra por sorpresa.
Hablemos
¿Necesitas ayuda para integrarla?
Te ayudamos a conectarla a tu sistema de facturación, tu tienda o tu ERP. Y si además necesitas hosting, dominio o una web, lo tenemos todo en un solo lugar.