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

# Get entity monitoring history

> GET /entities/{id}/monitoring/history — subscriptions and screening change timeline — in the gu1 entity monitoring service for ongoing screening.

```
GET http://api.gu1.ai/entities/{id}/monitoring/history
```

## Authentication

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

Requires **read** permission on the entity.

## Path Parameters

<ParamField path="id" type="string" required>
  Entity UUID.
</ParamField>

## Query

<ParamField query="tab" type="string" required>
  * `subscriptions` — watchlist lifecycle (activated/deactivated).
  * `changes` — snapshots and periodic screening detections.
</ParamField>

<ParamField query="limit" type="integer">
  Page size (default 20, max 100).
</ParamField>

<ParamField query="offset" type="integer">
  Pagination offset.
</ParamField>

<ParamField query="integrationCode" type="string">
  Optional. Defaults to the Gu1 sanctions enrichment integration code.
</ParamField>

<ParamField query="currentlyOnWatchlist" type="string">
  Only with `tab=subscriptions`. Use `1`, `true`, or `yes` to include open active ranges.
</ParamField>

## Examples

```bash theme={null}
curl -sS "http://api.gu1.ai/entities/{id}/monitoring/history?tab=subscriptions&limit=20&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -sS "http://api.gu1.ai/entities/{id}/monitoring/history?tab=changes&limit=20&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"
```