APIs para tu sistema

API de consulta RUC

Los datos oficiales de SUNAT en tu sistema, al instante. 300 consultas gratis al mes; pruébala aquí sin registrarte.

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.

300consultas gratis cada mes
Empezar gratis
  • 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.

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?

Pide ayuda por WhatsApp

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.