curl --request GET \
--url https://gdeltcloud.com/api/v2/filings/summary \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings/summary"
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/summary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"group_by": "form_type",
"data": [
{
"form_type": "8-K",
"filings": 4821,
"filers": 3970
},
{
"form_type": "10-Q",
"filings": 1638,
"filers": 1602
}
],
"applied_filters": {
"date_start": "2026-05-30",
"date_end": "2026-06-28",
"ignored": {}
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Summarize filings
Rollup of filings by form type, date, or filer — counts + distinct filers. 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/summary \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings/summary"
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/summary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"group_by": "form_type",
"data": [
{
"form_type": "8-K",
"filings": 4821,
"filers": 3970
},
{
"form_type": "10-Q",
"filings": 1638,
"filers": 1602
}
],
"applied_filters": {
"date_start": "2026-05-30",
"date_end": "2026-06-28",
"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).
1 <= x <= 30form_type | date | filer. Full value list: https://docs.gdeltcloud.com/reference/enums#filings_summary_group_by
form_type, date, filer Filter to one or more form types. Observed vocabulary, measured 2026-08-10 (262 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/filings/summary?group_by=form_type. SEC form types are an open vocabulary: 264 distinct values appeared in a single 30-day window, and 424B2 alone was 36.3% of them. Any closed list here would be wrong within a quarter, so this filter accepts anything and returns an empty result for a form type the window does not contain. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#sec_form_type
Filer business-address country — name / ISO-2 / ISO-3 / alias, comma-separated. Filters on biz_country_iso2, which is populated for ~45% of filings and is almost entirely US, so non-US values such as CN/JP currently return 0 rows.
Region expanded to an ISO-3 country set, then matched against the filer's biz_country_iso2.
Middle East, Northern Africa, Western Africa, Eastern Africa, Middle Africa, Southern Africa, Eastern Europe, South Asia, Southeast Asia, East Asia, Central Asia, Northern America, Central America, Caribbean Continent expanded to an ISO-3 country set, then matched against the filer's biz_country_iso2.
Africa, Asia, Europe, North America, South America, Oceania Max buckets returned; pagination.truncated=true when total_buckets exceeds it.
1 <= x <= 500Response
Filing counts bucketed by group_by (form_type | date | filer), highest count first. Each row carries the bucket key (form_type, date, or cik), filings (count) and — except when grouping by filer — filers (distinct CIKs). Envelope: { success, group_by, data, applied_filters }.