Detalle de un perfil de compliance

Este endpoint entrega un perfil de compliance buscado por nombre y, si la búsqueda terminó, su resultado completo: resumen por fuente, riesgo y las coincidencias en malla societaria, PEP, familiares de PEP, funcionarios públicos, listas internacionales, penal y noticias. Es el mismo resultado que recibes en la entrega de Cargar perfil en Compliance.

Consultar un perfil no tiene costo.
Requiere que tu plan incluya el módulo de compliance.
El resultado corresponde a la última actualización del perfil (ultimaActualizacion).

Qué cambia respecto a la v2

Endpoint nuevo en la v3: en la v2 el resultado solo se recibe en el webhook. Ver la Guía de Migración.

Detalle de API

Request

URL: /compliance/perfiles/{id}
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.

Ejemplo request con curl

curl -X 'GET' \
  'https://prod.api.thesheriff.cl/api/clients/v3/compliance/perfiles/7' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123'

Response

Campo	Tipo	Descripción
`success`	`boolean`	Indica si la operación fue exitosa.
`data`	`object`	Perfil y resultado de la búsqueda.

Campos dentro de data:

Campo	Tipo	Descripción
`perfil`	`object`	Datos del perfil, con los mismos campos de Listar perfiles.
`resultado`	`object`	Resultado de la búsqueda (ver Campos de `resultado`); `null` mientras el perfil no está `COMPLETADO`.

Diferencias por tipo de persona

resultado tiene la misma estructura para personas naturales y jurídicas; lo que cambia es su contenido:

Campo	Persona jurídica (`tipPersona: "juridica"`)	Persona natural (`tipPersona: "natural"`)
`datosPepChile`, `datosFuncionarioPublico`, `datosFamiliarPep`	Siempre `[]`, con sus totales en `0`: estas búsquedas no se hacen para personas jurídicas	Coincidencias encontradas
`datosMallaSocietaria`	Sociedades relacionadas con la razón social buscada	Sociedades en las que aparece la persona

Respuesta para persona natural

Success

Status code: 200

Example response body:

