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 con Marshal.
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=88888888-8&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": "88888888-8",
"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": "88888888-8",
"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 que se investigó; 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: "SIN RIESGO", "BAJO", "MEDIO", "ALTO", "CRÍTICO"). |
indicadorPep | string | Solo si COMPLETADA: indicador PEP del análisis (ej: "NO", "DIRECTO", "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.
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érico | El campo 'page' debe ser un número. |
page decimal | El campo 'page' debe ser un número entero. |
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."
}