Tutorial / 8 min read / 2026-07-19
Integrate AML Screening and Event Polling
Screen a customer, send AML events, and poll event results using the tenant-scoped externalEventId.
AML integrations usually need two paths: synchronous screening for customer or entity checks, and event ingest for transaction or counterparty monitoring. Use a stable externalEventId when polling write-back results.
Send an AML Event
POST /api/v1/aml/events
x-api-key: naiza_api_sk_live_...
{
"eventName": "payment.completed",
"eventCategory": "TRANSACTION",
"externalEventId": "aml_evt_ext_123",
"customer": { "externalId": "user_123456", "email": "user@example.com" },
"metadata": { "amount": 99.99, "currency": "USD" }
}Poll the Result
GET /api/v1/aml/events/aml_evt_ext_123CLEARmeans the event did not create an AML alert.ALERTEDmeans the event created one or more alerts.HELDmeans the event is waiting for an AML workflow outcome.APPROVEDandREJECTEDare forward-compatible statuses for downstream write-back.
Open the AML product page for a product overview.