Listar investigaciones Marshal de un RUT

Este endpoint lista las investigaciones Marshal de un RUT en tu cuenta: las solicitadas al cargarlo con includeMarshal, con Actualizar Marshal o desde la plataforma, y las generadas por el monitoreo. Puedes filtrarlas por estado, canal y fecha.

• Consultar las investigaciones no tiene costo.
• Requiere que tu plan cuente con Marshal.
• Incluye las investigaciones de toda tu cuenta, sin importar qué usuario las solicitó.
• Las investigaciones de los perfiles de compliance buscados por nombre se consultan en Investigaciones de un perfil.

Qué cambia respecto a la v2

Endpoint nuevo en la v3. Ver la Guía de Migración.

Detalle de API

Request

• URL: /marshal/investigaciones?rut={rut}
• Método: GET

Parámetros de consulta (query)

Valor	Tipo	Es requerido	Descripción
rut	string	Sí	RUT cuyas investigaciones se consultan. Formato "12345678-9"; también se acepta con puntos o sin guion.
estado	string	No	EN_CURSO, COMPLETADA o FALLIDA (ver Estados).
canal	string	No	PLATFORM, API o MONITORING (ver Canales).
desde	string	No	Fecha de creación inicial, inclusive, en UTC (formato DD-MM-YYYY).
hasta	string	No	Fecha de creación final, inclusive, en UTC (formato DD-MM-YYYY). No puede ser anterior a desde.
page	number	No	Página a consultar. Entero mayor o igual a 1. Por defecto 1. Cada página trae hasta 50 investigaciones.

Ejemplo request con curl

curl -X 'GET' \
  'https://prod.api.thesheriff.cl/api/clients/v3/marshal/investigaciones?rut=76123456-0&estado=COMPLETADA' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123'

Response

Success

• Status code: 200

• Example response body:

  {
    "success": true,
    "data": {
      "investigaciones": [
        {
          "id": "0b6c1d9e-7a7f-4a2b-9c55-3f1e2d4a5b6c",
          "entidad": "EMPRESA FICTICIA SPA",
          "rut": "76123456-0",
          "pais": "Chile",
          "estado": "COMPLETADA",
          "motivo": null,
          "detalleMotivo": null,
          "riesgo": "ALTO",
          "indicadorPep": "NO",
          "totalHallazgos": 2,
          "canal": "API",
          "fechaCreacion": "10-08-2026 12:00:00",
          "fechaTermino": "10-08-2026 12:05:30",
          "tieneReporte": true
        },
        {
          "id": "5f2a8c41-1d3e-4b7a-8e90-6a2b3c4d5e6f",
          "entidad": "EMPRESA FICTICIA SPA",
          "rut": "76123456-0",
          "pais": "Chile",
          "estado": "FALLIDA",
          "motivo": "TIEMPO_AGOTADO",
          "detalleMotivo": "La investigación no respondió a tiempo",
          "riesgo": null,
          "indicadorPep": null,
          "totalHallazgos": null,
          "canal": "PLATFORM",
          "fechaCreacion": "02-07-2026 09:10:00",
          "fechaTermino": "02-07-2026 09:25:00",
          "tieneReporte": false
        }
      ],
      "pagina": 1,
      "totalPaginas": 1,
      "cantidad": 2
    }
  }

Success (sin investigaciones)

Un RUT sin investigaciones, o que no existe en Sheriff, responde 200 con la lista vacía:

{
  "success": true,
  "data": {
    "investigaciones": [],
    "pagina": 1,
    "totalPaginas": 0,
    "cantidad": 0
  }
}

Campos de la respuesta:

Campo	Tipo	Descripción
success	boolean	Indica si la operación fue exitosa.
data	object	Página de investigaciones y datos de paginación.

Campos dentro de data:

Campo	Tipo	Descripción
investigaciones	array	Investigaciones de la página, de la más reciente a la más antigua (ver campos anidados).
pagina	number	Página devuelta.
totalPaginas	number	Cantidad de páginas (50 investigaciones por página); 0 si no hay resultados.
cantidad	number	Cantidad total de investigaciones que cumplen los filtros.

Campos de cada investigación

Campos dentro de cada elemento de investigaciones:

