Developers

REST · ¿Quién está detrás?

Sociedades y grupos

En qué sociedades participa un RUT, quiénes participan en él y el grupo que se arma siguiendo esas participaciones. Los ejemplos de abajo son la petición y la respuesta real de cada operación, no una aproximación.

Lo que descuenta cada operación es lo mismo por REST, SOAP, GraphQL y MCP —pagas por el dato, no por el protocolo—; la tabla completa está en Empezar.

GET /v1/rut/{rut}/sociedades

Sociedades y socios

En qué sociedades participa el RUT y con cuánto, qué personas jurídicas participan en él, y cuánto suman sus personas naturales — sin nombrarlas: el SII publica el porcentaje agregado, no quiénes son. Las listas vacías también son respuesta: «no tiene» es información.

Lo que devuelve

CampoTipoQué es
rutstringEl RUT que consultaste, normalizado: con guion y sin puntos.
rut_formateadostringEl mismo RUT listo para mostrar: con puntos y guion.
es_empresabooleantrue si el RUT es de una empresa y false si es de una persona. Sirve para decidir qué pedirle a quien se está registrando.
participacionesarrayLas sociedades en que ESTE RUT participa. Vacía si no participa en ninguna.
sociosarrayLas personas jurídicas que participan en él. Vacía si ninguna lo hace — una sociedad de personas naturales, o una empresa del Estado.
personas_naturalesobjectEl agregado de sus socios personas naturales: solo el porcentaje, sin nombres ni RUT, porque es lo único que el SII publica de ellos. null cuando el RUT no tiene socios personas naturales.
fuentestringDe dónde salen los datos de esta respuesta, en texto listo para citar («Composición de sociedades, SII»). Es constante para esta llamada: guárdalo una vez y no lo parsees.
publicadostringDe cuándo es la composición de sociedades que respondió. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC. Es otro archivo que el padrón: otra fecha que padron_publicado.
consultado_enstringCuándo se respondió esta llamada. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC.

Dentro de participaciones

CampoTipoQué es
rutstringEl RUT del otro extremo, normalizado. Pide su ficha con él.
rut_formateadostringEl mismo RUT listo para mostrar.
razon_socialstringSu nombre legal según el padrón. Cadena vacía si no está en él.
participacionnumberEl porcentaje de participación, tal como el SII lo publica: hasta diez decimales, y puede pasar de 100 — no supongas que los socios suman 100. null cuando el SII no lo informa: una de cada dieciséis participaciones.

Dentro de socios

CampoTipoQué es
rutstringEl RUT del otro extremo, normalizado. Pide su ficha con él.
rut_formateadostringEl mismo RUT listo para mostrar.
razon_socialstringSu nombre legal según el padrón. Cadena vacía si no está en él.
participacionnumberEl porcentaje de participación, tal como el SII lo publica: hasta diez decimales, y puede pasar de 100 — no supongas que los socios suman 100. null cuando el SII no lo informa: una de cada dieciséis participaciones.

Dentro de personas_naturales

CampoTipoQué es
participacionnumberEl porcentaje que suman las personas naturales. null si el SII no lo informa.

Cuándo responde cada cosa

  • 200 El RUT está en el padrón. Descuenta dos consultas, también con las listas vacías: «no participa en nada» es información. Descuenta 2 consultas.
  • 401 No mandaste el header, o no empieza con dtr_. No descuenta.
  • 401 La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.
  • 422 El dígito verificador no corresponde al cuerpo. No se cobra: no hubo consulta. No descuenta.
  • 422 No tiene forma de RUT: cuerpo fuera de 7-8 dígitos, o los ocho caracteres sin guion, que son ambiguos. No descuenta.
  • 503 El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta.
  • 429 Fuiste más rápido que las consultas por minuto de tu plan. Retry-After dice cuánto esperar. No descuenta.
  • 402 Se agotaron las consultas del plan y no hay saldo de recargas. Las consultas se detienen hasta que renueven. No descuenta.
  • 402 Se agotaron las consultas del plan, hay saldo de recargas, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.
  • 404 El RUT es válido pero el SII no lo tiene. SÍ descuenta lo que cuesta la operación pedida: «no está» también es información. Descuenta 2 consultas.
curl -s -i -H "Authorization: Bearer dtr_TU_KEY" \
  https://api.datario.cl/v1/rut/61.704.000-K/sociedades

Respuestas

