Malla Societaria

Este endpoint entrega la malla societaria directa de un RUT cargado en tu cuenta: socios, administradores, participaciones en otras sociedades y los extractos publicados que respaldan esa información.

Consultar un RUT ya cargado en tu cuenta no genera costos adicionales.
El RUT debe estar cargado en tu cuenta antes de la consulta (ver Carga de RUT).
Requiere que tu plan incluya el ayudante Legal.
La respuesta depende de si el RUT corresponde a una persona jurídica o a una persona natural.

Qué cambia respecto a la v2

La ruta se mantiene, pero la respuesta cambia: las publicaciones de Empresa en un Día y del Diario Oficial se consolidan en socios, administradores, participaciones y extractos, y fuentes indica de dónde proviene la información.
Las personas naturales se consultan en esta misma ruta (en la v2 se consultaban en mallaSocietariaPersonas).
Los porcentajes pasan a ser numéricos y se agregan los campos tipos y tieneCmf.

Ver la Guía de Migración.

Detalle de API

Request

URL: /helper/legal/{rut}/mallaSocietaria
Método: GET

Parámetros de ruta (path)

Valor	Tipo	Es requerido	Descripción
`rut`	`string`	Sí	RUT a consultar, en formato "12345678-9".

Ejemplo request con curl

curl -X 'GET' \
  'https://prod.api.thesheriff.cl/api/clients/v3/helper/legal/76123456-0/mallaSocietaria' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123'

Response

Campo	Tipo	Descripción
`success`	`bool`	Indica si la operación fue exitosa.
`data`	`object`	Malla societaria del RUT consultado.

Diferencias por tipo de persona

El campo tipoPersona de data indica si el RUT corresponde a una persona jurídica ("juridica") o a una persona natural ("natural").

Campo	Persona jurídica	Persona natural
`tieneCmf`, `fuentes`, `socios`, `administradores`, `participaciones`, `extractos` en `data`	Sí	No: van dentro de cada elemento de `sociedades`
`sociedades`	No	Sí
`roles` (dentro de cada sociedad)	No	Sí

Respuesta para persona jurídica

Success

Status code: 200

Example response body:

{
  "success": true,
  "data": {
    "rut": "76123456-0",
    "nombre": "EMPRESA FICTICIA SPA",
    "tipoPersona": "juridica",
    "tieneCmf": false,
    "fuentes": ["EEUD", "DO"],
    "socios": [
      {
        "nombre": "SOCIO FICTICIO UNO",
        "rut": "11111111-1",
        "domicilio": "CALLE EJEMPLO 123, LAS CONDES",
        "tipoPersona": "natural",
        "acciones": "7000",
        "monto": "7000000",
        "porcentaje": 70,
        "vigente": true,
        "tipos": ["SOCIO", "ADMINISTRADOR"]
      },
      {
        "nombre": "HOLDING FICTICIO LTDA",
        "rut": "22222222-2",
        "domicilio": null,
        "tipoPersona": "juridica",
        "acciones": "3000",
        "monto": "3000000",
        "porcentaje": 30,
        "vigente": true,
        "tipos": ["SOCIO"]
      }
    ],
    "administradores": [
      {
        "nombre": "SOCIO FICTICIO UNO",
        "rut": "11111111-1",
        "domicilio": "CALLE EJEMPLO 123, LAS CONDES"
      }
    ],
    "participaciones": [
      {
        "nombre": "FILIAL FICTICIA SPA",
        "rut": "33333333-3",
        "domicilio": null,
        "acciones": null,
        "monto": null,
        "porcentaje": 50,
        "vigente": true,
        "tipos": ["ACCIONISTA"],
        "fechaConstitucion": "01-01-2020"
      }
    ],
    "extractos": [
      {
        "fecha": "11-05-2024",
        "actuacion": "MODIFICACION",
        "cve": "2491726",
        "fuente": "EEUD",
        "linkPdf": "https://www.registrodeempresasysociedades.cl/Certificados/"
      },
      {
        "fecha": "02-06-2021",
        "actuacion": "CONSTITUCION",
        "cve": null,
        "fuente": "DO",
        "linkPdf": "https://www.diariooficial.interior.gob.cl/publicaciones/2021/06/02/"
      }
    ],
    "ultimaActualizacion": "15-08-2026 13:45:10"
  }
}

Campos dentro de data (persona jurídica):

