List Parties
curl --request GET \
--url https://api.compliapi.com/api/v1/screen/lists/{slug}/parties \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.compliapi.com/api/v1/screen/lists/{slug}/parties"
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}/parties', 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}/parties",
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}/parties"
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}/parties")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.compliapi.com/api/v1/screen/lists/{slug}/parties")
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_body{
"parties": [
{
"party_id": "<string>",
"name": "<string>",
"aliases": [
"<string>"
],
"metadata": {},
"source_url": {},
"listed_at": {}
}
]
}Screening
List Parties
Every party on one name-screened list, with its names and aliases, as JSON or CSV
GET
/
screen
/
lists
/
{slug}
/
parties
List Parties
curl --request GET \
--url https://api.compliapi.com/api/v1/screen/lists/{slug}/parties \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.compliapi.com/api/v1/screen/lists/{slug}/parties"
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}/parties', 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}/parties",
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}/parties"
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}/parties")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.compliapi.com/api/v1/screen/lists/{slug}/parties")
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_body{
"parties": [
{
"party_id": "<string>",
"name": "<string>",
"aliases": [
"<string>"
],
"metadata": {},
"source_url": {},
"listed_at": {}
}
]
}Returns every party currently on one source list: one row per listed person, organization, vessel or aircraft, with its primary name, its other listed names, and the party details the list publishes (type, programme or regime, dates of birth, nationalities, countries). This is the list itself in one normalized shape, the same rows name screening matches against.
/screen/lists/{slug}/entities is the companion feed of the identifiers those parties carry (addresses, IDs, emails, websites, vessel and aircraft numbers).
Unauthenticated and free, and never counted against your request quota. Available for every list whose party_download is true on /screen/lists — the lists name screening reads. Any other list returns 404, as do unknown and disabled lists. Delisted parties are excluded. The response is the whole list (there is no limit), sorted by name; total is the number of parties, the same figure /screen/lists reports as parties. Responses are cached for five minutes.
Where a list names one party under several ids (the UK list has one entry per sanctions regime), the party appears once, with the values that differ joined by ; .
A list slug with
party_download true, e.g. ofac_consolidated or uk_fcdo_sanctions.json (default) or csv. The CSV has fixed party_id, name, aliases, listed_at, source_url columns plus one column per metadata key the list carries. Multiple values in one cell (aliases, dates of birth, countries) are separated by ; ; nested values such as a vessel’s details are JSON.Show party
Show party
The party’s other listed names. Aliases the list itself marks as low quality are in
metadata.weak_aliases.The party details the list publishes. Keys vary by list; common ones are
party_type (individual, entity, vessel, aircraft), dates_of_birth, nationalities, countries, and the list’s programme or regime.Example response
{
"list": "ofac",
"list_name": "US OFAC SDN",
"list_type": "sanctions",
"total": 19599,
"last_updated": "2026-11-21T09:22:41Z",
"parties": [
{
"party_id": "25578",
"name": "BANK MELLI IRAN",
"aliases": [],
"metadata": {
"sdn_name": "BANK MELLI IRAN",
"sdn_type": "Entity",
"programs": "IRAN",
"party_type": "entity",
"countries": ["Iran"]
},
"source_url": "https://sanctionssearch.ofac.treas.gov/Details.aspx?id=25578",
"listed_at": "2026-11-07T18:07:12Z"
}
]
}