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

# AML Screening Business

> Prevent fraudulent businesses from your platform by screening by via PEP, OFAC, AML, Sanction and Adverse media across 200+ countries and 42800+ databases

### Request

```http [POST] theme={null}
{{baseUrl}}api/v1/aml/screening/organization
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `<key>` not `Bearer <key>`                                                  |

### Body parameters

| Parameter    | Type    | Description                                                                                 | Required |
| ------------ | ------- | ------------------------------------------------------------------------------------------- | -------- |
| entity\_name | string  | Business Name, e.g  Belinda Gates Foundation                                                | required |
| match\_score | integer | Name Match Scores ranges from 0% to 100 %, which determine the accuracy of the match result | required |

### Sample response

```json Response theme={null}
{
  "matchResults": [
    {
       "MatchType": "Entity",
       "Name": "Gates Foundation",
       "ProfileId": "57994afb-357b-4288-bc5d-9f3954d037e3",
       "NameMatchScore": 0.2
    }
  ]
}
```

### Response Fields

| Field                          | Type   | Description                                            |
| ------------------------------ | ------ | ------------------------------------------------------ |
| matchResults                   | array  | List of matched entities from AML screening            |
| matchResults\[].MatchType      | string | Type of entity matched (e.g., "Entity")                |
| matchResults\[].Name           | string | Name of the matched entity                             |
| matchResults\[].ProfileId      | string | Unique profile identifier for the matched entity       |
| matchResults\[].NameMatchScore | number | Score indicating how closely the name matched (0 to 1) |

### AML Categories

adverse\_media, sanction, warning, PEP

### Enhanced Match Scoring Logic

The system will prioritize search results as follows:

* Sanctions over other AML types
* Exact name match over inexact name match
* Date of Birth (DOB) match over no DOB match
* Country match over no country match over country mismatch

### Sanctions

* 1.1 - Fuzzy match with country mismatch
* 1.2 - Fuzzy match
* 1.3 - Fuzzy match with country match
* 1.4 - Fuzzy match with YOB match
* 1.5 - Fuzzy match with YOB and country match
* 1.6 - Exact match with country mismatch
* 1.7 - Exact match
* 1.8 - Exact match with country match
* 1.9 - Exact match with YOB match
* 2.0 - Exact match with YOB and country match

### Warnings, PEPs, AMs

* 0.1 - Fuzzy match with country mismatch
* 0.2 - Fuzzy match
* 0.3 - Fuzzy match with country match
* 0.4 - Fuzzy match with YOB match
* 0.5 - Fuzzy match with YOB and country match
* 0.6 - Exact match with country mismatch
* 0.7 - Exact match
* 0.8 - Exact match with country match
* 0.9 - Exact match with YOB match
* 1.0 - Exact match with YOB and country match