List SEC filings
List the SEC EDGAR filing index by company (CIK), form type, name, and date window. Requires a plan with SEC filings access (can_use_filings) — the Corporate & Supply Chain plan and above.
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 <= 30One or more CIK numbers (comma-separated).
One or more form types (e.g. 10-K,8-K,4).
10-K, 10-Q, 8-K, 13F-HR, SCHEDULE 13D, SCHEDULE 13G, 3, 4, 5, DEF 14A, S-1, 20-F, 6-K Company-name search.
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.
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 expanded to an ISO-3 country set, then matched against the filer's biz_country_iso2.
Africa, Asia, Europe, North America, South America, Oceania recent | filer.
recent, filer Rows per page.
Pagination cursor (opaque offset).
Response
A page of filings, most recent first (or grouped by filer when sort=filer). Each row: accession_no, cik, company_name, form_type, file_date, is_amendment (bool), primary_doc_url, biz_country_iso2 (when known), items (form-specific item tags, when present). Standard envelope: { success, data, pagination, sort, applied_filters }.