Campo	Tipo	Descripción
id	string	Identificador de la investigación (UUID). Úsalo en Detalle de una investigación.
entidad	string	Nombre o razón social investigado; null mientras se espera la identificación (SII) del RUT.
rut	string	RUT investigado (formato "12345678-9").
pais	string	País de la investigación, con su nombre en español, o "Global" si no tiene país.
estado	string	EN_CURSO, COMPLETADA o FALLIDA (ver Estados).
motivo	string	Solo si FALLIDA: motivo de la falla (ver Motivos de falla); null en otro caso.
detalleMotivo	string	Solo si FALLIDA: descripción del motivo; null en otro caso.
riesgo	string	Solo si COMPLETADA: nivel de riesgo del análisis, o el asignado manualmente si existe (ej: "BAJO", "MEDIO", "ALTO", "CRÍTICO").
indicadorPep	string	Solo si COMPLETADA: indicador PEP del análisis (ej: "NO", "SI", "POR ASOCIACIÓN").
totalHallazgos	number	Solo si COMPLETADA: cantidad de hallazgos en medios encontrados.
canal	string	Desde dónde se solicitó (ver Canales); puede ser null en investigaciones antiguas.
fechaCreacion	string	Fecha y hora de creación (formato DD-MM-YYYY HH:mm:ss, UTC).
fechaTermino	string	Fecha y hora de término (formato DD-MM-YYYY HH:mm:ss, UTC); null mientras está en curso.
tieneReporte	boolean	true si la investigación tiene reporte disponible en el detalle.

La respuesta tiene la misma estructura para personas naturales y jurídicas.

Investigaciones fallidas reemplazadas

Si una investigación falló y un reintento posterior de la misma solicitud se completó, el listado muestra solo la completada. La fallida sigue disponible por su id en Detalle de una investigación.

Estados

Estado	Significado
EN_CURSO	La investigación espera la identificación del RUT, está en cola o en proceso.
COMPLETADA	La investigación terminó y su reporte está disponible.
FALLIDA	La investigación no pudo completarse (ver motivo).

Motivos de falla

motivo	detalleMotivo	Cuándo ocurre
SIN_RAZON_SOCIAL	Sin razón social para investigar	No se obtuvo la razón social o el nombre del RUT desde la identificación (SII).
ERROR_ENVIO	No se pudo enviar la investigación	La investigación no pudo enviarse a Marshal, o no se envió dentro de 6 horas.
ERROR_PROVEEDOR	La investigación no pudo completarse	Marshal informó que no pudo completar la investigación.
TIEMPO_AGOTADO	La investigación no respondió a tiempo	Marshal no respondió dentro del plazo. Si la respuesta llega después, la investigación puede pasar a COMPLETADA.
SIN_CUPO	Sin cupo de investigaciones Marshal en el plan	Tu plan no tenía cupo disponible cuando la investigación iba a enviarse.

Canales

canal	Origen de la investigación
PLATFORM	Solicitada desde la plataforma de Sheriff.
API	Solicitada por la API.
MONITORING	Generada por el monitoreo de Marshal.

Errores

Además de los errores comunes, este endpoint puede responder:

400 - Parámetros inválidos

Algún parámetro de la consulta falta o no es válido. El mensaje indica el parámetro rechazado; si hay más de uno, los mensajes vienen uno a continuación del otro, separados por un espacio. Corrige los parámetros indicados y vuelve a enviar la solicitud.

Cuándo ocurre	Mensaje en error
Falta rut	El RUT es requerido.
RUT inválido	El RUT ingresado no es válido. Por favor verifica el formato.
estado inválido	El campo 'estado' debe ser uno de: [EN_CURSO, COMPLETADA, FALLIDA].
canal inválido	El campo 'canal' debe ser uno de: [PLATFORM, API, MONITORING].
desde o hasta con otro formato	La fecha debe tener el formato DD-MM-YYYY.
desde posterior a hasta	La fecha "desde" no puede ser posterior a "hasta".
page no numérica	El campo 'page' debe ser un número.
page menor a 1	El campo 'page' debe ser mayor o igual a 1.

{
  "success": false,
  "code": 400,
  "error": "El RUT es requerido."
}

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 - Plan sin Marshal

Tu plan no cuenta con Marshal.

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

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."
}