List Activity
curl --request GET \
--url https://api.compliapi.com/api/v1/screen/lists/{slug}/activity \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.compliapi.com/api/v1/screen/lists/{slug}/activity"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.compliapi.com/api/v1/screen/lists/{slug}/activity', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.compliapi.com/api/v1/screen/lists/{slug}/activity",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.compliapi.com/api/v1/screen/lists/{slug}/activity"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.compliapi.com/api/v1/screen/lists/{slug}/activity")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.compliapi.com/api/v1/screen/lists/{slug}/activity")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyScreening
List Activity
Listings and delistings per month for one source list, plus its latest entries
GET
/
screen
/
lists
/
{slug}
/
activity
List Activity
curl --request GET \
--url https://api.compliapi.com/api/v1/screen/lists/{slug}/activity \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.compliapi.com/api/v1/screen/lists/{slug}/activity"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.compliapi.com/api/v1/screen/lists/{slug}/activity', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.compliapi.com/api/v1/screen/lists/{slug}/activity",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.compliapi.com/api/v1/screen/lists/{slug}/activity"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.compliapi.com/api/v1/screen/lists/{slug}/activity")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.compliapi.com/api/v1/screen/lists/{slug}/activity")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyUnauthenticated and free. Returns how one source list 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
The last month in
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.
A list slug, e.g.
usdt_frozen or ofac.Calendar months of history to return, the current month included (default 12, max 36). Months with no changes are returned with zeros.
Example response
{
"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"
}
]
}
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.