Skip to main content
Screening tells you whether an entity is sanctioned right now. Monitoring tells you when that answer changes: register the crypto addresses, emails, websites, or government IDs you care about, add one or more alert destinations, and CompliAPI notifies each of them whenever one of those values is added to, removed from, or re-listed on any list we track. A destination is either a webhook endpoint (a signed JSON POST to your https URL) or an email address (a plain-language alert to a person or a shared inbox). Use either or both: every enabled destination receives every event for the organization’s monitored entities. Monitoring is available on the Developer and Team plans. If an organization moves to the Free plan, monitoring pauses: its monitored values and destinations are kept, but list changes are not matched against them and no alerts are sent until it upgrades again. Changes that happen while monitoring is paused are not replayed. It is configured entirely from the dashboard’s Monitoring page.

Concepts

Monitored values are exact matches, using the same normalization as the screening API: Plan limits: 25 monitored values per organization on Developer, 100 on Team, and per organization up to 3 webhook endpoints and 5 email addresses. Add values one at a time, or paste a list of up to 100 of one type (one per line, with an optional label after a comma or in a second spreadsheet column). Each line is reported separately: added, already monitored, invalid, or over the plan limit, so a partly bad list still adds the good lines. Webhook endpoints are public https URLs owned by your organization. Each has its own signing secret (view and rotate it from the dashboard); the payload format and verification code are on the webhook events page. Email addresses receive one message per event with the monitored value and label, the list, the listed value and party, the time, the event id, and a link to the official source record — the same facts the webhook payload carries. The address does not have to belong to a dashboard user, so a shared compliance inbox or a ticketing system’s intake address works; every message names the organization whose monitoring produced it. Nothing in an alert email is signed, so treat it as a notification to act on, and the webhook as the record to automate from. Events fire per list: if a wallet is added to both the OFAC SDN list and the UK Sanctions List, you get two entity.listed events, each naming its list. Event types:
  • entity.listed — the value appeared on a list it wasn’t on before
  • entity.delisted — the value was removed from a list
  • entity.relisted — the value returned to a list it had been removed from
  • test — sent by the dashboard’s test button
List updates are ingested continuously (OFAC every 15 minutes, other sources daily or weekly — see data sources), and events reflect changes to our copy of each list.

Delivery and retries

Events are delivered within a few minutes of ingestion. A webhook delivery is considered successful when your endpoint answers any 2xx status within 10 seconds; an email delivery when our mail provider accepts the message. Anything else is retried on a backoff schedule of roughly 1 minute, 5 minutes, 30 minutes, 2 hours, and 12 hours before the delivery is marked failed. Delivery is at-least-once and unordered: the same event can occasionally arrive twice, and two events may arrive out of order. For webhooks, deduplicate on the event id (stable across retries) and use created_at to order; alert emails carry the same id. After 5 consecutive failed deliveries (each having exhausted its retries), the destination is automatically disabled and the organization owner is emailed. Fix it and re-enable it from the dashboard — delivery resumes with new events from that point; events that occurred while it was disabled are not replayed. An alert whose delivery failed can be redelivered from the dashboard’s Recent alerts list once the destination works again (organization owner only; the destination must be enabled). Redelivery attempts it immediately with the same event id, so your deduplication still applies; if that attempt fails, it goes back on the retry schedule above. Only deliveries that were attempted can be redelivered — events that occurred while a destination was disabled, or while monitoring was paused on the Free plan, were never queued for it. The dashboard’s test button sends a test event to any destination: a signed POST to a webhook endpoint, or a sample alert email to an address, so you can confirm the wiring before anything real fires.

Verifying signatures

Every delivery carries an X-CompliAPI-Signature header signed with the endpoint’s secret. Always verify it before trusting a payload — see webhook events for the payload format and verification code in Python and Node.

Alerts vs. polling

The public GET /api/v1/delisted feed is the polling counterpart: it lists recent removals across all lists, unauthenticated. Monitoring alerts are the push counterpart, scoped to exactly the entities you monitor.