Skip to main content
GET
Summarize filings

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
date_start
string

Window start YYYY-MM-DD (≤30-day window).

​
date_end
string

Window end YYYY-MM-DD.

​
date
string

Anchor date YYYY-MM-DD (use with days).

​
days
integer

Trailing N-day window (1–30).

Required range: 1 <= x <= 30
​
group_by
enum<string>
default:form_type

form_type | date | filer. Full value list: https://docs.gdeltcloud.com/reference/enums#filings_summary_group_by

Available options:
form_type,
date,
filer
​
form_type
string

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

​
country
string

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
enum<string>

Region expanded to an ISO-3 country set, then matched against the filer's biz_country_iso2.

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

Continent expanded to an ISO-3 country set, then matched against the filer's biz_country_iso2.

Available options:
Africa,
Asia,
Europe,
North America,
South America,
Oceania
​
limit
integer
default:500

Max buckets returned; pagination.truncated=true when total_buckets exceeds it.

Required range: 1 <= x <= 500

Response

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 }.

​
success
boolean
​
group_by
string
​
data
object[]
​
applied_filters
object