curl --request GET \
--url https://gdeltcloud.com/api/v2/filings/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings/events"
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/filings/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"event_uid": "9c8b7a6d5e4f30211029384756abcdef",
"cik": 65270,
"company_name": "METHODE ELECTRONICS INC",
"accession_no": "0000065270-26-000058",
"item_code": "2.02",
"event_type": "results",
"headline": "Methode Electronics reported fiscal fourth-quarter net sales of $260.1 million and a net loss of $0.79 per share, citing softer automotive demand and program transition costs.",
"counterparties": [],
"amount_text": "$260.1 million",
"resolved_entity_ids": [],
"confidence": 0.93,
"event_date": "2026-06-18",
"model": "gpt-5.4-mini:8k:v1"
},
{
"event_uid": "1f2e3d4c5b6a70819283746556fedcba",
"cik": 65270,
"company_name": "METHODE ELECTRONICS INC",
"accession_no": "0000065270-26-000052",
"item_code": "5.02",
"event_type": "executive_change",
"headline": "Methode Electronics announced the appointment of Jonathan B. DeGaynor as President and Chief Executive Officer, effective June 9, 2026, succeeding the interim CEO.",
"counterparties": [
"Jonathan B. DeGaynor"
],
"amount_text": null,
"resolved_entity_ids": [
"ent_7e3a1c89d2b4"
],
"confidence": 0.96,
"event_date": "2026-06-09",
"model": "gpt-5.4-mini:8k:v1"
}
],
"pagination": {
"limit": 50,
"cursor": null,
"next_cursor": null
},
"applied_filters": {
"date_start": "2026-05-30",
"date_end": "2026-06-28",
"cik": [
65270
],
"ignored": {}
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Material events (8-K)
Dated 8-K material corporate events (M&A, material agreements, executive changes, bankruptcies, delistings, impairments) extracted from 8-K bodies, with counterparties resolved into the entity spine. Requires a plan with SEC filings access (can_use_filings) — see Pricing for the plans that include it.
curl --request GET \
--url https://gdeltcloud.com/api/v2/filings/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings/events"
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/filings/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"event_uid": "9c8b7a6d5e4f30211029384756abcdef",
"cik": 65270,
"company_name": "METHODE ELECTRONICS INC",
"accession_no": "0000065270-26-000058",
"item_code": "2.02",
"event_type": "results",
"headline": "Methode Electronics reported fiscal fourth-quarter net sales of $260.1 million and a net loss of $0.79 per share, citing softer automotive demand and program transition costs.",
"counterparties": [],
"amount_text": "$260.1 million",
"resolved_entity_ids": [],
"confidence": 0.93,
"event_date": "2026-06-18",
"model": "gpt-5.4-mini:8k:v1"
},
{
"event_uid": "1f2e3d4c5b6a70819283746556fedcba",
"cik": 65270,
"company_name": "METHODE ELECTRONICS INC",
"accession_no": "0000065270-26-000052",
"item_code": "5.02",
"event_type": "executive_change",
"headline": "Methode Electronics announced the appointment of Jonathan B. DeGaynor as President and Chief Executive Officer, effective June 9, 2026, succeeding the interim CEO.",
"counterparties": [
"Jonathan B. DeGaynor"
],
"amount_text": null,
"resolved_entity_ids": [
"ent_7e3a1c89d2b4"
],
"confidence": 0.96,
"event_date": "2026-06-09",
"model": "gpt-5.4-mini:8k:v1"
}
],
"pagination": {
"limit": 50,
"cursor": null,
"next_cursor": null
},
"applied_filters": {
"date_start": "2026-05-30",
"date_end": "2026-06-28",
"cik": [
65270
],
"ignored": {}
}
}{
"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
Window start YYYY-MM-DD (≤30-day window).
Window end YYYY-MM-DD.
Anchor date YYYY-MM-DD (use with days).
Trailing N-day window (1–30, default 30).
1 <= x <= 30One or more CIK numbers (comma-separated).
Filter to one classified event type. Full set: acquisition | disposition | material_agreement | executive_change | results | guidance | restructuring | impairment | delisting | bankruptcy | other. Matched exactly; omit for all. Full value list: https://docs.gdeltcloud.com/reference/enums#filings_event_type
acquisition, disposition, material_agreement, executive_change, results, guidance, restructuring, impairment, delisting, bankruptcy, other Case-insensitive substring match on the event headline.
Rows per page (1–200, default 50).
1 <= x <= 200Pagination cursor (opaque offset).
Response
A page of 8-K material events, most recent first. Each row: event_uid, cik, company_name, accession_no, item_code, event_type, headline, counterparties (names mentioned in the disclosure), amount_text (deal/transaction value as disclosed, when present), resolved_entity_ids (counterparties resolved into the entity spine), confidence, event_date. Standard envelope: { success, data, pagination, applied_filters }.

