Detalle de una investigación Marshal

Este endpoint entrega una investigación Marshal con su reporte completo: hallazgos en medios de prensa, homónimos descartados, entidades relacionadas, fuentes verificadas y, si existe, la alerta asignada manualmente.

• Consultar una investigación no tiene costo.
• Requiere que tu plan cuente con Marshal.
• Sirve tanto para las investigaciones de un RUT como para las de perfiles de compliance buscados por nombre.

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/{id}
• Método: GET

Parámetros de ruta (path)

Valor	Tipo	Es requerido	Descripción
id	string	Sí	Identificador de la investigación (UUID), de Listar investigaciones o de Investigaciones de un perfil.

Ejemplo request con curl

curl -X 'GET' \
  'https://prod.api.thesheriff.cl/api/clients/v3/marshal/investigaciones/0b6c1d9e-7a7f-4a2b-9c55-3f1e2d4a5b6c' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123'

Response

Success (investigación completada)

• Status code: 200

• Example response body:

  {
    "success": true,
    "data": {
      "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": 1,
      "canal": "API",
      "fechaCreacion": "10-08-2026 12:00:00",
      "fechaTermino": "10-08-2026 12:05:30",
      "tieneReporte": true,
      "reporte": {
        "entidadBuscada": "EMPRESA FICTICIA SPA",
        "fechaBusqueda": "10-08-2026",
        "perfilEntidad": "Empresa de servicios de consultoría",
        "resumenEjecutivoAdverseMedia": "Un hallazgo relevante en medios.",
        "resumenEjecutivoPep": "Sin vínculos PEP.",
        "incidentesEncontrados": [
          {
            "categoriaRiesgo": "Lavado de Activos",
            "riesgoClasificado": "ALTO",
            "estatusLegal": "Investigación en curso",
            "detalleCoincidencias": [
              {
                "titularArticulo": "Formalizan a gerente de Empresa Ficticia",
                "resumenHallazgo": "El gerente fue formalizado por lavado de activos.",
                "fuenteBase": "La Tercera",
                "fuenteTier": "Tier 2",
                "urlReferencia": "https://www.latercera.com/noticia-ficticia",
                "fechaPublicacion": "02-08-2026"
              }
            ]
          }
        ],
        "homonimosDescartados": [
          {
            "nombreEncontrado": "Empresa Ficticia Ltda",
            "razonDescarte": "RUT distinto",
            "resumenHallazgoDescartado": "Otra empresa con nombre similar.",
            "factoresConfianza": ["Giro distinto"]
          }
        ],
        "entidadesRelacionadas": [
          {
            "nombre": "Juan Pérez",
            "relacion": "Socio"
          }
        ],
        "fuentesVerificadas": [
          {
            "titulo": "La Tercera",
            "url": "https://www.latercera.com/noticia-ficticia"
          }
        ]
      },
      "alertaManual": null
    }
  }

Success (investigación en curso o fallida)

Mientras la investigación está en curso, o si falló, reporte viaja en null:

{
  "success": true,
  "data": {
    "id": "5f2a8c41-1d3e-4b7a-8e90-6a2b3c4d5e6f",
    "entidad": "EMPRESA FICTICIA SPA",
    "rut": "76123456-0",
    "pais": "Chile",
    "estado": "FALLIDA",
    "motivo": "ERROR_PROVEEDOR",
    "detalleMotivo": "La investigación no pudo completarse",
    "riesgo": null,
    "indicadorPep": null,
    "totalHallazgos": null,
    "canal": "PLATFORM",
    "fechaCreacion": "02-07-2026 09:10:00",
    "fechaTermino": "02-07-2026 09:20:00",
    "tieneReporte": false,
    "reporte": null,
    "alertaManual": null
  }
}

Campos de la respuesta:

Campo	Tipo	Descripción
success	boolean	Indica si la operación fue exitosa.
data	object	Investigación con su reporte.

Campos dentro de data: los mismos de cada investigación en Listar investigaciones, más:

Campo	Tipo	Descripción
reporte	object	Reporte de la investigación (ver tabla siguiente); null si no está COMPLETADA o si no tiene reporte.
alertaManual	object	Alerta asignada manualmente desde la plataforma (ver tabla siguiente); null si no tiene.

En las investigaciones de perfiles de compliance buscados por nombre, rut viaja en null.

Campos dentro de reporte:

Campo	Tipo	Descripción
entidadBuscada	string	Nombre o razón social investigado.
fechaBusqueda	string	Fecha de la búsqueda (formato DD-MM-YYYY).
perfilEntidad	string	Descripción de la entidad investigada.
resumenEjecutivoAdverseMedia	string	Resumen de los hallazgos en medios.
resumenEjecutivoPep	string	Resumen de la detección de Personas Expuestas Políticamente (PEP).
incidentesEncontrados	array	Incidentes encontrados (ver campos anidados).
homonimosDescartados	array	Coincidencias de nombre descartadas (ver campos anidados).
entidadesRelacionadas	array	Personas o entidades relacionadas: nombre y relacion.
fuentesVerificadas	array	Fuentes consultadas: titulo y url.

Campos dentro de cada elemento de incidentesEncontrados:

Campo	Tipo	Descripción
categoriaRiesgo	string	Categoría del riesgo (ej: "Lavado de Activos").
riesgoClasificado	string	Nivel de riesgo del incidente (ej: "ALTO").
estatusLegal	string	Estado legal del incidente.
detalleCoincidencias	array	Publicaciones que respaldan el incidente (ver tabla siguiente).

Campos dentro de cada elemento de detalleCoincidencias:

Campo	Tipo	Descripción
titularArticulo	string	Titular de la publicación.
resumenHallazgo	string	Resumen del hallazgo.
fuenteBase	string	Medio de la publicación.
fuenteTier	string	Nivel de confiabilidad del medio (ej: "Tier 2").
urlReferencia	string	URL de la publicación.
fechaPublicacion	string	Fecha de publicación (formato DD-MM-YYYY).

Campos dentro de cada elemento de homonimosDescartados:

Campo	Tipo	Descripción
nombreEncontrado	string	Nombre encontrado en la fuente.
razonDescarte	string	Motivo por el que se descartó.
resumenHallazgoDescartado	string	Resumen del hallazgo descartado.
factoresConfianza	array	Factores usados para descartarlo.

Campos dentro de alertaManual:

Campo	Tipo	Descripción
riesgo	string	Riesgo asignado manualmente (BAJO, MEDIO, ALTO o CRÍTICO). Reemplaza al riesgo de la investigación.
riesgoCalculado	string	Riesgo que entregó el análisis.
motivo	string	Motivo del cambio.
fecha	string	Fecha y hora del cambio (formato DD-MM-YYYY HH:mm:ss, UTC).

Nota: los textos sin información viajan en null y las listas sin elementos, como []. La respuesta tiene la misma estructura para personas naturales y jurídicas.

Errores

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

400 - Parámetros inválidos

El id de la ruta no es un identificador válido. Usa el id (UUID) que entrega Listar investigaciones o Investigaciones de un perfil.

{
  "success": false,
  "code": 400,
  "error": "El id de la investigación no es válido."
}

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

404 - Investigación no encontrada

La investigación no existe o no pertenece a tu cuenta.

{
  "success": false,
  "code": 404,
  "error": "Investigación no encontrada."
}

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