> ## Documentation Index
> Fetch the complete documentation index at: https://docs.compliapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Activity

> Listings and delistings per month for one source list, plus its latest entries

Unauthenticated and free. Returns how one [source list](https://docs.compliapi.com/introduction.md#source-lists) has changed over time: how many identifiers were listed and delisted in each calendar month (UTC), the number currently listed, and the most recently listed entries. Unknown or disabled lists return `404`. Responses are cached for five minutes.

For the lists read from on-chain events (`usdt_frozen`, `usdc_frozen`) the dates are the chain's own: `listed_at` is when the issuer froze the address and a delisting is dated when it was released. For the other lists `listed_at` is when CompliAPI first ingested the entry.

**slug** `string` *required*

A [list slug](https://docs.compliapi.com/api/screen/lists.md), e.g. `usdt_frozen` or `ofac`.

**months** `integer`

Calendar months of history to return, the current month included (default 12, max 36). Months with no changes are returned with zeros.

**recent** `integer`

How many of the most recently listed entries to return (default 10, max 50).

```json Example response theme={null}
{
  "list": "usdc_frozen",
  "list_name": "Circle USDC frozen addresses",
  "list_type": "risk",
  "active": 710,
  "months": [
    { "month": "2026-10", "listed": 41, "delisted": 3 },
    { "month": "2026-11", "listed": 18, "delisted": 0 }
  ],
  "recent": [
    {
      "entity_type": "onchain_address",
      "value": "0xAD7878093441e98402A966c47DeEE528B0a14110",
      "metadata": {
        "name": "USDC frozen by Circle",
        "issuer": "Circle",
        "symbol": "USDC",
        "network": "ethereum",
        "frozen_at": "2026-11-12T08:14:23+00:00",
        "block": 26251090,
        "tx_hash": "0xcf84c624ab852d8b27cfe692acf96af899d2c893ec42a1d93ec91e8b4736c54c"
      },
      "source_url": "https://etherscan.io/tx/0xcf84c624ab852d8b27cfe692acf96af899d2c893ec42a1d93ec91e8b4736c54c",
      "listed_at": "2026-11-12T08:14:23Z"
    }
  ]
}
```

The last month in `months` is the current one and is still filling. A month's `listed` counts every identifier listed in it, including ones removed later; `recent` holds only identifiers that are still listed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.