# List AML Cases

Your tenant's AML cases — the sanctions-list matches its screening held or refused —, newest first.

## Overview

- Opened only where screening is enforced for your tenant [Coming soon, upon request](https://docs.aureahub.com/docs/feature-availability.md): otherwise the list is empty ([Screening & AML Cases](https://docs.aureahub.com/docs/guide-screening.md)) — except for the `onboarding` cases of [identity verification](https://docs.aureahub.com/docs/guide-identity.md) [Coming soon, upon request](https://docs.aureahub.com/docs/feature-availability.md), which Aurea decides.
- `status` (`open`, `released`, `confirmed`) and `assigneeId` narrow it. Up to `limit` (1–100, default 50) in `data`, and `nextCursor` to send as `cursor` for the next page — `null` on the last.
- Each case with its screening and the decision's reason; the comments are in [Get a Case](https://docs.aureahub.com/docs/aml-case-get.md).
- On the caller's own tenant, for `owner`, `tenantadmin`, `non_signing_admin`, `auditor`, `security_admin` and `security_auditor`.

## A Case

| Field | Meaning |
| --- | --- |
| id, tenantId | The case, and your tenant. `scope` is `tenant`. |
| status | `open`, then `released` or `confirmed` — once. |
| direction | `outbound`: an operation of yours; `inbound`: a transfer your wallet received; `onboarding`: the screening of a user's identity verification ${ON_REQUEST}, decided by Aurea ([Screening & AML Cases › AML Cases](https://docs.aureahub.com/docs/guide-screening.md)). |
| operationId, inboundTransferId, walletId | What the screening matched on: the operation ([Get an Operation](https://docs.aureahub.com/docs/operation-get.md)), or the received transfer, and your wallet. |
| held | `true`: the operation waits for the case in `PENDING_SCREENING` `under_review` — released it goes on, confirmed it is rejected. `false`: it was refused, or it is a received transfer. |
| quarantineId | The quarantine the case decides: the held operation's, or the receiving wallet's ([List Quarantines](https://docs.aureahub.com/docs/quarantines-list.md)); `null` for a refused operation. |
| assigneeId, assignedAt | Who works it, and since when; `null`: nobody. |
| decision | `null` while open; then `outcome` (`released` or `confirmed`), `reason`, `decidedBy`, `decidedRole`, `decidedScope`, `decidedAt`, and `exemptionUntil` — a released refusal's counterparty passes on the way out until then. |
| continuation | A released held operation that went on: `continuedAt`, `resultStatus` (the HTTP status its call answered), `finishedAt`; `null` otherwise. |
| screening | The screening that opened it: `direction`, `point` (the signing point, or `inbound_transfers`), `mode`, `provider` (`public_lists`), `state` (`FROZEN`, `BYPASSED` once released), `result`, `chain`, `chainId`, `family`, `address` (the counterparty as screened), `counterpartyNamed` (its Travel Rule names were screened too), `matches` — each entry's `source`, `entryRef` (the list's own reference), `kind` (`individual`, `entity`, `vessel`, `aircraft`, `other`), `name`, `programs`, `matchedOn` (`address` or `name`), `currency` (the list's tag of the address), `listDate` —, and `lists`, the versions read. |
| createdAt, updatedAt | When it was opened and last changed. |

## Endpoint

### `GET /v1/aml-cases`

Authentication: bearer token required.

Your tenant's AML cases, newest first.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | string | no | `open`, `released` or `confirmed` |
| `assigneeId` | string (uuid) | no | One assignee's cases |
| `cursor` | string (uuid) | no | The previous page's `nextCursor` |
| `limit` | integer | no | 1–100, default 50 |

**Responses**

`200` OK

```json
{
  "data": [
    {
      "id": "5f2a8c1e-7b3d-4e90-a6c2-1d8e4b7f3a95",
      "scope": "tenant",
      "tenantId": "6f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0",
      "status": "open",
      "direction": "outbound",
      "operationId": "1d7a3c52-8e4b-4f19-a0c6-2b9e7d5f3a18",
      "inboundTransferId": null,
      "walletId": "7c1e9b24-3f5a-4d8e-9b6c-1a2f3e4d5c6b",
      "held": true,
      "quarantineId": "9a4d2e6b-1c8f-4b37-a5e0-3f7c9d1b2e84",
      "assigneeId": null,
      "assignedAt": null,
      "decision": null,
      "continuation": null,
      "screening": {
        "id": "c3b7e1a9-5d2f-4c86-9e4a-7b1d3f5c8e20",
        "direction": "outbound",
        "point": "custodial_transfer",
        "mode": "enforce",
        "provider": "public_lists",
        "state": "FROZEN",
        "result": "FLAGGED",
        "reason": null,
        "operationId": "1d7a3c52-8e4b-4f19-a0c6-2b9e7d5f3a18",
        "inboundTransferId": null,
        "walletId": "7c1e9b24-3f5a-4d8e-9b6c-1a2f3e4d5c6b",
        "chain": "base",
        "chainId": 8453,
        "family": "evm",
        "address": "0x7f1c9e2b4a6d8f0e3c5b7a9d1f2e4c6b8a0d3e5f",
        "counterpartyNamed": false,
        "matches": [
          {
            "source": "ofac_sdn",
            "entryRef": "00000",
            "kind": "entity",
            "name": "EXAMPLE SANCTIONED ENTITY",
            "programs": ["CYBER2"],
            "matchedOn": "address",
            "currency": "ETH",
            "listDate": "2026-10-08T00:00:00.000Z"
          }
        ],
        "lists": [
          { "source": "ofac_sdn", "versionId": "e1a7c3d9-2b5f-4e84-9c06-8d3b1f7a5e29", "listDate": "2026-10-08T00:00:00.000Z" },
          { "source": "eu_consolidated", "versionId": "4b9d2f6a-8c1e-4a73-b5d0-6e2c9a1f3b47", "listDate": "2026-10-07T00:00:00.000Z" },
          { "source": "un_consolidated", "versionId": "a3f6c8e1-0d4b-4927-8e5a-1c7b3d9f2e60", "listDate": "2026-10-07T00:00:00.000Z" }
        ],
        "createdAt": "2026-10-13T09:41:12.207Z"
      },
      "createdAt": "2026-10-13T09:41:12.207Z",
      "updatedAt": "2026-10-13T09:41:12.207Z"
    }
  ],
  "nextCursor": null
}
```

**Example request**

```bash
curl "https://api.aureahub.com/v1/aml-cases?status=open" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

---

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