Zodipe
ContáctanosAyudaIngresar

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. Una clave y un plan sirven para todas nuestras APIs.

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.

Pago anual en soles. El cupo es de consultas al mes, se renueva cada mes y sirve para todas tus APIs con la misma clave.

Se paga por Yape o transferencia y te lo activamos al confirmar 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»).
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": "…"}.

Con la misma clave también tienes: API de consulta de tipo de cambio.

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?

Por Yape o transferencia. Nos escribes por WhatsApp desde tu cuenta, pagas y te lo activamos. 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.

WhatsApp