---
title: AML Screening
description: "GET https://api.icomplykyc.com/api/v2/aml/:id Get AML screen search results by entity ID Authentication Type: API Key Sample Query: https://api.icomplykyc.com/api/v2/aml/1234567e-fcff-4c10-9dd3-da7442"
---

[Skip to content](https://support.icomplyis.com/aml-screening#main-content)

English

Show submenu for translations

[More support](https://support.icomplyis.com/kb-tickets/new?hsLang=en) [Sign in](https://support.icomplyis.com/_hcms/mem/login?redirect_url=https%3A%2F%2Fsupport.icomplyis.com%2Faml-screening&hsLang=en)

![iComply Logo Square.jpg\]](https://support.icomplyis.com/hs-fs/hubfs/iComply%20Logo%20Square.jpg?height=40&name=iComply%20Logo%20Square.jpg)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [More support](https://support.icomplyis.com/kb-tickets/new)
- [Sign in](https://support.icomplyis.com/_hcms/mem/login?redirect_url=https%3A%2F%2Fsupport.icomplyis.com%2Faml-screening)
- [Platform Login](https://kyc.icomplykyc.com/auth/login)

[Platform Login](https://kyc.icomplykyc.com/auth/login)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [iComply Knowledge Base](https://support.icomplyis.com/?hsLang=en)
2. [iComply API Documentation](https://support.icomplyis.com/icomply-api-documentation?hsLang=en)
3. [API Reference](https://support.icomplyis.com/icomply-api-documentation?hsLang=en#api-reference)

- [Quick Start Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#main-content)
  
  
  
  
  
    - [Admin User Setup Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#admin-user-setup-guide)
    - [Portal Setup Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#portal-setup-guide)
    - [Platform User Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#platform-user-guide)
- [Product Documentation](https://support.icomplyis.com/product-documentation?hsLang=en#main-content)
  
  
  
  
  
    - [General](https://support.icomplyis.com/product-documentation?hsLang=en#general)
    - [Platform Overview](https://support.icomplyis.com/product-documentation?hsLang=en#platform-overview)
    - [KYC Module](https://support.icomplyis.com/product-documentation?hsLang=en#kyc-module)
    - [KYB Module](https://support.icomplyis.com/product-documentation?hsLang=en#kyb-module)
    - [AML Module](https://support.icomplyis.com/product-documentation?hsLang=en#aml-module)
    - [Administration](https://support.icomplyis.com/product-documentation?hsLang=en#administration)
    - [Portals](https://support.icomplyis.com/product-documentation?hsLang=en#portals)
    - [Troubleshoot](https://support.icomplyis.com/product-documentation?hsLang=en#troubleshoot)
    - [FAQ](https://support.icomplyis.com/product-documentation?hsLang=en#faq)
    - [Compliance](https://support.icomplyis.com/product-documentation?hsLang=en#compliance)
    - [Release Notes](https://support.icomplyis.com/product-documentation?hsLang=en#release-notes)
- [iComply API Documentation](https://support.icomplyis.com/icomply-api-documentation?hsLang=en#main-content)
  
  
  
  
  
    - [API Reference](https://support.icomplyis.com/icomply-api-documentation?hsLang=en#api-reference)
- [FAQs](https://support.icomplyis.com/faqs?hsLang=en#main-content)
  
  
  
  
  
    - [Product](https://support.icomplyis.com/faqs?hsLang=en#product)

# AML Screening

**GetAMLSearchByID**

`GET` `https://api.icomplykyc.com/api/v2/aml/:id`

Get AML screen search results by entity ID

**Authentication Type:** API Key

**Sample Query:** [https://api.icomplykyc.com/api/v2](https://api.icomplykyc.com/api/v2)/aml/1234567e-fcff-4c10-9dd3-da74422e1c30

**Path Parameters** 

| Name | Type | Description |
| --- | --- | --- |
| id | String | Entity ID of the Legal Entity |

200: OK 

```
{    "code": 200,    "status": "success",    "message": "",    "data": {        "id": 591,        "ongoing": false,        "screenDate": "2020-12-04",        "nextReview": "2022-12-04",        "searchTerm": "John Doe",        "searchTypes": [            "person"        ],        "searchFuzziness": 40,        "searchCoverage": [            "Warning",            "Pep Class 1"        ],        "pending": 17,        "accepted": 0,        "unknown": 0,        "sanctions": 0,        "politicalExposure": 0,        "adverseMedia": 0,        "linkedEntityIds": [            "04831052-235e-4de5-be35-eb9c4ddb33e4",            "07675e44-c422-44da-b2a1-177c37293c4e"        ]    }}
```

404: Not Found

```
{    "code": 404,    "status": "failure",    "message": "there is no aml search with given id",    "data": null}
```

 

**Add AML Search**

**Sample Request Body**

To create a new AML search, initiate a POST request to [https://api.icomplykyc.com/api/v2](https://api.icomplykyc.com/api/v2)**/aml** with the following JSON payload.

```
{    "ongoing": false,    "searchTerm": {        "name": "John Doe",        "yearOfBirth": 1969,        "countries": ["US"]    },    "searchType": "person",    "searchFuzziness": 40,    "searchCoverage": ["sanctions", "warning", "pep-class-1"],    "linkedEntityIds": ["04831052-235e-4de5-be35-eb9c4ddb33e4", "07675e44-c422-44da-b2a1-177c37293c4e"]}
```

 

**AddAMLSearch**

`POST` `https://api.icomplykyc.com/api/v2/aml`

Start a new AML screening search based on the specified parameters.

**Authentication Type:** API Key

**Sample Query:** [https://api.icomplykyc.com/api/v2](https://api.icomplykyc.com/api/v2)/aml

**Request Body**

| Name | Type | Description |
| --- | --- | --- |
| Raw\* | JSON | See sample payload above |

200: OK 

```
{    "code": 201,    "status": "success",    "message": "",    "data": {        "id": "591"    },    "errors": []}
```

400: Bad Request

```
{    "code": 400,    "status": "failure",    "messsage": "you need to provide 'name' (string) under AML search term object",    "data": null}
```

# iComply Investor Services Inc - icomplyis.com

icomplyis.com Help Center

Copyright © 2025, iComply Investor Services Inc - icomplyis.com