curl --request GET \
--url https://gdeltcloud.com/api/v2/filings \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings"
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', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"accession_no": "0000065270-26-000058",
"cik": 65270,
"company_name": "METHODE ELECTRONICS INC",
"form_type": "8-K",
"file_date": "2026-06-18",
"is_amendment": false,
"primary_doc_url": "https://www.sec.gov/Archives/edgar/data/65270/000006527026000058/mei-20260618.htm",
"biz_country_iso2": "US",
"items": [
"2.02",
"9.01"
]
},
{
"accession_no": "0000065270-26-000041",
"cik": 65270,
"company_name": "METHODE ELECTRONICS INC",
"form_type": "10-K",
"file_date": "2026-06-12",
"is_amendment": false,
"primary_doc_url": "https://www.sec.gov/Archives/edgar/data/65270/000006527026000041/mei-20260501.htm",
"biz_country_iso2": "US"
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null
},
"sort": "recent",
"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": {}
}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) — see Pricing for the plans that include it.
curl --request GET \
--url https://gdeltcloud.com/api/v2/filings \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings"
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', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"accession_no": "0000065270-26-000058",
"cik": 65270,
"company_name": "METHODE ELECTRONICS INC",
"form_type": "8-K",
"file_date": "2026-06-18",
"is_amendment": false,
"primary_doc_url": "https://www.sec.gov/Archives/edgar/data/65270/000006527026000058/mei-20260618.htm",
"biz_country_iso2": "US",
"items": [
"2.02",
"9.01"
]
},
{
"accession_no": "0000065270-26-000041",
"cik": 65270,
"company_name": "METHODE ELECTRONICS INC",
"form_type": "10-K",
"file_date": "2026-06-12",
"is_amendment": false,
"primary_doc_url": "https://www.sec.gov/Archives/edgar/data/65270/000006527026000041/mei-20260501.htm",
"biz_country_iso2": "US"
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null
},
"sort": "recent",
"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).
1 <= x <= 30One or more CIK numbers (comma-separated).
One or more form types (e.g. 10-K,8-K,4). 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
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. Full value list: https://docs.gdeltcloud.com/reference/enums#country
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 recent | filer. Full value list: https://docs.gdeltcloud.com/reference/enums#filings_sort
recent, filer Rows per page.
Pagination cursor (opaque offset).
Restrict to one entity's SEC filings. Takes the SAME entity identifier as the other per-entity surfaces — a spine e_… id, a news wiki:…/llm:… id, or a merged alias of either — resolved through the shared resolver, so the id you used on /api/v2/events or /api/v2/gov/awards selects the same company here.
Resolution maps the entity to its SEC Central Index Key(s); the applied set is echoed as applied_filters.entity_cik, and an entity carrying two filer numbers matches BOTH. An entity-scoped read is a primary-key seek, so it is NOT capped at 30 days (it defaults to the last year, like cik). A known entity with no SEC filer identity returns an empty result with a note — never the unfiltered feed — and an identifier that resolves to no known entity is refused with 400 UNRESOLVED_ENTITY_ID rather than silently ignored. Combine with cik to intersect the two. Also accepts: entity_id. Resolve a NAME first with GET /api/v2/search or GET /api/v2/filings/resolve?q=<name>.
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 }.