Search list entries
Search the entries on the restricted-party lists — by name or alias, country, programme, or resolved entity — current or point-in-time. Each entry carries its aliases, entity_kind (entity | vessel | aircraft | individual), programmes, legal basis, cross-source ids and our first/last observation dates. A natural-person row (entity_kind: individual) carries birth_year and topics and NEVER addresses — the served-person contract withholds them. A country filter is honoured best-effort where a source does not populate the structured country field, and the response says so in coverage_warning: treat a miss as “no match on file”, not “not sanctioned”.
Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
The list to search, by source_key. source is an alias. Case-insensitive. The accepted set grows as sources are ingested: the values published here are the snapshot at build time, and /api/v2/lists (rows with ingested: true) is the live list. Also accepts: source. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Full value list: https://docs.gdeltcloud.com/reference/enums#list_source_key
csl_ofac_sdn, csl_ofac_ssi, csl_ofac_cmic, csl_ofac_nsmbs, csl_ofac_capta, csl_bis_entity, csl_bis_meu, csl_bis_uvl, csl_bis_dpl, csl_state_debarred, csl_state_isn, dod_1260h, un_consolidated, uk_uksl Case-insensitive substring over the entry name, its normalized form and every alias. search is an alias. Also accepts: search. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Country of the entry — a name, ISO-2 or ISO-3. country_iso3 is an alias. Matched on the structured field OR the trailing ISO-2 token of an address, see coverage_warning. Also accepts: country_iso3. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Region expanded to its countries (Eastern Europe). Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Africa, Asia, Middle East, Northern Africa, Western Africa, Eastern Africa, Middle Africa, Southern Africa, Europe, Eastern Europe, South Asia, Southeast Asia, East Asia, Central Asia, North America, Central America, Caribbean, South America, Oceania Continent expanded to its countries (Asia). Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Africa, Asia, Europe, North America, South America, Oceania Sanctions programme code, matched case-insensitively (UKRAINE-EO13662). Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Only entries resolved to this entity — an e_ spine id or a wiki: news id, collapsed through the arbiter. entity_id is an alias. An id the registry has never heard of answers 400 UNRESOLVED_ENTITY_ID rather than an empty list. Also accepts: entity_id. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Point-in-time: entries on the list on this date, by our observation history. A date outside coverage_window answers screen_status: inconclusive with the window, never an empty list. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Only entries first observed on or after this date. Ignored when active_on or removed_since is set. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Only entries that LEFT a list on or after this date (active: false). Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
name (A–Z) or recent (latest observation first). Full value list: https://docs.gdeltcloud.com/reference/enums#list_entries_sort
name, recent Maximum entries returned. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
1 <= x <= 100Pagination cursor from pagination.next_cursor. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Legacy numeric offset; cursor is preferred. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
x >= 0Response
Search list entries.
inconclusive active_on_precedes_coverage, active_on_follows_coverage Present when a country/region/continent filter could only be honoured best-effort. Treat a miss as "no match on file", NOT "not sanctioned".