Quickstart

Four steps from a key to a webhook, using the sandbox environment.

1. Get a key

Keys are issued directly by us today, ahead of self-serve signup — you will receive an ak_live_* or ak_sandbox_* key for your tenant. A sandbox key runs the real engine against your own data at no charge and never consumes quota.

2. Run one address check

This uses the sandbox's designated test address, which deterministically answers "pending" on the first call so you can exercise the poll path immediately:

curl -s -X POST https://api.leeri.ai/v1/checks \
  -H "Authorization: Bearer $AML_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject":"address","asset":"BTC","address":"1PENDNGCHECKADDRESSFRSANDBXTEST99"}'

3. Read the verdict

Poll the check until its status leaves "pending":

curl -s https://api.leeri.ai/v1/checks/<check_id> \
  -H "Authorization: Bearer $AML_API_KEY"

4. Register a webhook

So a later check does not need polling at all — check.completed fires once per terminal check:

curl -s -X POST https://api.leeri.ai/v1/webhooks \
  -H "Authorization: Bearer $AML_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-service.example.com/webhooks/aml"}'