Inicio rápido

Con tres pasos tienes tu primera consulta de RUC.

1. Consigue una API key

Regístrate y crea una key en tu cuenta. Empieza con sk_ y se muestra una sola vez: guárdala en un lugar seguro. El plan Free no pide tarjeta.

La key viaja en la cabecera Authorization, como Bearer:

Authorization: Bearer sk_tu_clave

2. Haz la consulta

Cambia 20100000008 por el RUC que quieras consultar (11 dígitos). Ese número es un ejemplo ficticio.

curl

curl https://consultaruc-api.karvesol.com/ruc/20100000008 \
  -H "Authorization: Bearer sk_tu_clave"

JavaScript

const res = await fetch('https://consultaruc-api.karvesol.com/ruc/20100000008', {
  headers: { Authorization: 'Bearer sk_tu_clave' },
});
if (!res.ok) throw new Error((await res.json()).error);
const empresa = await res.json();
console.log(empresa.razon_social);

Python

import requests

res = requests.get(
    "https://consultaruc-api.karvesol.com/ruc/20100000008",
    headers={"Authorization": "Bearer sk_tu_clave"},
    timeout=10,
)
res.raise_for_status()
print(res.json()["razon_social"])

3. Lee la respuesta

Si el RUC existe, la API responde 200 con un JSON como este (datos de ejemplo):

{
  "ruc": 20100000008,
  "razon_social": "EMPRESA DE EJEMPLO S.A.C.",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "direccion": "AV. EJEMPLO 123",
  "ubigeo": "150101",
  "distrito": "LIMA",
  "provincia": "LIMA",
  "departamento": "LIMA",
  "es_agente_retencion": false
}

Cada campo está explicado en la referencia de GET /ruc/{id}. Si algo falla, revisa errores y límites.