---
title: "Create an AML screening"
method: POST
path: "/aml-verifications"
tags: ["AML Screening"]
---

# Create an AML screening

`POST /aml-verifications`

## Request

- Base URL: `https://identity-verification.checkout.com`
- URL: `https://identity-verification.checkout.com/aml-verifications`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `string` scopes: `identity-verification`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/aml-verifications/post.ts> (a function with typed inputs; its response is checked against the schema)

<span style="font-size: 12px; font-weight: 500; color: rgb(0, 0, 0); background-color: rgb(255, 176, 97); border-radius: 4px; padding: 2px 6px" >Beta</span><p></p>
 Create an [AML screening](https://www.checkout.com/docs/business-operations/manage-identities/screen-aml-databases).

If the request is successful, you receive a `201 Created` response with the AML screening resource.

## Request body

- AmlVerification
  - `created_on` string, date-time, required: The date and time when the resource was created, in UTC. <br/>Format – `yyyy-mm-ddThh:mm:ss.sss`
  - `modified_on` string, date-time, required: The date and time when the resource was modified, in UTC. <br/>Format – `yyyy-mm-ddThh:mm:ss.sss`
  - `status` 'created' | 'screening_in_progress' | 'approved' | 'declined' | 'review_required', required: The [screening status](https://www.checkout.com/docs/developer-resources/codes/identities-codes#Check_statuses).
  - `applicant_id` string, required: The applicant's unique identifier.
  - `search_parameters` SearchParameters, required: The screening's configuration details.
    - `configuration_identifier` string, required: Your AML Screening [configuration ID](https://www.checkout.com/docs/business-operations/manage-identities/screen-aml-databases#Configuration).
  - `monitored` boolean: Indicates whether to continue to [monitor the applicant's AML status](https://www.checkout.com/docs/business-operations/manage-identities/screen-aml-databases#Configure_monitoring).
  - `_links` AmlVerificationLinks, required: The details of links related to the resource.
    - `self` IdvHalLink, required: The URL to the applicant profile resource.
      - `href` string, uri, required
  - `id` string, required: The AML screening's unique identifier.

## Response `201`

AML screening created successfully

- AmlVerificationOutput
  - `created_on` string, date-time, required: The date and time when the resource was created, in UTC. <br/>Format – `yyyy-mm-ddThh:mm:ss.sss`
  - `modified_on` string, date-time, required: The date and time when the resource was modified, in UTC. <br/>Format – `yyyy-mm-ddThh:mm:ss.sss`
  - `status` 'created' | 'screening_in_progress' | 'approved' | 'declined' | 'review_required', required: The [screening status](https://www.checkout.com/docs/developer-resources/codes/identities-codes#Check_statuses).
  - `applicant_id` string, required: The applicant's unique identifier.
  - `search_parameters` SearchParameters, required: The screening's configuration details.
    - `configuration_identifier` string, required: Your AML Screening [configuration ID](https://www.checkout.com/docs/business-operations/manage-identities/screen-aml-databases#Configuration).
  - `monitored` boolean: Indicates whether to continue to [monitor the applicant's AML status](https://www.checkout.com/docs/business-operations/manage-identities/screen-aml-databases#Configure_monitoring).
  - `_links` AmlVerificationLinks, required: The details of links related to the resource.
    - `self` IdvHalLink, required: The URL to the applicant profile resource.
      - `href` string, uri, required
  - `id` string, required: The AML screening's unique identifier.

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)