apirut / Documentación

Documentación del API

API REST sobre HTTPS con respuestas JSON. Base: https://api.apirut.cl/v1

Esta referencia usa ejemplos con datos de demostración. Para ejecutar llamadas reales con tu propio token, usa el playground de tu panel.

Autenticación

Toda llamada lleva tu token en la cabecera Authorization. El token se genera desde el panel y se muestra una única vez: guárdalo en un gestor de secretos.

curl https://api.apirut.cl/v1/contribuyentes/77647664-1 \
  -H "Authorization: Bearer ••••••••••••"

Límites y cuotas

Cada plan define un tope mensual y uno por minuto. Toda respuesta incluye tu estado de cuota en cabeceras:

Consultar un contribuyente

La ficha completa de un RUT: identificación, constitución, ubicación y situación tributaria. El RUT acepta puntos y guion; un dígito verificador incorrecto se rechaza al instante con 422.

{
  "rut": "77647664-1",
  "identificacion": {
    "razon_social": "SOCIEDAD DE GESTION AMBIENTAL ECO-URBANO LIMITADA",
    "razon_social_constitucion": "SOCIEDAD DE GESTION AMBIENTAL ECO-URBANO SPA",
    "nombre_divulgable": true,
    "tipo_sociedad": { "codigo": "SpA" },
    "tipo_sociedad_vigente": { "codigo": "SRL" }
  },
  "constitucion": {
    "fecha_actuacion": "2022-10-04",
    "anio": 2022,
    "capital": 1000000.00
  },
  "ubicacion": {
    "tributaria": {
      "comuna": { "nombre": "Providencia" },
      "region": { "codigo": 13, "nombre_corto": "Metropolitana" }
    }
  },
  "situacion_tributaria": {
    "inicio_actividades": true,
    "fecha_inicio_actividades": "2022-10-13",
    "empresa_menor_tamano": true,
    "obligado_facturacion_electronica": false,
    "giros": [
      { "codigo": "960909", "afecto_iva": false }
    ],
    "timbrajes": [
      { "codigo": "0033", "descripcion": "Factura Electrónica", "anio": 2023 }
    ]
  }
}

Las claves existen siempre: si tu plan no incluye una sección (por ejemplo situacion_tributaria en el plan Gratis), llega en null y X-Plan-Secciones indica qué entrega tu plan. Cuando el nombre de una persona natural está reservado, nombre_divulgable viene en false — distinto de "no encontrado".

Buscar sociedades

Búsqueda sobre todo el historial desde 2013, con paginación por cursor: cada página incluye el cursor de la siguiente.

curl "https://api.apirut.cl/v1/sociedades?razon_social=eco+urbano®ion=13&anio=2022" \
  -H "Authorization: Bearer ••••••••••••"

Consultar tu consumo

El consumo del mes de tu token, con su límite y fecha de reinicio. Consultarlo no gasta cuota.

{
  "plan": "pro",
  "periodo": "2026-08",
  "consultas": { "usadas": 153, "limite": 1000, "restantes": 847 },
  "reinicia_en": "2026-09-01T00:00:00Z"
}

Errores

Formato uniforme: { "error": "identificador_estable", "detalle": "Texto legible." }. El campo error es contrato — puedes compararlo en tu código, no cambia.

Qué entrega cada plan