Documentación completa — API SII Chile

Referencia completa de API SII Chile de Webempresario, con acceso a más de 3.370.000 registros de empresas, en una sola página: autenticación, el endpoint, la respuesta, los códigos de error, y ejemplos de código en cURL, Python, PHP y JavaScript — todos expandidos, sin pestañas que ocultar.

Actualizado en 2026 · Reemplaza TU_API_KEY por tu clave personal, obtenida al registrarte.

Contenido

Autenticación

Todas las consultas requieren tu API Key personal en el header X-Api-Key. La obtienes al registrarte en el sitio (25 consultas gratis, sin tarjeta).

X-Api-Key: TU_API_KEY

Endpoint

GET /v1/{rut}

Consulta una empresa chilena por su RUT, con dígito verificador, separado por guión (ej: 93834000-5).

ParámetroTipoDescripción
rutstringRUT con DV, ej. 93834000-5
HeaderRequeridoDescripción
X-Api-KeySíTu API Key personal

Respuesta (200 OK)

{
  "success": true,
  "data": {
    "RUT": 93834000,
    "DV": "5",
    "TIPO": "PERSONA JURIDICA COMERCIAL",
    "RAZON_SOCIAL": "CENCOSUD S A",
    "FECHA_INICIO_VIG": "01-01-1993",
    "FECHA_TG_VIG": "",
    "actividades": [
      {
        "CODIGO_ACTIVIDAD": 471100,
        "DESC_ACTIVIDAD": "VENTA AL POR MENOR EN COMERCIOS DE ALIMENTOS, BEBIDAS O TABACO (SUPERMERCADOS E HIPERMERCADOS)",
        "FECHA_ACTECO": "01-01-1993",
        "AFECTA_IVA": "S"
      }
    ],
    "domicilios": [
      {
        "CALLE": "AV KENNEDY",
        "NUMERO": "9001",
        "COMUNA": "LAS CONDES",
        "REGION": "XIII REGION METROPOLITANA",
        "TIPO_DIRECCION": "DOMICILIO",
        "GEO": {
          "LAT": -33.3900718,
          "LON": -70.546518,
          "PRECISION": "exacta"
        }
      }
    ],
    "tamano": {
      "ANIO_COMERCIAL": 2024,
      "SEGMENTO": "GRANDE",
      "TRAMO_VENTAS": 13,
      "TRAMO_VENTAS_DESC": "Grande 4: más de 1.000.000 UF",
      "TRABAJADORES": 1676,
      "TRAMO_CAPITAL_POSITIVO": 10,
      "TRAMO_CAPITAL_NEGATIVO": null,
      "REGIMEN_TRIBUTARIO": "REGIMEN GENERAL SEMI INTEGRADO (14A)",
      "RENTA_PRESUNTA": false,
      "HISTORICO": [
        { "ANIO_COMERCIAL": 2020, "SEGMENTO": "GRANDE", "TRAMO_VENTAS": 13, "TRABAJADORES": 1349 },
        { "ANIO_COMERCIAL": 2021, "SEGMENTO": "GRANDE", "TRAMO_VENTAS": 13, "TRABAJADORES": 1476 },
        { "ANIO_COMERCIAL": 2022, "SEGMENTO": "GRANDE", "TRAMO_VENTAS": 13, "TRABAJADORES": 1762 },
        { "ANIO_COMERCIAL": 2023, "SEGMENTO": "GRANDE", "TRAMO_VENTAS": 13, "TRABAJADORES": 1766 },
        { "ANIO_COMERCIAL": 2024, "SEGMENTO": "GRANDE", "TRAMO_VENTAS": 13, "TRABAJADORES": 1676 }
      ]
    },
    "empresa_en_un_dia": {
      "ES_EMPRESA_EN_UN_DIA": false,
      "CONSTITUCION": null
    }
  }
}

FECHA_TG_VIG vacío significa que la empresa está vigente (sin término de giro). Si trae una fecha, la empresa cesó actividades en esa fecha. El campo GEO.PRECISION indica qué tan específica es la coordenada: exacta, calle o no_disponible.

