> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoramento de entidades

> Screening contínuo de listas vigiadas por integração no gu1 (sanções, PEP, mídia adversa), separado do monitoramento de transações.

## Escopo

Esta seção documenta o **monitoramento em nível de entidade** (watchlist / screening periódico ligado a enrichments), sob o prefixo `GET/PATCH /entities/...`.

Não confundir com **Monitoramento de transações** (KYT / alertas de pagamentos), em **Casos de uso → Monitoramento de transações**.

## Fluxo típico (Gu1 sanções)

1. **Marketplace**: ativar a integração e o **monitoramento** da org para `global_gueno_sanctions_enrichment`.
2. **Onboarding**: ao criar a entidade, enviar `monitoring` + `autoExecuteIntegrations` conforme [Criar entidade](/pt/api-reference/entities/create) ou [Criar automático](/pt/api-reference/entities/create-automatic).
3. **Operação**: consultar estado e histórico nas páginas de **Referência API** deste grupo.
4. **Ativar / desativar**: `PATCH /entities/toggle-status-monitoring` com `entityId`, `integrationCode` e `active`.

## Referência API

<CardGroup cols={2}>
  <Card title="Estado do monitoramento" icon="signal" href="/pt/monitoring/api-reference/get-entity-monitoring">
    `GET /entities/{id}/monitoring`
  </Card>

  <Card title="Histórico" icon="clock-rotate-left" href="/pt/monitoring/api-reference/get-entity-monitoring-history">
    `GET /entities/{id}/monitoring/history`
  </Card>

  <Card title="Estado do monitoramento por integração" icon="toggle-on" href="/pt/monitoring/api-reference/patch-toggle-status-monitoring">
    `PATCH /entities/toggle-status-monitoring`
  </Card>
</CardGroup>

## Guia estendido (repositório)

Guia de cliente com exemplos JSON: `docs/es/guias/monitoreo-sanciones-gueno-cliente.md` (espanhol; replicar em PT no repositório se necessário).