> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST/AML

> Use this API to perform AML (Anti-Money Laundering) screening on an already created Submission.

## 1. Endpoint

```text POST/AML theme={null}
POST https://rest-api.argosidentity.com/v3/submission/aml
```

## 2. Authentification

Include the API key in the x-api-key header:

```text x-api-key theme={null}
x-api-key: {yourAPIKey}
```

## 3. Request Parameters

<ResponseField name="submissionId" type="string" required="true">
  Unique ID of the submission.
</ResponseField>

<ResponseField name="amlThreshold" type="int">
  AML Watch list filtering's threshold.
</ResponseField>

## 4. Request Example

```curl POST/Submission theme={null}
curl --location 'https://rest-api.argosidentity.com/v3/submission/aml' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {yourAPIKey}' \
--data '{
    "submissionId": "sampleSubmissionId11",
    "amlThreshold": 93
}'
```

## 5. Response

### 5-1. Success Response

```json result.json theme={null}
{
    "message": "complete to search AML.",
    "result": "Not Screened",
    "raw_data": {...}
}

```

<Info>
  **AML Screening Result Codes**: For detailed information about the `result` field values (`Not Screened`, `Red Flag`) and risk levels, refer to the [AML Database Sources and Codes](/dashboard/en/aml-source) documentation.
</Info>

### 5-2. Error Response

If an error occurs, the response will include a `400` status code with details in the following format:

```json error.json theme={null}
{
    "errorCode": "invalid_payload",
    "message": "Invalid payload."
}
```

### 5-3. Error Codes

| Error Code              | Message                                     | Description                                                                                            |
| ----------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `invalid_payload`       | Invalid payload                             | The request payload is invalid.                                                                        |
| `missing_parameter`     | submissionId is required                    | A required parameter is missing.                                                                       |
| `invalid_submissionId`  | Cannot find submission.                     | The provided Submission ID is invalid.                                                                 |
| `invalid_country`       | The nationality is invalid: `{nationality}` | The specified nationality is invalid.                                                                  |
| `request_failed`        | Fail to search AML.                         | An unknown error occurred during AML search.                                                           |
| `invalid_aml_threshold` | Invalid AML Threshold.                      | When amlThreshold parameter is omitted, or didn't configure Watch list filtering's score at Dashboard. |

This API enables you to perform AML screening for a specific submission. Refer to the error codes provided to troubleshoot issues effectively.