> ## 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 Parties

> Every party on one name-screened list, with its names and aliases, as JSON or CSV

Returns every party currently on one [source list](https://docs.compliapi.com/introduction.md#source-lists): 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](https://docs.compliapi.com/api/screen/name.md) matches against. [`/screen/lists/{slug}/entities`](https://docs.compliapi.com/api/screen/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`](https://docs.compliapi.com/api/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 `; `.

**slug** `string` *required*

A [list slug](https://docs.compliapi.com/api/screen/lists.md) with `party_download` true, e.g. `ofac_consolidated` or `uk_fcdo_sanctions`.

**format** `string`

`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.

**parties** `object[]`

**party**

**party\_id** `string`

The list's own id for the party.

**name** `string`

The primary name, in natural order.

**aliases** `string[]`

The party's other listed names. Aliases the list itself marks as low quality are in `metadata.weak_aliases`.

**metadata** `object`

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.

**source\_url** `string | null`

The official record or publication page.

**listed\_at** `string | null`

When CompliAPI first ingested the party, not the designation date.

```json Example response theme={null}
{
  "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"
    }
  ]
}
```


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