SEC Filings API
US EDGAR filings as searchable markdown exhibits — live plus historical backfill, all form types we index, including 10-K, 8-K, and attachments.
SEC Filings is the US EDGAR corpus—keyword search across the full history we index, plus browse-by-company when you omit query. Exhibits come back as markdown for models and apps.
Start with a company id (Entities) or a query string, call SEC Filing Search, then pass document_id to SEC Filing Reference or SEC Filings Markdown (search inside one file with query there too).
Each hit is a Document item (kind, document_id, parent_id, display, published_at, entities[]) plus SEC header fields on the filing or on a keyword document hit. Browse (no query) is kind=filing with every exhibit in documents[]. Keyword search is kind=document for the matched exhibit only. Use this group when you need fiscal year, 8-K items, or the SEC header. Cross-corpus search stays on Documents.
Coverage
- When. Live as EDGAR accepts the filing (we watch the current-filings feed). Historical accessions we do not yet have are backfilled with the same parser, so an older 10-K is not a second format.
- Which forms. Essentially all form types we index: periodic reports (10-K, 10-Q, 20-F, 40-F), current reports (8-K, 6-K), ownership (Forms 3/4/5, 13F, 13D/G, N-PORT), proxies, registrations, and the rest — including
/Aamendments. Call SEC Filing Types for the expansion; do not treat “10-K and 8-K” as the full set. - Which files. Browse returns the filing and every exhibit in
documents[]. Keyword search returns the matched exhibit only. Graphics are not markdown. The IDEA XBRL zip is not markdown — tagged facts are XBRL (statement forms only). - Through when. Through the latest filing we have parsed.
published_atandfiled_atare the same UTC instant from SEC acceptance (Eastern wall clock). See published_at.
Explore coverage
See what's in scope for this API group—datasets, date ranges, and counts—in the coverage overview.
Extra fields
On top of The Document item. These sit on the filing and on a keyword document hit. Nested files do not repeat the submission header. Calendar dates are YYYY-MM-DD. correction_timestamp is UTC ISO-8601. published_at is still UTC from SEC acceptance.
Form and dates
| Field | Role |
|---|---|
type_category | Native bucket assigned at ingest (financial, news, proxies, …) |
items | 8-K item numbers when present (2.02, 7.01) |
filing_description | Short form description from the submission |
filing_title | Submission title when present |
sec_category | SEC category text when present |
report_date | Period of report |
effectiveness_date | Effectiveness date when known |
filing_date | SEC filing calendar date. Distinct from filed_at |
action_date | Action date when present |
filing_change_date | Filing change date when present |
period_start_date | Period start when present |
received_date | Received date when present |
acceptance_datetime | Acceptance calendar date from the header. Distinct from filed_at |
correction_timestamp | Correction time in UTC when this submission is a correction |
Flags
Boolean fields are included when the header set them, including false.
| Field | Role |
|---|---|
is_correction / is_deletion | Correction or deletion submission |
is_paper / paper_confirming_copy | Paper filing / confirming copy |
is_registered_entity / is_abs_registered_entity | Registered entity / ABS registered entity |
is_filer_new_registrant | New registrant |
is_filer_well_known_seasoned_issuer | Well-known seasoned issuer |
is_fund_24f2_eligible | Rule 24F-2 eligible |
is_filed_pursuant_to_general_instruction_a2 | Filed under General Instruction A.2 |
is_private_to_public | Marked private-to-public |
no_annual_activity / no_quarterly_activity / no_initial_period_active | Activity flags from the header |
Related filings, ABS, and fund series
| Field | Role |
|---|---|
abs_asset_class / abs_rule | ABS asset class and rule |
issuing_entity_name | Issuing entity name |
group_members | Group member names |
multi_accession_numbers | Related accession numbers |
previous_accession / withdrawn_accession | Replaced or withdrawn accession |
sponsor_cik | Sponsor CIKs |
reference_462b / references_429 | Rule 462B / 429 references |
public_document_count | Public document count |
series | Fund series and class/contract rows |
merge_series | Fund merger series |
Codes on the filing
| Field | Role |
|---|---|
all_sics | SIC codes |
all_eins | EINs |
all_states | US state codes |
all_province_countries | Province or country codes |
Filer identity still lives on entities[] (CIK, name, filer_type, fy, q). The listing does not return licensed security identifiers.
Filters
filing_type_categories and filing_types use the same ids as Document Search. Categories and type groups expand to native SEC type_category / form lists. Raw values such as 10-K or 8-K are accepted (10-K includes 10-K/A). Full expansion: SEC Filing Types.
fy is four-digit fiscal years from the submission header. period is FY, Q1, Q2, Q3, or Q4. Combine them to require both (2024 and Q2). from_date / to_date still filter acceptance day, not fiscal period.
Company id is the same handle as Entity Reference.