{
  "success": true,
  "data": {
    "perfil": {
      "id": 7,
      "nombreCompleto": "JUAN PEREZ SOTO",
      "tipoPersona": "natural",
      "toleranciaBusqueda": 0,
      "pais": "Chile",
      "estado": "COMPLETADO",
      "riesgo": "critical",
      "monitoreo": true,
      "fechaCarga": "13-08-2026 12:00:00",
      "ultimaActualizacion": "14-08-2026 09:30:00",
      "marshal": {
        "totalInvestigaciones": 1,
        "ultima": {
          "id": "0b6c1d9e-7a7f-4a2b-9c55-3f1e2d4a5b6c",
          "estado": "COMPLETADA",
          "riesgo": "ALTO",
          "fecha": "13-08-2026 12:05:30"
        }
      }
    },
    "resultado": {
      "nombreCompleto": "JUAN PEREZ SOTO",
      "tipPersona": "natural",
      "toleranciaBusqueda": 0,
      "resumen": {
        "mallaSocietaria": { "totalResultados": 1, "riesgo": "free" },
        "pepChile": { "totalResultados": 1, "riesgo": "critical" },
        "funcionariosPublicos": { "totalResultados": 1, "riesgo": "medium" },
        "pepChileFamiliares": { "totalResultados": 0, "riesgo": "free" },
        "listasInternacionales": { "totalResultados": 0, "riesgo": "free" },
        "penal": { "totalResultados": 1, "riesgo": "critical" },
        "noticias": { "totalResultados": 1, "riesgo": "medium" }
      },
      "riesgo": "critical",
      "datosMallaSocietaria": [
        {
          "nombreSociedad": "EMPRESA FICTICIA SPA",
          "rutSociedad": "76123456-0",
          "nombreSocio": "JUAN PEREZ SOTO",
          "rutSocio": "11111111-1",
          "fecha": "2021-06-02",
          "socios": [
            {
              "nombre": "JUAN PEREZ SOTO",
              "rut": "11111111-1",
              "domicilio": "CALLE EJEMPLO 123, LAS CONDES",
              "tipoDeParticipacion": "Administrador - Socio",
              "cargo": null,
              "cargoEjecutivoPrincipal": null,
              "fechaNombramiento": null,
              "porcentajeParticipacion": "70"
            }
          ],
          "extractos": [
            {
              "actuacion": "CONSTITUCION",
              "fecha": "2021-06-02",
              "linkPdf": "https://www.diariooficial.interior.gob.cl/publicaciones/2021/06/02/"
            }
          ],
          "ultimaFecha": "2021-06-02",
          "fuente": "Empresa en un Día"
        }
      ],
      "totalMallaSocietaria": 1,
      "datosPepChile": [
        {
          "nombre": "JUAN PEREZ SOTO",
          "cargo": "CONCEJAL",
          "institucion": "MUNICIPALIDAD FICTICIA",
          "periodo": "2018 - 2022"
        }
      ],
      "totalPepChile": 1,
      "datosFuncionarioPublico": [
        {
          "nombre": "JUAN PEREZ SOTO",
          "cargo": "CONCEJAL",
          "institucion": "MUNICIPALIDAD FICTICIA",
          "periodo": "2020"
        }
      ],
      "totalFuncionarioPublico": 1,
      "datosFamiliarPep": [],
      "totalFamiliarPep": 0,
      "datosListasInternacionales": [],
      "totalListasInternacionales": 0,
      "datosPenal": [
        {
          "nombre": "JUAN PEREZ SOTO",
          "postura": "Querellado",
          "rol": "O-1234-2020",
          "fecha": "23/11/2024",
          "infraccion": "ESTAFA",
          "estado": "Tramitación",
          "etapa": "Investigación",
          "litigantes": [
            {
              "nombre": "JUAN PEREZ SOTO",
              "sujeto": "Querellado",
              "situacionLibertad": "Libre"
            }
          ],
          "materia": "Querella",
          "tribunal": "JUZGADO DE GARANTÍA FICTICIO",
          "ultimaActualizacionCasoPenal": "2026-08-10",
          "esDenunciado": true
        }
      ],
      "totalPenal": 1,
      "datosNoticias": [
        {
          "nombre": "JUAN PEREZ SOTO",
          "titulo": "Formalizan a concejal por estafa",
          "fuente": "La Tercera",
          "enlace": "https://www.latercera.com/noticia-ficticia",
          "enlaceFuente": "https://www.latercera.com",
          "tema": ["Fraude"],
          "periodo": "10/08/2026"
        }
      ],
      "totalNoticias": 1
    }
  }
}

Respuesta para persona jurídica

Success

Status code: 200

Example response body:

{
  "success": true,
  "data": {
    "perfil": {
      "id": 6,
      "nombreCompleto": "EMPRESA FICTICIA SPA",
      "tipoPersona": "juridica",
      "toleranciaBusqueda": 0,
      "pais": "Chile",
      "estado": "COMPLETADO",
      "riesgo": "medium",
      "monitoreo": false,
      "fechaCarga": "12-08-2026 16:20:00",
      "ultimaActualizacion": "12-08-2026 16:21:10",
      "marshal": null
    },
    "resultado": {
      "nombreCompleto": "EMPRESA FICTICIA SPA",
      "tipPersona": "juridica",
      "toleranciaBusqueda": 0,
      "resumen": {
        "mallaSocietaria": { "totalResultados": 1, "riesgo": "free" },
        "pepChile": { "totalResultados": 0, "riesgo": "free" },
        "funcionariosPublicos": { "totalResultados": 0, "riesgo": "free" },
        "pepChileFamiliares": { "totalResultados": 0, "riesgo": "free" },
        "listasInternacionales": { "totalResultados": 1, "riesgo": "medium" },
        "penal": { "totalResultados": 0, "riesgo": "free" },
        "noticias": { "totalResultados": 0, "riesgo": "free" }
      },
      "riesgo": "medium",
      "datosMallaSocietaria": [
        {
          "nombreSociedad": "EMPRESA FICTICIA SPA",
          "rutSociedad": "76123456-0",
          "nombreSocio": null,
          "rutSocio": null,
          "fecha": "2021-06-02",
          "socios": [
            {
              "nombre": "SOCIO FICTICIO UNO",
              "rut": "11111111-1",
              "domicilio": null,
              "tipoDeParticipacion": "Socio",
              "cargo": null,
              "cargoEjecutivoPrincipal": null,
              "fechaNombramiento": null,
              "porcentajeParticipacion": "100"
            }
          ],
          "extractos": [],
          "ultimaFecha": "2021-06-02",
          "fuente": null
        }
      ],
      "totalMallaSocietaria": 1,
      "datosPepChile": [],
      "totalPepChile": 0,
      "datosFuncionarioPublico": [],
      "totalFuncionarioPublico": 0,
      "datosFamiliarPep": [],
      "totalFamiliarPep": 0,
      "datosListasInternacionales": [
        {
          "nombre": "EMPRESA FICTICIA SPA",
          "lista": "CMF - Sanciones",
          "enlace": "https://www.cmfchile.cl/sitio/EJEMPLO",
          "tipo": "list",
          "codigoPais": null,
          "activo": null
        }
      ],
      "totalListasInternacionales": 1,
      "datosPenal": [],
      "totalPenal": 0,
      "datosNoticias": [],
      "totalNoticias": 0
    }
  }
}

