> 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/remove-an-aml-screening-address.md).

# Remove an AML Screening Address

Remove an AML Screening record using its `id` from `/v1/aml_screening_query`. The record must belong to the current user and must not already be deleted. This endpoint is only available to Compliance/Enterprise Plan users.

```shell
POST https://openapi.misttrack.io/v1/aml_screening_remove
```

## Request

| Header       | Value            |
| ------------ | ---------------- |
| Content-Type | application/json |

JSON Body

<table><thead><tr><th width="101.8359375">Parameter</th><th width="117.859375">Type</th><th width="92.21875">Required</th><th>Description</th></tr></thead><tbody><tr><td>api_key</td><td>string</td><td>yes</td><td>Your API key.</td></tr><tr><td>id</td><td>int or decimal string</td><td>yes</td><td>Positive record ID returned by <code>/v1/aml_screening_query</code>. An address string is not accepted in place of the ID.</td></tr></tbody></table>

Request Example

```shell
curl --location 'https://openapi.misttrack.io/v1/aml_screening_remove' \
  --header 'Content-Type: application/json' \
  --data '{
    "api_key": "YourApiKey",
    "id": 102
  }'
```

## Response

On success, the record is marked as deleted and its status is set to Paused. The record no longer appears in the results of `/v1/aml_screening_query`, but it remains in the database. It can be restored by submitting the same address again for the same user.

Sample Response

```json
{
  "success": true,
  "msg": "",
  "data": {
    "id": 102
  }
}
```

## Error Responses

<table><thead><tr><th width="115.40234375">HTTP Status</th><th>Response</th><th>Meaning</th></tr></thead><tbody><tr><td>200</td><td><code>{"success": false, "msg": "InvalidPostJson"}</code></td><td>The POST body is not valid JSON.</td></tr><tr><td>200</td><td><code>{"success": false, "msg": "InvalidParameter"}</code></td><td>The body is not an object, or <code>id</code> is missing, non-numeric, zero, negative, or a boolean.</td></tr><tr><td>200</td><td><code>{"success": false, "msg": "InvalidApiKey"}</code></td><td>API key is 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><tr><td>404</td><td><code>{"success": false, "msg": "RecordNotFound"}</code></td><td>The ID does not identify an active record owned by this user.</td></tr></tbody></table>

A non-POST request returns plain text `Only POST allow` rather than JSON.