200 · sociedades 200
{
  "rut": "61704000-K",
  "rut_formateado": "61.704.000-K",
  "es_empresa": true,
  "participaciones": [
    {
      "rut": "76028880-2",
      "rut_formateado": "76.028.880-2",
      "razon_social": "SOCIEDAD CONTRACTUAL MINERA PUREN",
      "participacion": 35.0
    },
    {
      "rut": "76148338-2",
      "rut_formateado": "76.148.338-2",
      "razon_social": "SOCIEDAD DE PROCESAMIENTO DE MOLIBDENO SPA",
      "participacion": 100.0
    }
  ],
  "socios": [],
  "personas_naturales": null,
  "fuente": "Composición de sociedades, SII",
  "publicado": "2025-11-25T16:11:42+00:00",
  "consultado_en": "2026-08-29T04:12:07+00:00"
}

Headers: X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset X-Plan-Limit X-Plan-Remaining X-Plan-Reset X-Credits-Remaining

401 · api_key_invalida 401
{
  "error": "api_key_invalida",
  "detail": "Falta la API key: envíala en el header Authorization: Bearer dtr_…."
}
401 · api_key_invalida 401
{
  "error": "api_key_invalida",
  "detail": "La API key no existe o fue revocada."
}
422 · rut_invalido 422
{
  "error": "rut_invalido",
  "detail": "El RUT no es válido: revisa el dígito verificador."
}
422 · rut_invalido 422
{
  "error": "rut_invalido",
  "detail": "Eso no parece un RUT: son 7 u 8 dígitos más el verificador."
}
503 · padron_no_disponible 503
{
  "error": "padron_no_disponible",
  "detail": "El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"
}
429 · limite_de_velocidad 429
{
  "error": "limite_de_velocidad",
  "detail": "Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."
}

Headers: X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset Retry-After

402 · sin_saldo 402
{
  "error": "sin_saldo",
  "detail": "Se acabaron las consultas de tu plan y no te queda saldo. Renuevan el día que tu plan cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/packs, o contrata el plan de ese mismo volumen en https://datario.cl/panel/planes, que sale más barato por consulta"
}

Headers: X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset

402 · saldo_protegido 402
{
  "error": "saldo_protegido",
  "detail": "Las consultas del plan no alcanzan y tu saldo está protegido (pediste no gastarlo automáticamente): actívalo en https://datario.cl/panel/configuracion/avisos o renueva tu plan"
}

Headers: X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset

404 · rut_no_registrado 404
{
  "error": "rut_no_registrado",
  "detail": "El SII no registra datos para 12345678-5."
}

Headers: X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset X-Plan-Limit X-Plan-Remaining X-Plan-Reset X-Credits-Remaining

GET /v1/rut/{rut}/grupos

El grupo

Las empresas que se alcanzan siguiendo las participaciones desde el RUT —en las dos direcciones— hasta saltos de distancia, y las participaciones entre ellas. El grupo se corta en 200 empresas y lo dice.

Parámetros

ParámetroTipoQué es
saltosintegerHasta cuántos saltos seguir las participaciones: 1 a 3. Por defecto 2. Uno es participación directa; cada salto más multiplica las empresas.

Lo que devuelve

CampoTipoQué es
rutstringEl RUT que consultaste, normalizado: con guion y sin puntos.
rut_formateadostringEl mismo RUT listo para mostrar: con puntos y guion.
es_empresabooleantrue si el RUT es de una empresa y false si es de una persona. Sirve para decidir qué pedirle a quien se está registrando.
saltosintegerHasta cuántos saltos se siguió: el que pediste, o 2.
empresasarrayLas empresas del grupo, de la más cercana a la más lejana. Vacía si el RUT no participa en nada ni nadie participa en él.
participacionesarrayLas participaciones ENTRE las empresas de la respuesta (el RUT incluido): el grafo que la lista describe.
truncadobooleantrue si el grupo tiene más de 200 empresas y la respuesta trae solo las más cercanas. Con menos saltos se ve más de cerca.
fuentestringDe dónde salen los datos de esta respuesta, en texto listo para citar («Composición de sociedades, SII»). Es constante para esta llamada: guárdalo una vez y no lo parsees.
publicadostringDe cuándo es la composición de sociedades que respondió. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC. Es otro archivo que el padrón: otra fecha que padron_publicado.
consultado_enstringCuándo se respondió esta llamada. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC.

Dentro de empresas

CampoTipoQué es
rutstringEl RUT, normalizado. Pide su ficha con él.
rut_formateadostringEl mismo RUT listo para mostrar.
razon_socialstringSu nombre legal según el padrón. Cadena vacía si no está.
distanciaintegerA cuántos saltos del RUT consultado: 1 es participación directa.

Dentro de participaciones

CampoTipoQué es
sociostringQuién participa.
sociedadstringEn qué sociedad.
participacionnumberEl porcentaje, tal como el SII lo publica. null si no lo informa.

