Skip to main content
GET
List catalog

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

source
enum<string>

Restrict the catalogue to one source_key. 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. 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

Available options:
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
category
enum<string>

Return only sources of this kind. sanctions and export_control are the two categories that count toward the sanctions exposure lens; debarment, wanted, maritime and domestic_terror are catalogued and screenable but are not sanctions. Matched case-insensitively. Full value list: https://docs.gdeltcloud.com/reference/enums#list_category

Available options:
sanctions,
domestic_terror,
debarment,
export_control,
screening_list,
military_affiliation,
wanted,
maritime
jurisdiction
string

Issuer jurisdiction code (US, EU, UN, GB, CN, AU, …), matched case-insensitively. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

cadence
string

Our refresh cadence for the source. Observed vocabulary — matched exactly, case-sensitively. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply. Observed vocabulary, measured 2026-08-10 (2 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/lists (read cadence on each catalogue entry). Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#list_cadence

Response

List catalog.

success
boolean
required
data
object[]
required
applied_filters
any
required