> For the complete documentation index, see [llms.txt](https://docs.misttrack.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.misttrack.io/for-compliance-plan/query-aml-screening-addresses.md).

# Query AML Screening Addresses

Lists the current user's non-deleted AML Screening addresses. This endpoint is only available to Compliance/Enterprise Plan users.

```shell
GET https://openapi.misttrack.io/v1/aml_screening_query?api_key=YourApiKey
```

> Try this endpoint in your [browser](https://openapi.misttrack.io/v1/aml_screening_query?api_key=YourApiKey) 🔗

## Request

Query Parameters

| Parameter | Type   | Required | Description   |
| --------- | ------ | -------- | ------------- |
| api\_key  | string | yes      | Your API key. |

## Response

`data` is an array ordered by newest `add_time`, then highest `id`. Each record contains these six fields:

<table><thead><tr><th width="105.015625">Parameter</th><th width="124.67578125">Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>int</td><td>Record ID; pass this to <code>/v1/aml_screening_remove</code> to remove the address.</td></tr><tr><td>coin</td><td>string</td><td>One or more comma-separated coin codes monitored for this address.</td></tr><tr><td>address</td><td>string</td><td>Monitored address.</td></tr><tr><td>add_time</td><td>string</td><td>Time the address was added, in ISO 8601 format.</td></tr><tr><td>note</td><td>string or null</td><td>Note saved with the address.</td></tr><tr><td>status</td><td>string</td><td><code>Active</code> or <code>Paused</code>; <code>Unknown</code> if the stored status is not recognized.</td></tr></tbody></table>

Sample Response

```json
{
  "success": true,
  "msg": "",
  "data": [
    {
      "id": 102,
      "coin": "TRX,USDT-TRC20,USDC-TRC20",
      "address": "TEvwn7VF4KWfWfUSKipy6mFgjxPREPwFk2",
      "add_time": "2026-09-28T10:00:00Z",
      "note": "TRON monitoring",
      "status": "Active"
    },
    {
      "id": 101,
      "coin": "ETH",
      "address": "0xb3065fe2125c413e973829108f23e872e1db9a6b",
      "add_time": "2026-09-27T10:00:00Z",
      "note": "Treasury",
      "status": "Paused"
    }
  ]
}
```

## Error Responses

<table><thead><tr><th width="109.6171875">HTTP Status</th><th>Response</th><th>Meaning</th></tr></thead><tbody><tr><td>200</td><td><code>{"success": false, "msg": "InvalidApiKey"}</code></td><td>API key is missing, invalid, or deleted.</td></tr><tr><td>402</td><td><code>{"success": false, "msg": "ExpiredPlan"}</code></td><td>The API plan has expired.</td></tr><tr><td>403</td><td><code>{"success": false, "msg": "PermissionDenied"}</code></td><td>The user does not have AML Screening access.</td></tr></tbody></table>