Cuándo responde cada cosa

  • 200 El RUT está en el padrón. Descuenta cinco consultas, con el grupo entero o truncado. Descuenta 5 consultas.
  • 401 No mandaste el header, o no empieza con dtr_. No descuenta.
  • 401 La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.
  • 422 El dígito verificador no corresponde al cuerpo. No se cobra: no hubo consulta. No descuenta.
  • 422 No tiene forma de RUT: cuerpo fuera de 7-8 dígitos, o los ocho caracteres sin guion, que son ambiguos. No descuenta.
  • 503 El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta.
  • 429 Fuiste más rápido que las consultas por minuto de tu plan. Retry-After dice cuánto esperar. No descuenta.
  • 402 Se agotaron las consultas del plan y no hay saldo de recargas. Las consultas se detienen hasta que renueven. No descuenta.
  • 402 Se agotaron las consultas del plan, hay saldo de recargas, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.
  • 422 Pediste más saltos de los que el grupo sigue. No se cobra: no hubo lectura. No descuenta.
  • 503 El grafo tardó más que su techo propio: pasa con holdings de miles de filiales y 3 saltos. No se cobra, y con menos saltos casi siempre responde. No descuenta.
  • 404 El RUT es válido pero el SII no lo tiene. SÍ descuenta lo que cuesta la operación pedida: «no está» también es información. Descuenta 5 consultas.
curl -s -i -H "Authorization: Bearer dtr_TU_KEY" \
  https://api.datario.cl/v1/rut/61.704.000-K/grupos

Respuestas

200 · grupos 200
{
  "rut": "61704000-K",
  "rut_formateado": "61.704.000-K",
  "es_empresa": true,
  "saltos": 2,
  "empresas": [
    {
      "rut": "76063022-5",
      "rut_formateado": "76.063.022-5",
      "razon_social": "INCA DE ORO S.A.",
      "distancia": 1
    },
    {
      "rut": "76092641-8",
      "rut_formateado": "76.092.641-8",
      "razon_social": "PANAUST MINERA IDO LIMITADA",
      "distancia": 2
    }
  ],
  "participaciones": [
    {
      "socio": "61704000-K",
      "sociedad": "76063022-5",
      "participacion": 30.6
    },
    {
      "socio": "76092641-8",
      "sociedad": "76063022-5",
      "participacion": 69.4
    }
  ],
  "truncado": true,
  "fuente": "Composición de sociedades, SII",
  "publicado": "2025-11-25T16:11:42+00:00",
  "consultado_en": "2026-08-29T04:12:07+00:00"
}

Headers: X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset X-Plan-Limit X-Plan-Remaining X-Plan-Reset X-Credits-Remaining

401 · api_key_invalida 401
{
  "error": "api_key_invalida",
  "detail": "Falta la API key: envíala en el header Authorization: Bearer dtr_…."
}
401 · api_key_invalida 401
{
  "error": "api_key_invalida",
  "detail": "La API key no existe o fue revocada."
}
422 · rut_invalido 422
{
  "error": "rut_invalido",
  "detail": "El RUT no es válido: revisa el dígito verificador."
}
422 · rut_invalido 422
{
  "error": "rut_invalido",
  "detail": "Eso no parece un RUT: son 7 u 8 dígitos más el verificador."
}
503 · padron_no_disponible 503
{
  "error": "padron_no_disponible",
  "detail": "El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"
}
429 · limite_de_velocidad 429
{
  "error": "limite_de_velocidad",
  "detail": "Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."
}

Headers: X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset Retry-After

402 · sin_saldo 402
{
  "error": "sin_saldo",
  "detail": "Se acabaron las consultas de tu plan y no te queda saldo. Renuevan el día que tu plan cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/packs, o contrata el plan de ese mismo volumen en https://datario.cl/panel/planes, que sale más barato por consulta"
}

Headers: X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset

402 · saldo_protegido 402
{
  "error": "saldo_protegido",
  "detail": "Las consultas del plan no alcanzan y tu saldo está protegido (pediste no gastarlo automáticamente): actívalo en https://datario.cl/panel/configuracion/avisos o renueva tu plan"
}

Headers: X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset

422 · parametros_invalidos 422
{
  "error": "parametros_invalidos",
  "detail": "saltos debe ser un entero entre 1 y 3."
}
503 · lectura_expirada 503
{
  "error": "lectura_expirada",
  "detail": "La lectura tardó demasiado: reduce saltos o reintenta. Si sigue fallando, mira https://status.datario.cl"
}

Headers: X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset

404 · rut_no_registrado 404
{
  "error": "rut_no_registrado",
  "detail": "El SII no registra datos para 12345678-5."
}

Headers: X-RateLimit-Limit X-RateLimit-Remaining X-RateLimit-Reset X-Plan-Limit X-Plan-Remaining X-Plan-Reset X-Credits-Remaining

Probar en la consola Este producto por SOAP Este producto por GraphQL Este producto por MCP Qué es Sociedades y grupos