Empresa en un día (empresa_en_un_dia)

Indica si la sociedad se constituyó en el Registro de Empresas y Sociedades ("Tu Empresa en un Día", Ley 20.659, desde 2013), según los datos del Ministerio de Economía.

ES_EMPRESA_EN_UN_DIA puede ser:

Ejemplo de una sociedad constituida en el Registro:

"empresa_en_un_dia": {
  "ES_EMPRESA_EN_UN_DIA": true,
  "CONSTITUCION": {
    "FECHA": "2025-01-01",
    "TIPO_SOCIEDAD": "SpA",
    "CAPITAL_INICIAL": 1500000
  }
}

Tamaño de la empresa (tamano)

Viene de la nómina anual de empresas que publica el SII (años comerciales 2020 a 2024). Los campos de primer nivel corresponden al año más reciente en que la empresa aparece (indicado en ANIO_COMERCIAL). Cubre a más de 1,2 millones de empresas; para los contribuyentes que el SII no clasificó como empresa en ninguno de esos años, tamano es null.

Las ventas son estimadas por el SII y las cifras son preliminares; sirven para segmentar y prospectar, no como dato contable exacto.

Búsqueda por nombre

GET /v1/buscar?q={nombre}

Busca empresas por su nombre o razón social y devuelve hasta 20 coincidencias con su RUT. Sirve cuando tienes el nombre de la empresa pero no su RUT; con el RUT elegido consultas después /v1/{rut} para el detalle completo. No distingue mayúsculas ni tildes, e ignora formas legales como S.A., SpA o Ltda.

ParámetroRequeridoDescripción
qSíNombre o parte de la razón social (mínimo 3 caracteres), ej. latam airlines
vigentesNo1 para excluir empresas con término de giro
comunaNoComuna de la casa matriz, para acotar nombres comunes, ej. Las Condes

Costo: cada búsqueda con resultados descuenta 1 consulta de tu saldo. Si no encuentra nada, no se cobra. Las búsquedas demasiado generales (por ejemplo solo "comercial") responden 400 sin costo.

curl --request GET \
  --url 'https://api-sii-chile.webempresario.com/v1/buscar?q=latam%20airlines' \
  --header 'X-Api-Key: TU_API_KEY'
{
  "success": true,
  "query": "latam airlines",
  "total": 4,
  "resultados": [
    {
      "RUT": 89862200,
      "DV": "2",
      "RAZON_SOCIAL": "LATAM AIRLINES GROUP S.A.",
      "VIGENTE": true,
      "COMUNA": "PUDAHUEL"
    },
    {
      "RUT": 59103830,
      "DV": "3",
      "RAZON_SOCIAL": "LATAM AIRLINES PERU S.A. SUCURSAL EN CHILE",
      "VIGENTE": true,
      "COMUNA": "LAS CONDES"
    },
    {
      "RUT": 59118050,
      "DV": "9",
      "RAZON_SOCIAL": "LATAM AIRLINES ECUADOR S.A.",
      "VIGENTE": true,
      "COMUNA": "LAS CONDES"
    },
    {
      "RUT": 77601485,
      "DV": "0",
      "RAZON_SOCIAL": "TRAVEL CHARTERS AIRLINES LATAM BY PFT SPA",
      "VIGENTE": true,
      "COMUNA": "PROVIDENCIA"
    }
  ]
}

Códigos de error

CódigoSignificado
400Formato de RUT inválido
401API Key faltante o inválida
404RUT no encontrado en el padrón del SII
429Límite de consultas por minuto excedido

Los errores 400, 401, 404 y 429 nunca descuentan saldo — solo las consultas exitosas consumen créditos.

Ejemplo en cURL

# Realiza una petición GET a la API
curl --request GET \
  --url 'https://api-sii-chile.webempresario.com/v1/93834000-5' \
  --header 'X-Api-Key: TU_API_KEY'

Ejemplo en Python

