Authentication
Authenticate with a Bearer API key, what each scope allows, how keys are issued and rotated, and what a 401 or 403 means.
Address checks
Screen an address with POST /v1/checks and read every field of the verdict, from score and band to findings, partial flags, coverage limits and the pin.
Transaction checks
Screen a deposit or a withdrawal with POST /v1/checks, including leaving out the address on TRX, ETH, BNB and BASE, and the ADDRESS_REQUIRED and TRANSACTION_UNRESOLVED outcomes.
Pending and polling
Why a check can answer pending, what pending_reason, deadline_at and next_attempt_at mean, and how to poll GET /v1/checks/{check_id} until the check is terminal.
Batch
Submit up to 100 address or transaction checks in one request with POST /v1/checks/batch, how admission works, and how to read the results.
Webhooks
Register an endpoint, receive a signed check.completed delivery for every finished check, verify its x-aml-signature header, and handle retries and secret rotation.
Idempotency
Send an Idempotency-Key so a retried request never screens or charges twice, and what each outcome of a reused key means.
Rate limits and quotas
The per-minute request limits, how a check is paid for (quota first, then prepaid balance), which checks are free, and what to do on 429 and 402.
Sandbox and live
How sandbox and live keys differ, what a sandbox verdict is built from, and the test address that always answers pending.
Evidence reports
Open the PDF and JSON evidence report of a completed check, choose its language and design, and confirm a report is genuine with its registered hash.
Rederive
Replay a past verdict under the ruleset and label snapshot it was issued at, with a findings digest, a label provenance check and a report hash check. Free, and no provider is called.
Address reports
Report an address you know to be abusive, or confirm one of your own deposit addresses, with POST /v1/address-reports, and what happens to a report afterwards.
Supported assets
Which assets Leeri screens, how deeply each is covered, and when a transaction check may leave out the address.
Errors
The error envelope, how to react to each failure, and every error code with its HTTP status and condition.