API de consulta RUC y tipo de cambio

Consulta RUC

GET https://zodipe.com/api/v1/ruc/{ruc}

curl https://zodipe.com/api/v1/ruc/20330791412 \
  -H "Authorization: Bearer TU_CLAVE"

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)

$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

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"
}

Tipo de cambio

GET https://zodipe.com/api/v1/tipo-cambio?fecha=AAAA-MM-DD. Sin fecha, el de hoy. Si ese día SUNAT no publicó (fin de semana o feriado), vale el último publicado.

curl "https://zodipe.com/api/v1/tipo-cambio?fecha=2026-09-28" \
  -H "Authorization: Bearer TU_CLAVE"

{
  "fecha": "2026-09-28",
  "fecha_publicacion": "2026-09-28",
  "compra": 3.416,
  "venta": 3.425,
  "moneda": "USD",
  "fuente": "SUNAT"
}

Errores y cupo

401

Falta la clave o fue revocada.

404

El RUC no está en el padrón de SUNAT (o no hay tipo de cambio para esa fecha).

422

El RUC no es válido (no gasta consulta) o la fecha no va como AAAA-MM-DD.

429

Usaste el cupo del mes o pasaste el límite por minuto de tu cuenta (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": "…"}.