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

# AML Screening

> Screen a name + DOB against 1,300+ sanctions, PEP, and adverse-media databases.

## Request

```bash theme={null}
curl -X POST https://identity.contra.id/v1/aml \
  -H "x-api-key: $CONTRA_KEY" -H "Content-Type: application/json" \
  -d '{
    "full_name":      "John Smith",
    "date_of_birth":  "1985-04-22",
    "country":        "US",
    "lists": ["OFAC_SDN", "EU_CONSOLIDATED", "UN_SC", "PEP", "ADVERSE_MEDIA"]
  }'
```

## Response · 200

```json theme={null}
{
  "aml_id": "aml_91c1…",
  "risk_band": 1,
  "hits": [],
  "score": 12.4,
  "checked_lists": ["OFAC_SDN", "EU_CONSOLIDATED", "UN_SC", "PEP", "ADVERSE_MEDIA"]
}
```

`risk_band`: `1` (low) → `5` (high). Scores ≥ 80 auto-decline by default; configurable per workflow.
