curl --request GET \
--url https://gdeltcloud.com/api/v2/lists/changes \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/lists/changes"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/lists/changes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"snapshot_date": "2026-06-27",
"source_key": "csl_ofac_sdn",
"change_type": "added",
"entry_uid": "51284",
"name": "Promsvyazbank Public Joint Stock Company"
},
{
"snapshot_date": "2026-06-25",
"source_key": "csl_bis_entity",
"change_type": "removed",
"entry_uid": "24817",
"name": "Shenzhen Anke High-Tech Co., Ltd."
}
],
"pagination": {
"limit": 50,
"cursor": null,
"next_cursor": null
},
"applied_filters": {
"days": "7"
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}List change feed
The daily diff feed for the restricted-party lists — who was added, removed or changed on each snapshot date. Snapshot dates are OUR observation dates; the feed begins at coverage_window.start on /api/v2/screening/match. Without a window it returns the most recent changes first.
curl --request GET \
--url https://gdeltcloud.com/api/v2/lists/changes \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/lists/changes"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/lists/changes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"snapshot_date": "2026-06-27",
"source_key": "csl_ofac_sdn",
"change_type": "added",
"entry_uid": "51284",
"name": "Promsvyazbank Public Joint Stock Company"
},
{
"snapshot_date": "2026-06-25",
"source_key": "csl_bis_entity",
"change_type": "removed",
"entry_uid": "24817",
"name": "Shenzhen Anke High-Tech Co., Ltd."
}
],
"pagination": {
"limit": 50,
"cursor": null,
"next_cursor": null
},
"applied_filters": {
"days": "7"
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
Restrict the feed to one list. 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 added, removed or changed. Full value list: https://docs.gdeltcloud.com/reference/enums#list_change_type
added, removed, changed One snapshot date; with days it ends the trailing span on that date. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
First snapshot date of an explicit window. start_date is an alias. Also accepts: start_date. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Last snapshot date of an explicit window. end_date is an alias. Also accepts: end_date. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Trailing window in snapshot days, 1–30. window is an alias; 7 and 7d are both accepted. Also accepts: window. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Maximum change rows 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 <= 200Pagination 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 >= 0