Success (búsqueda no completada)

Mientras el perfil está EN_CURSO, o si quedó FALLIDO, resultado viaja en null:

{
  "success": true,
  "data": {
    "perfil": {
      "id": 8,
      "nombreCompleto": "MARIA GONZALEZ ROJAS",
      "tipoPersona": "natural",
      "toleranciaBusqueda": 1,
      "pais": null,
      "estado": "EN_CURSO",
      "riesgo": null,
      "monitoreo": false,
      "fechaCarga": "14-08-2026 10:00:00",
      "ultimaActualizacion": null,
      "marshal": null
    },
    "resultado": null
  }
}

Campos de `resultado`

Campo	Tipo	Descripción
`nombreCompleto`	`string`	Nombre o razón social buscado.
`tipPersona`	`string`	`"natural"` o `"juridica"`.
`toleranciaBusqueda`	`number`	Tolerancia de la búsqueda: `0` (exacta) a `2` (más flexible).
`resumen`	`object`	Resumen por fuente (ver tabla siguiente).
`riesgo`	`string`	Riesgo agregado del perfil: `"free"`, `"medium"` o `"critical"`.
`datosMallaSocietaria`	`array`	Sociedades relacionadas (ver campos anidados).
`totalMallaSocietaria`	`number`	Cantidad de elementos de `datosMallaSocietaria`.
`datosPepChile`	`array`	Coincidencias en PEP Chile.
`totalPepChile`	`number`	Total de coincidencias en PEP Chile.
`datosFuncionarioPublico`	`array`	Coincidencias en funcionarios públicos.
`totalFuncionarioPublico`	`number`	Total de coincidencias en funcionarios públicos.
`datosFamiliarPep`	`array`	Coincidencias en familiares de PEP.
`totalFamiliarPep`	`number`	Total de coincidencias en familiares de PEP.
`datosListasInternacionales`	`array`	Coincidencias en listas internacionales y, si la búsqueda tiene país, en listas por país.
`totalListasInternacionales`	`number`	Total de coincidencias en listas.
`datosPenal`	`array`	Antecedentes penales.
`totalPenal`	`number`	Total de antecedentes penales.
`datosNoticias`	`array`	Noticias relevantes.
`totalNoticias`	`number`	Total de noticias.

Campos dentro de resumen. Cada fuente es un objeto con totalResultados (number, con todas las coincidencias encontradas) y riesgo ("free", "medium" o "critical"). Solo aparecen las fuentes que tienen un resultado registrado:

Campo	Descripción
`mallaSocietaria`	Resumen de malla societaria.
`pepChile`	Resumen de PEP Chile.
`funcionariosPublicos`	Resumen de funcionarios públicos.
`pepChileFamiliares`	Resumen de familiares de PEP.
`listasInternacionales`	Resumen de listas internacionales.
`penal`	Resumen de antecedentes penales.
`noticias`	Resumen de noticias.

Campos dentro de cada elemento de datosMallaSocietaria (una fila por cada par socio–sociedad):

