# Get a token's freeze history

Returns every freeze and release requested on a token, filterable by target, case reference and date range, with who requested each one and whether it went on chain.

Request: GET /api/v1/token-freeze-history

> Part of the SQRL documentation, section "API Reference".
> Rendered page: https://docs.sqrl.tech/api/token-freeze-history

Each entry is one freeze or release: who did what to which target, when, under
which reason and case. `call_status` tells a freeze that went on chain
(`BROADCAST`) from one that was only requested and is still collecting signatures
(`PENDING`), so an auditor can tell the two apart.

```bash tab="cURL"
curl "$SQRL_API/api/v1/token-freeze-history?contract_uid=512&workspace_id=342&case_reference=CASE-2048" \
  -H "authorization: Bearer $SQRL_TOKEN"
```

{`{
  "entries": [
    {
      "call_uid": 9182,
      "contract_uid": 512,
      "action": "freeze",
      "target": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "reason_code": 1,
      "reason_label": "Sanctions screening hit",
      "case_reference": "CASE-2048",
      "created_by": 4088,
      "created_at": "2026-11-02T09:41:07Z",
      "call_status": "BROADCAST"
    }
  ]
}`}