# Realiza una petición GET a la API usando requests
import requests

api_key = 'TU_API_KEY'
url = 'https://api-sii-chile.webempresario.com/v1/93834000-5'

response = requests.get(url, headers={'X-Api-Key': api_key})
print(response.json())

Ejemplo en PHP

También disponible como paquete Composer instalable: composer require webempresario/api-sii-chile (ver en GitHub).

$apiKey = 'TU_API_KEY';
$rut = '93834000-5';
$url = 'https://api-sii-chile.webempresario.com/v1/' . $rut;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Api-Key: ' . $apiKey]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));

Ejemplo en JavaScript

// Realiza una petición GET a la API usando Fetch
const apiKey = 'TU_API_KEY';
const url = 'https://api-sii-chile.webempresario.com/v1/93834000-5';

fetch(url, { headers: { 'X-Api-Key': apiKey } })
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Usar desde Claude AI / ChatGPT

También puedes conectar la API directo a Claude AI o ChatGPT como un servidor MCP y consultarla conversando, sin escribir código. Agrega un conector personalizado con esta URL (reemplaza TU_API_KEY):

⚠️ Esta URL no se abre en el navegador — se pega dentro del cuadro "Agregar conector personalizado" de Claude AI o ChatGPT, no en la barra de direcciones.
// Pégala en Claude AI / ChatGPT, no en el navegador:
https://mcp1.webempresario.com/mcp?key=TU_API_KEY

En Claude AI / Claude Desktop: Configuración → Conectores → Agregar conector personalizado → pega la URL de arriba.

En ChatGPT: chatgpt.com → Complementos → Agregar → Agregar servidor MCP personalizado → dale un nombre y pega la URL de arriba.

Luego solo pregunta, por ejemplo:

// Le preguntas directo a Claude AI o ChatGPT:
"¿A quién pertenece el RUT 93.834.000-5? ¿Desde cuándo existe y dónde está?"

Más detalle paso a paso en la guía completa.

Preguntas frecuentes

¿Cómo me registro?

Entra a api-sii-chile.webempresario.com y regístrate con tu cuenta de Google (sin crear contraseña) o con un formulario de email y contraseña. En ambos casos recibes 25 consultas gratis y tu API Key queda lista de inmediato.

¿Qué datos entrega la API?

Razón social, RUT y dígito verificador, tipo y subtipo de sociedad, fecha de inicio de actividades y fecha de término de giro (si aplica), todas las actividades económicas con su código, descripción, fecha y si son afectas a IVA, y todos los domicilios y sucursales con su fecha de vigencia y coordenadas de latitud/longitud cuando están disponibles. Además, para más de 1,2 millones de empresas, su tamaño según el SII (segmento micro, pequeña, mediana o grande, tramo de ventas, número de trabajadores y régimen tributario) y su evolución desde 2020.

¿Cada cuánto se actualizan los datos?

Sincronizamos mensualmente con los registros públicos del SII.

¿Cómo se paga?

Con Webpay Plus: tarjetas de crédito, débito y prepago. Es un pago único, sin suscripción ni cobros automáticos.

¿Los créditos vencen?

No. El saldo no vence y es acumulable: si compras otro paquete, se suman.

¿Qué pasa si el RUT no existe o está mal escrito?

No se descuenta saldo. Solo las consultas exitosas consumen créditos.

¿Puedo probar antes de comprar?

Sí, al registrarte recibes 25 consultas gratis para probar tu integración con tu propia API key.

¿Puedo usar la API directo desde Claude AI o ChatGPT?

Sí. Agrega un conector personalizado con la URL https://mcp1.webempresario.com/mcp?key=TU_API_KEY en Claude AI, Claude Desktop o ChatGPT, y luego pregunta directamente, por ejemplo "¿A quién pertenece el RUT 93.834.000-5?". Ve la sección Usar desde Claude AI / ChatGPT para el detalle.

Consulta empresas por RUT — 25 consultas gratis

Pago con Webpay · Emitimos factura electrónica · Prepago sin vencimiento