Sign in

v1

latestOpenAPI 3.0.32026-07-226744340.8 KB
Filings

Summarize filings

Rollup of filings by form type, date, or filer — counts + distinct filers. Requires a plan with SEC filings access (can_use_filings) — the Corporate & Supply Chain plan and above.

get/api/v2/filings/summary

Query parameters

date_startstring

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

date_endstring

Window end YYYY-MM-DD.

datestring

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

daysinteger

Trailing N-day window (1–30).

group_by'form_type' | 'date' | 'filer'

form_type | date | filer.

form_type'10-K' | '10-Q' | '8-K' | '13F-HR' | 'SCHEDULE 13D' | 'SCHEDULE 13G' | '3' | '4' | '5' | 'DEF 14A' | 'S-1' | '20-F' | '6-K'

Filter to one or more form types.

countrystring

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'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'

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

continent'Africa' | 'Asia' | 'Europe' | 'North America' | 'South America' | 'Oceania'

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

limitinteger

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

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

successboolean
group_bystring