# List Freezes

Your tenant's freezes, newest first — the tenant's own included, if Aurea placed one.

## Overview

- `status`: `active` (default) — in force now; `lifted` — lifted, or past its `until`; `all`. `target`: `tenant`, `user`, `wallet` or `account`. `limit`: 1–200, default 50.
- `frozenByPlatform` `true`: an Aurea administrator placed it, and only one lifts it.
- For the tenant roles `owner`, `tenantadmin`, `non_signing_admin`, `auditor`, `security_admin` and `security_auditor`, on their own tenant.

## Endpoint

### `GET /v1/admin/tenants/{id}/freezes`

Authentication: bearer token required.

The tenant's freezes, newest first.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | Tenant UUID |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `target` | string | no | `tenant`, `user`, `wallet` or `account` |
| `status` | string | no | `active` (default), `lifted` or `all` |
| `limit` | integer | no | 1–200, default 50 |

**Responses**

`200` OK

```json
{
  "data": [
    {
      "id": "a3e9c1d7-5b2f-4e86-9d0a-7c4b1e8f2d63",
      "target": "wallet",
      "targetId": "7c1e9b24-3f5a-4d8e-9b6c-1a2f3e4d5c6b",
      "tenantId": "6f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0",
      "reason": "Device reported stolen",
      "frozenBy": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d",
      "frozenByRole": "security_admin",
      "frozenByPlatform": false,
      "frozenAt": "2026-10-06T10:42:05.118Z",
      "until": null,
      "active": true,
      "liftedAt": null,
      "liftedBy": null,
      "liftedByRole": null,
      "liftReason": null
    }
  ]
}
```

---

Web version: https://docs.aureahub.com/#freezes-list