> ## 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.

# Entity monitoring

> Continuous watchlist screening per integration in gu1 (sanctions, PEPs, adverse media), distinct from transaction monitoring and rules.

## Scope

This section covers **entity-level monitoring** (watchlist / periodic screening tied to enrichments) under `GET/PATCH /entities/...`.

Do not confuse it with **Transaction monitoring** (KYT / payment alerts), documented under **Use cases → Transaction monitoring**.

## Typical Flow (Gu1 Sanctions)

1. **Marketplace**: enable the integration and org **monitoring** for `global_gueno_sanctions_enrichment`.
2. **Onboarding**: when creating the entity, send `monitoring` + `autoExecuteIntegrations` per [Create entity](/en/api-reference/entities/create) or [Create automatic](/en/api-reference/entities/create-automatic).
3. **Operations**: use the **API Reference** pages in this group for status and history.
4. **Enable / disable**: `PATCH /entities/toggle-status-monitoring` with `entityId`, `integrationCode`, and `active`.

## API Reference

<CardGroup cols={2}>
  <Card title="Monitoring status" icon="signal" href="/en/monitoring/api-reference/get-entity-monitoring">
    `GET /entities/{id}/monitoring`
  </Card>

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

  <Card title="Monitoring status by integration" icon="toggle-on" href="/en/monitoring/api-reference/patch-toggle-status-monitoring">
    `PATCH /entities/toggle-status-monitoring`
  </Card>
</CardGroup>

## Extended Client Guide (Repository)

The end-to-end client guide with JSON examples lives in the repo: `docs/es/guias/monitoreo-sanciones-gueno-cliente.md` (Spanish; mirror to EN/PT in-repo if needed).