Investigaciones Marshal de un perfil de compliance

Este endpoint lista las investigaciones Marshal de un perfil de compliance buscado por nombre, como las solicitadas con includeMarshal en Cargar perfil en Compliance.

• Consultar las investigaciones no tiene costo.
• Requiere que tu plan incluya el módulo de compliance y cuente con Marshal.
• Para ver el reporte completo de una investigación, usa Detalle de una investigación.

Qué cambia respecto a la v2

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

Detalle de API

Request

• URL: /compliance/perfiles/{id}/investigaciones
• Método: GET

Parámetros de ruta (path)

Valor	Tipo	Es requerido	Descripción
id	number	Sí	Identificador del perfil (entero positivo), obtenido en Listar perfiles.

Parámetros de consulta (query)

Valor	Tipo	Es requerido	Descripción
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/compliance/perfiles/7/investigaciones?page=1' \
  -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": "JUAN PEREZ SOTO",
          "rut": null,
          "pais": "Chile",
          "estado": "COMPLETADA",
          "motivo": null,
          "detalleMotivo": null,
          "riesgo": "ALTO",
          "indicadorPep": "SI",
          "totalHallazgos": 3,
          "canal": "API",
          "fechaCreacion": "13-08-2026 12:00:00",
          "fechaTermino": "13-08-2026 12:05:30",
          "tieneReporte": true
        }
      ],
      "pagina": 1,
      "totalPaginas": 1,
      "cantidad": 1
    }
  }

Los campos de cada investigación son los mismos de Listar investigaciones, con estas particularidades:

• rut siempre viaja en null, porque la búsqueda es por nombre.
• pais es el país de la búsqueda del perfil, o "Global" si se buscó sin país.

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.
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 del perfil.

Los estados, motivos de falla y canales se describen en Listar investigaciones. 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 o el parámetro page no son válidos. Corrige el valor indicado en el mensaje y vuelve a enviar la solicitud.

Cuándo ocurre	Mensaje en error
id no es un entero positivo	El id del perfil no es válido.
page menor a 1	El campo 'page' debe ser mayor o igual a 1.

{
  "success": false,
  "code": 400,
  "error": "El id del perfil 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 el módulo de compliance o sin Marshal

Tu plan no incluye el módulo de compliance o no cuenta con Marshal. El mensaje indica cuál de los dos falta:

Cuándo ocurre	Mensaje en error
Tu plan no incluye el módulo de compliance	El plan no cuenta con el módulo de compliance.
Tu plan no cuenta con Marshal	El plan no cuenta con Marshal.

{
  "success": false,
  "code": 403,
  "error": "El plan no cuenta con el módulo de compliance."
}

404 - Perfil no encontrado

No se encontró un perfil de compliance con el id indicado.

{
  "success": false,
  "code": 404,
  "error": "Perfil de compliance no encontrado."
}

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