Plan: Free and above · Credits: 1 per call
What You Can Use SEC Filing Items For
Read a company’s risk factors or MD&A in full. Diff one year’s Item 1A against the previous year’s. Pull the exact 8-K item text behind a structured event. Feed a specific section into a model rather than the whole filing.SEC Filing Items Coverage
The form types supported are10-K, 10-Q and 8-K. The item types endpoint lists which item codes exist for each form type.
How to Address One Filing
A filing is addressed by ticker, form type and year, plus one more field depending on the form. For a 10-K, ticker,filing_type=10-K and year are enough.
For a 10-Q, also pass quarter as 1 to 4.
For an 8-K, also pass the accession_number, because a company files many 8-Ks in a year. Get it from the SEC Filings Index.
year is the calendar year of the filing’s period of report, not the year it was filed.
Items Incorporated by Reference
Public companies routinely satisfy an item by pointing at another document rather than repeating it — a proxy statement, an exhibit. By default such an item returns the cross-reference as filed. Passresolve=true to expand items incorporated by reference to their full text. Without it, an item can come back short and technically correct, which reads like missing data.
Key SEC Filing Item Fields
Each item carries its item code —Item-1A, Item-7, and so on — and its text. include_exhibits=true attaches exhibit metadata to the response.
An answer-less response is possible: a filing that could not be parsed into items returns a successful response with no items. That case is not charged a credit.
SEC Filing Items Date Convention
year and quarter refer to the filing’s period of report — the fiscal period the document covers — not to the date it was filed. A 10-K covering fiscal 2025 filed in October 2025 is year=2025.
SEC Filing Items Sources
Item text is taken from the filing itself on SEC EDGAR and split along the form’s own item structure. Text is not summarised or rewritten.Query SEC Filing Items
Use the filing items endpoint to split one filing.string
required
The issuer’s ticker.
string
required
10-K, 10-Q or 8-K.integer
required
Calendar year of the filing’s period of report.
integer
Quarter 1 to 4. Required for a 10-Q.
string
The filing’s accession number. Required for an 8-K.
string[]
Specific item codes to return, repeatable — for example
Item-1A and Item-7. Omit to return all items.boolean
default:"false"
Attach exhibit metadata to the response.
boolean
default:"false"
Expand items incorporated by reference to their full text.
{ error, message } error body.