Campo	Tipo	Descripción
`nombreSociedad`	`string`	Nombre de la sociedad.
`rutSociedad`	`string`	RUT de la sociedad; puede ser `null`.
`nombreSocio`	`string`	Nombre de la persona buscada en esa sociedad; `null` en personas jurídicas.
`rutSocio`	`string`	RUT de la persona buscada en esa sociedad; `null` en personas jurídicas.
`fecha`	`string`	Fecha de constitución (formato `YYYY-MM-DD`); puede ser `null`.
`socios`	`array`	Socios: `nombre`, `rut`, `domicilio`, `tipoDeParticipacion`, `cargo`, `cargoEjecutivoPrincipal`, `fechaNombramiento` y `porcentajeParticipacion`.
`extractos`	`array`	Extractos: `actuacion`, `fecha` y `linkPdf`.
`ultimaFecha`	`string`	Última fecha conocida de la sociedad; puede ser `null`.
`fuente`	`string`	Fuente de la relación (ej: `"Diario Oficial"`, `"Empresa en un Día"`); `null` en personas jurídicas.

Campos dentro de cada elemento de datosPepChile y datosFuncionarioPublico:

Campo	Tipo	Descripción
`nombre`	`string`	Nombre de la persona.
`cargo`	`string`	Cargo o posición.
`institucion`	`string`	Institución asociada.
`periodo`	`string`	Periodo del cargo; puede ser `null`.

Campos dentro de cada elemento de datosFamiliarPep:

Campo	Tipo	Descripción
`nombre`	`string`	Nombre del familiar PEP.
`cargo`	`string`	Cargo o posición.
`institucion`	`string`	Institución asociada.
`enlace`	`string`	URL con información adicional; puede ser `null`.
`periodo`	`string`	Periodo; puede ser `null`.
`datosRelaciones`	`array`	Familiares declarados, tal como los publica la fuente (incluyen `nombre`).

Campos dentro de cada elemento de datosListasInternacionales:

Campo	Tipo	Descripción
`nombre`	`string`	Nombre en la lista, o el país cuando la coincidencia es por país.
`lista`	`string`	Nombre de la lista.
`enlace`	`string`	URL del registro; puede ser `null`.
`tipo`	`string`	Solo si la búsqueda tiene país: `"list"` (lista internacional) o `"country"` (lista por país).
`codigoPais`	`string`	Solo si la búsqueda tiene país: código del país en las coincidencias por país.
`activo`	`boolean`	Solo si la búsqueda tiene país: indica si el país sigue en la lista.

Campos dentro de cada elemento de datosPenal:

Campo	Tipo	Descripción
`nombre`	`string`	Nombre del sujeto.
`postura`	`string`	Postura en el proceso (ej: Querellante, Querellado).
`rol`	`string`	Rol o número de causa.
`fecha`	`string`	Fecha de la causa (formato `DD/MM/YYYY`).
`infraccion`	`string`	Descripción de la infracción.
`estado`	`string`	Estado procesal.
`etapa`	`string`	Etapa del proceso.
`litigantes`	`array`	Litigantes con `nombre`, `sujeto` y `situacionLibertad`.
`materia`	`string`	Materia del proceso.
`tribunal`	`string`	Tribunal asociado.
`ultimaActualizacionCasoPenal`	`string`	Fecha de la última actualización de la causa.
`esDenunciado`	`boolean`	Indica si el sujeto figura como denunciado.

Campos dentro de cada elemento de datosNoticias:

Campo	Tipo	Descripción
`nombre`	`string`	Nombre buscado.
`titulo`	`string`	Título de la noticia.
`fuente`	`string`	Medio o fuente.
`enlace`	`string`	URL de la noticia.
`enlaceFuente`	`string`	URL del medio.
`tema`	`array`	Temas asociados.
`periodo`	`string`	Fecha de publicación (formato `DD/MM/YYYY`), o `"-"` si la fuente no la informa.

Nota: los campos sin información viajan en null y los arreglos sin coincidencias, como [].

Errores

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

400 - Parámetros inválidos

El id de la ruta no es un entero positivo. Usa el id que entrega Listar perfiles.

{
  "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

Tu plan no incluye el módulo de compliance.

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

404 - Perfil no encontrado

El perfil no existe, no pertenece a tu cuenta o ya no está activo.

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

Detalle de API​

Request​

Parámetros de ruta (path)​

Ejemplo request con curl​

Response​

Diferencias por tipo de persona​

Respuesta para persona natural​

Respuesta para persona jurídica​

Campos de resultado​

Errores​

400 - Parámetros inválidos​

401 - No autorizado​

403 - Plan sin el módulo de compliance​

404 - Perfil no encontrado​

429 - Demasiadas solicitudes​

500 - Error interno del servidor​