Campo	Tipo	Puede ser null	Descripción
`rut`	`string`	No	RUT consultado (formato "12345678-9").
`nombre`	`string`	Sí	Razón social de la sociedad.
`tipoPersona`	`string`	No	Siempre `"juridica"`.
`tieneCmf`	`boolean`	No	Indica si la sociedad tiene registro en la CMF (ver CMF).
`fuentes`	`array`	No	Fuentes de los extractos encontrados: `"DO"` (Diario Oficial) y/o `"EEUD"` (Empresa en un Día).
`socios`	`array`	No	Personas o sociedades con rol de socio o accionista (ver Estructuras comunes).
`administradores`	`array`	No	Personas o sociedades con rol de administrador o representante legal.
`participaciones`	`array`	No	Sociedades en las que la sociedad consultada participa.
`extractos`	`array`	No	Extractos publicados.
`ultimaActualizacion`	`string`	Sí	Fecha y hora de la última actualización del ayudante Legal (formato "DD-MM-YYYY HH:mm:ss"); `null` si no hay registro.

Respuesta para persona natural

Para una persona natural, data describe a la persona y, en sociedades, entrega la malla de cada sociedad en la que participa. El campo roles de cada sociedad indica la relación que tiene la persona con ella.

Success

Status code: 200

Example response body:

{
  "success": true,
  "data": {
    "rut": "11111111-1",
    "nombre": "SOCIO FICTICIO UNO",
    "tipoPersona": "natural",
    "sociedades": [
      {
        "rut": "76123456-0",
        "nombre": "EMPRESA FICTICIA SPA",
        "roles": ["SOCIO", "ADMINISTRADOR"],
        "tieneCmf": false,
        "fuentes": ["EEUD"],
        "socios": [
          {
            "nombre": "SOCIO FICTICIO UNO",
            "rut": "11111111-1",
            "domicilio": "CALLE EJEMPLO 123, LAS CONDES",
            "tipoPersona": "natural",
            "acciones": "7000",
            "monto": "7000000",
            "porcentaje": 70,
            "vigente": true,
            "tipos": ["SOCIO", "ADMINISTRADOR"]
          }
        ],
        "administradores": [
          {
            "nombre": "SOCIO FICTICIO UNO",
            "rut": "11111111-1",
            "domicilio": "CALLE EJEMPLO 123, LAS CONDES"
          }
        ],
        "participaciones": [],
        "extractos": [
          {
            "fecha": "02-06-2021",
            "actuacion": "CONSTITUCION",
            "cve": "1234567",
            "fuente": "EEUD",
            "linkPdf": "https://www.registrodeempresasysociedades.cl/Certificados/"
          }
        ]
      }
    ],
    "ultimaActualizacion": "15-08-2026 13:45:10"
  }
}

Campos dentro de data (persona natural):

Campo	Tipo	Puede ser null	Descripción
`rut`	`string`	No	RUT consultado.
`nombre`	`string`	Sí	Nombre completo de la persona.
`tipoPersona`	`string`	No	Siempre `"natural"`.
`sociedades`	`array`	No	Una entrada por cada sociedad en la que participa la persona (ver tabla siguiente).
`ultimaActualizacion`	`string`	Sí	Fecha y hora de la última actualización del ayudante Legal (formato "DD-MM-YYYY HH:mm:ss"); `null` si no hay registro.

Campos dentro de cada elemento de sociedades (persona natural):

Campo	Tipo	Puede ser null	Descripción
`rut`	`string`	Sí	RUT de la sociedad.
`nombre`	`string`	Sí	Razón social de la sociedad.
`roles`	`array`	No	Roles de la persona consultada en esa sociedad (ej: `["SOCIO", "ADMINISTRADOR"]`).
`tieneCmf`	`boolean`	No	Indica si la sociedad tiene registro en la CMF. La persona no tiene un `tieneCmf` propio.
`fuentes`	`array`	No	Fuentes de los extractos de la sociedad (`"DO"`, `"EEUD"`).
`socios`	`array`	No	Socios y accionistas de la sociedad (ver Estructuras comunes).
`administradores`	`array`	No	Administradores y representantes legales de la sociedad.
`participaciones`	`array`	No	Sociedades en las que esa sociedad participa.
`extractos`	`array`	No	Extractos de la sociedad.

Respuesta sin información legal

Si el RUT está cargado, pero el ayudante Legal aún no tiene información sobre él, la respuesta es 200 con la estructura vacía y tipoPersona en null:

{
  "success": true,
  "data": {
    "rut": "76123456-0",
    "nombre": null,
    "tipoPersona": null,
    "tieneCmf": false,
    "fuentes": [],
    "socios": [],
    "administradores": [],
    "participaciones": [],
    "extractos": [],
    "ultimaActualizacion": null
  }
}

Estructuras comunes

Estos arreglos tienen la misma estructura en la raíz de una persona jurídica y dentro de cada sociedad de una persona natural.

Campos dentro de cada elemento de socios:

