---
title: "AML Monitoring Webhooks"
method: POST
path: "/aml/monitoring"
tags: ["Webhooks"]
---

# AML Monitoring Webhooks

`POST /aml/monitoring`

Webhook notifications for <a href="https://docs.fourthline.com/docs/aml-overview">AML Monitoring</a>. Configure the `POST /aml` endpoint on your server to receive monitoring notifications. This is the same endpoint used for <a href="ref:aml-screening-webhooks">AML Screening Webhooks</a>. <br /><br />This page contains monitoring-specific examples only. AML Monitoring generates fewer notifications because all monitored clients are screened once per day after the AML database is updated. <br /><br /><img src="https://files.readme.io/ad2486a-Inline_Note.svg" align="left" alt="Note" /> **Note:** For setup instructions, see <a href="https://docs.fourthline.com/docs/webhooks">Webhooks</a>.

## Headers

- `Authorization` string, required — The `access_token` returned in your most recent [Create access token](https://docs.fourthline.com/reference/create-access-token) response.

## Request body

- object
  - `hash` string — Not applicable
  - `processType` string, required — The type of workflow. <br />Expected value: Always `DailyWatchlistAutomation` = AML Screening or Monitoring <br />Validation: Expected value <br />Errors: Must be set to `DailyWatchlistAutomation`.
  - `sla` object — Information about the SLA for our investigation(s).
    - `kycReceived` string — Not applicable
    - `slaStart` string — The timestamp for when the investigation started. <br /><br />Format: ISO 8601 UTC date and time <br /><br />Example: `2020-07-10 15:00:00.000` <br />Validation: Valid datetime <br />Errors: Invalid datetime
    - `slaEnd` string — The timestamp for when the investigation ended. <br /><br />Format: ISO 8601 UTC date and time <br /><br />Example: `2020-07-10 15:00:00.000` <br />Validation: Valid datetime <br />Errors: Invalid datetime
    - `slaPause` string — Not applicable
    - `slaSeconds` integer — The duration of the investigation in seconds.
    - `withinSla` boolean — • `true`: The investigation was completed within the SLA. <br />• `false`: The investigation **wasn’t** completed within the SLA.
    - `slaBucket` 'bucket1' | 'bucket2' | 'bucket3' — The SLA category for the case, as defined in your configuration.
  - `status` 'completed' | 'doNotExist' | 'manualreviewrequired' | 'other' | 'pendingManualReview' | 'recentlyScreened' | 'scheduled' | 'screeningInProgress' | 'wrongMonitoringType', required — The [screening/monitoring status](https://docs.fourthline.com/docs/aml-statuses). <br />Validation: Valid enum value <br />Errors: Invalid enum value.
  - `clientId` string, required — Our unique identifier for the AML client. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0` <br />Validations: uuid format, `clientId` exists <br />Errors: Format is incorrect or doesn’t exist
  - `providerClientId` string, required — Your unique identifier for the AML client.
  - `verificationId` string — Our unique identifier for the investigation. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
  - `messages` AMLMessages[], required — Information about any completed investigations.
    - `verificationId` string — Our unique identifier for the investigation. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
    - `categories` string[] — The [type(s) of hit](https://docs.fourthline.com/docs/aml-integration#hit-types). <br /><br />Format: Array of strings
    - `subcategories` string[] — Any subcategories you have defined for this hit type <br /><br />Format: Array of strings
    - `timestamp` string — The timestamp for when the investigation was completed <br /><br />Format: ISO 8601 UTC date and time <br /><br />Example: `2020-07-10 15:00:00.000` <br />Validation: Valid datetime <br />Errors: Invalid datetime
    - `statusCode` integer — The [status code](https://docs.fourthline.com/docs/aml-statuses#status-codes) providing more information about the status.
    - `description` string, nullable — The status code description. Can be `null` when not provided.
  - `uncompletedMessages` AMLMessages[], required — Information about any incomplete investigations.
    - `verificationId` string — Our unique identifier for the investigation. <br /><br />Format: uuid string <br /><br />Example: `790f325a-48c9-4b82-bb53-c0ea128236f0`
    - `categories` string[] — The [type(s) of hit](https://docs.fourthline.com/docs/aml-integration#hit-types). <br /><br />Format: Array of strings
    - `subcategories` string[] — Any subcategories you have defined for this hit type <br /><br />Format: Array of strings
    - `timestamp` string — The timestamp for when the investigation was completed <br /><br />Format: ISO 8601 UTC date and time <br /><br />Example: `2020-07-10 15:00:00.000` <br />Validation: Valid datetime <br />Errors: Invalid datetime
    - `statusCode` integer — The [status code](https://docs.fourthline.com/docs/aml-statuses#status-codes) providing more information about the status.
    - `description` string, nullable — The status code description. Can be `null` when not provided.

## Response `200`

Return HTTP 2xx to acknowledge receipt. See [Handle webhook deliveries](https://docs.fourthline.com/docs/webhooks#200-ok).

- object — A successful response is empty.

## Other responses

- `401` — Fourthline could not authenticate with your webhook endpoint. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#401-unauthorized).
- `403` — Fourthline could not authenticate with your webhook endpoint. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#403-forbidden).
- `404` — Fourthline can reach your server, but the webhook endpoint could not be found. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#404-not-found).
- `500` — Your server received the request but could not process it successfully. See [troubleshooting](https://docs.fourthline.com/docs/webhooks#500-internal-server-error).

---

[API](https://skmtc.net/fourthline/apis/fourthline-apis.md) · [All operations](https://skmtc.net/fourthline/apis/fourthline-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthline/fourthline-apis/revisions/7991ae7c8383/schema)