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

# Screen Person

> Screen a person against global sanctions lists, PEP databases, and watchlists.

## Parameters

<ParamField body="name" type="string" required>
  Full name of the person to screen
</ParamField>

<ParamField body="date_of_birth" type="string">
  Date of birth in `YYYY-MM-DD` format
</ParamField>

<ParamField body="nationality" type="string">
  ISO 3166-1 alpha-2 country code (e.g. `US`, `GB`)
</ParamField>

<ParamField body="reference_id" type="string">
  Your internal reference ID for tracking
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST \
    "https://verilock.io/api/v1/aml/screen" \
    -H "Authorization: Bearer qi_live_your_api_key_here" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "John Doe",
      "date_of_birth": "1985-03-15",
      "nationality": "US",
      "reference_id": "cust_9f8a7b6c"
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://verilock.io/api/v1/aml/screen",
      headers={
          "Authorization": "Bearer qi_live_your_api_key_here",
          "Content-Type": "application/json",
      },
      json={
          "name": "John Doe",
          "date_of_birth": "1985-03-15",
          "nationality": "US",
          "reference_id": "cust_9f8a7b6c",
      }
  )

  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "aml_8f3a9b2e-7c4d-4e1f-a6b5-3d2c1e0f9a8b",
    "status": "completed",
    "query": {
      "name": "John Doe",
      "date_of_birth": "1985-03-15",
      "nationality": "US"
    },
    "matches": [
      {
        "name": "John M. Doe",
        "score": 0.87,
        "lists": ["OFAC SDN", "EU Sanctions"],
        "entity_type": "individual",
        "details": {
          "aka": ["J. Doe"],
          "country": "US"
        }
      }
    ],
    "risk_level": "high",
    "screened_at": "2026-03-15T10:30:00Z"
  }
  ```
</ResponseExample>