Campo	Tipo	Descripción
`nombre`	`string`	Nombre o razón social.
`rut`	`string`	RUT.
`domicilio`	`string`	Domicilio declarado; puede ser `null`.
`tipoPersona`	`string`	`"natural"` o `"juridica"`.
`acciones`	`string`	Número de acciones o derechos, tal como figura en la fuente; puede ser `null`.
`monto`	`string`	Monto del aporte, tal como figura en la fuente; puede ser `null`.
`porcentaje`	`number`	Porcentaje de participación, con hasta 2 decimales (ej: `70`); `null` si no se informa.
`vigente`	`boolean`	`true` si la relación sigue vigente; `false` para ex-socios; `null` si no se informa.
`tipos`	`array`	Roles en la sociedad (ej: `["SOCIO", "ADMINISTRADOR"]`).

Campos dentro de cada elemento de participaciones:

Campo	Tipo	Descripción
`nombre`	`string`	Razón social de la sociedad participada.
`rut`	`string`	RUT de la sociedad participada.
`domicilio`	`string`	Domicilio declarado; puede ser `null`.
`acciones`	`string`	Número de acciones o derechos; puede ser `null`.
`monto`	`string`	Monto del aporte; puede ser `null`.
`porcentaje`	`number`	Porcentaje de participación (ej: `50`); `null` si no se informa.
`vigente`	`boolean`	`true` si la participación sigue vigente.
`tipos`	`array`	Roles en la sociedad participada (ej: `["ACCIONISTA"]`).
`fechaConstitucion`	`string`	Fecha de constitución de la sociedad participada (DD-MM-YYYY); puede ser `null`.

Campos dentro de cada elemento de administradores:

Campo	Tipo	Descripción
`nombre`	`string`	Nombre o razón social.
`rut`	`string`	RUT.
`domicilio`	`string`	Domicilio declarado; puede ser `null`.

Campos dentro de cada elemento de extractos:

Campo	Tipo	Descripción
`fecha`	`string`	Fecha de publicación (DD-MM-YYYY).
`actuacion`	`string`	Tipo de actuación (ej: "CONSTITUCION", "MODIFICACION").
`cve`	`string`	Código de Verificación Electrónica del documento.
`fuente`	`string`	`"DO"` (Diario Oficial) o `"EEUD"` (Empresa en un Día); puede ser `null`.
`linkPdf`	`string`	URL al documento; `null` si no está disponible.

Cómo se clasifican socios y administradores

Una misma persona puede aparecer en socios y en administradores. Aparece en socios si tiene rol de SOCIO o ACCIONISTA (o si no tiene rol informado), y en administradores si tiene rol de ADMINISTRADOR o es representante legal. Para recorrer la malla completa, con todos los roles y niveles, usa Capas de la Malla Societaria.

Errores

Además de los errores comunes y los de acceso al RUT, este endpoint puede responder:

400 - RUT inválido

El RUT de la ruta no tiene un formato válido o su dígito verificador no corresponde. Revisa el formato y vuelve a enviar la solicitud.

{
  "success": false,
  "code": 400,
  "error": "El RUT ingresado no es válido. Por favor verifica el formato."
}

401 - No autorizado

El token no se envió, expiró o no es válido (ver Errores de autenticación). Si expiró, solicita uno nuevo en Obtener Token.

{
  "success": false,
  "code": 401,
  "error": "El token de autenticación no es válido."
}

403 - RUT sin acceso

El RUT existe en Sheriff, pero no está cargado en tu cuenta. Cárgalo con Carga de RUT antes de consultarlo.

{
  "success": false,
  "code": 403,
  "error": "No tienes permisos para consultar este RUT."
}

403 - Plan sin el ayudante Legal

Tu plan no incluye el ayudante Legal.

{
  "success": false,
  "code": 403,
  "error": "El plan no cuenta con el ayudante legal."
}

404 - RUT no encontrado

El RUT no existe en Sheriff. Cárgalo con Carga de RUT antes de consultarlo.

{
  "success": false,
  "code": 404,
  "error": "El RUT consultado no existe en el sistema."
}

429 - Demasiadas solicitudes

Superaste el límite de solicitudes (ver Rate Limits). Espera los segundos que indica el header Retry-After antes de reintentar.

{
  "success": false,
  "code": 429,
  "error": "Demasiadas solicitudes desde esta API externa, intente más tarde."
}

500 - Error interno del servidor

Ocurrió un error inesperado. Intenta nuevamente más tarde.

{
  "success": false,
  "code": 500,
  "error": "Ocurrió un error interno. Intenta nuevamente más tarde."
}

Detalle de API​

Request​

Parámetros de ruta (path)​

Ejemplo request con curl​

Response​

Diferencias por tipo de persona​

Respuesta para persona jurídica​

Respuesta para persona natural​

Respuesta sin información legal​

Estructuras comunes​

Errores​

400 - RUT inválido​

401 - No autorizado​

403 - RUT sin acceso​

403 - Plan sin el ayudante Legal​

404 - RUT no encontrado​

429 - Demasiadas solicitudes​

500 - Error interno del servidor​