Get live statistics on list sizes and freshness

The GET /stats endpoint gives you a real-time snapshot of every source list CompliAPI tracks: how many entities it contains, how those entities break down by type, when it was last updated, and when the next OFAC check is scheduled. The endpoint is free and unauthenticated — no API token needed.

What the response contains

The response is organized into three sections:

sources — a per-list breakdown keyed by list slug. Each entry includes list_type (sanctions, crime, or risk), total entity count, a by_entity_type object showing counts for onchain_address, email, website, and government_id, and a last_updated UTC timestamp.
Cross-list aggregates — countries reports the number of sanctioned countries and regions currently tracked, and delisted reports the number of entities recently removed across all lists.
ofac_refresh — an object specific to the OFAC ingestion schedule, covering both ofac and ofac_consolidated (which share one publication stream). It includes check_minutes_utc (the UTC minute marks each hour at which the feed is polled) and next_check_at (the exact UTC timestamp of the next scheduled check, computed at request time).

How to use it

Call GET https://api.compliapi.com/api/v1/stats — no authorization header required.
Check sources.<slug>.last_updated for any list to confirm it has been refreshed recently.
Use ofac_refresh.next_check_at to know when the OFAC lists will next be polled for changes.
Use sources.<slug>.by_entity_type to understand the composition of a list — for example, how many entries are crypto addresses versus government IDs.

Tips

The top-level last_updated field reflects the most recent update across all lists combined; for per-list freshness, always use the last_updated inside the individual sources entry.
delisted in the aggregates is a count of recently removed entities; the full delisted feed with details is available at GET /delisted.
A companion endpoint, GET /screen/lists, returns similar freshness and count data alongside each list's slug, display name, maintenance kind, and enabled status — useful when you also need to know which list slugs are valid for the ?lists= filter.