3d5897270d8a
Search filings
Returns SEC filings for a company, optionally filtered by form type or 8-K event type. Results are paginated and restricted by your subscription tier's historical data limit.
8-K Event Filtering: Use the event parameter to filter 8-K filings by event type (automatically implies type=8-K). Each 8-K filing includes both raw items (SEC item codes) and developer-friendly events (enum names).
Item Extraction: The items array lists extracted section identifiers for all form types (10-K, 10-Q, 20-F, 8-K, S-1). Use /api/filings/item to retrieve the full content of any listed item.
The documents array contains slide/exhibit image filenames (JPG, PNG, GIF, PDF) extracted from the filing. To build a document URL, replace the filename at the end of the filing url with the document filename.
Example: Filing URL .../d230399d8k.htm + document g230399ex99_2p10g1.jpg → .../g230399ex99_2p10g1.jpg
Query parameters
Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.
SEC Central Index Key (CIK).
CUSIP identifier (9 characters).
Composite OpenFIGI identifier.
Share-class OpenFIGI identifier.
SEC filing form type.
SEC form type to filter by. If omitted, all filing types are returned. Ignored when event is provided (event implies type=8-K).
| Type | Description |
|---|---|
| 10-K | Annual report |
| 10-Q | Quarterly report |
| 20-F | Annual report for foreign private issuers |
| 8-K | Current report (key events) |
| DEF 14A | Proxy statement |
| DEFA14A | Additional proxy solicitation materials |
| 13D | Beneficial ownership (>5%, active) |
| 13G | Beneficial ownership (>5%, passive) |
| 3 | Insider initial ownership |
| 4 | Insider ownership changes |
| 5 | Insider annual summary |
| 13F-HR | Institutional holdings (quarterly) |
| NPORT-P | Fund portfolio holdings (monthly) |
| N-CEN | Fund annual census report |
| EFFECT | SEC notice of registration effectiveness (the first EFFECT per company is its IPO date) |
| 25-NSE | Exchange-filed notification of removal from listing (authoritative delisting; the signatureDate is the official delisting date) |
| ARS | Annual Report to Shareholders (glossy/narrative companion to the 10-K) |
Material event category extracted from an 8-K filing.
Filter 8-K filings by event type. Automatically implies type=8-K.
| Event | SEC Item | Description |
|---|---|---|
| earnings | 2.02 | Earnings results |
| officer_change | 5.02 | Officer or director departure/appointment |
| material_agreement | 1.01 | Entry into material definitive agreement |
| acquisition_disposition | 2.01 | Acquisition or disposition of assets |
| control_change | 5.01 | Change in control of registrant |
| restatement | 4.02 | Financial restatement |
| bankruptcy | 1.03 | Bankruptcy or receivership |
| restructuring | 2.05 | Exit or disposal activities |
| reg_fd | 7.01 | Regulation FD disclosure |
| other | 8.01 | Other events |
| financial_exhibits | 9.01 | Financial statements and exhibits |
Page number (1-indexed)
Number of filings per page
Response
Paginated list of SEC filings
Example response
{
"page": 1,
"pageSize": 25,
"totalPages": 8,
"totalResults": 189,
"data": [
{
"type": "8-K",
"accessionNumber": "0000320193-23-000106",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm",
"dateFiled": "2023-11-02",
"xbrl": true,
"periodEndDate": "2023-09-30",
"documents": [
"g230399ex99_2p1g1.jpg",
"g230399ex99_2p2g1.jpg"
],
"title": "APPLE INC ANNUAL REPORT 2023",
"items": [
"1",
"1A",
"7",
"7A",
"8"
],
"events": [
"earnings",
"financial_exhibits"
]
}
]
}