Filings
Search and retrieve SEC filings from EDGAR. Supports filtering by company, form type, and date range.
GET
/filingsParameters
| Parameter | Type | Description |
|---|---|---|
cik | string | Company CIK number (e.g., "320193") |
formTypes | string | Comma-separated form types (e.g., "10-K,10-Q,8-K"). Max 10. |
filingDate | string | Exact filing date in EST (YYYY-MM-DD) |
startDate | string | Start of date range (YYYY-MM-DD) |
endDate | string | End of date range (YYYY-MM-DD) |
limit | integer | Number of results. Default: 200, max: 1000. |
Example request
typescript
import { SecDailyAPI } from "sec-daily-api";const client = new SecDailyAPI({ apiKey: process.env.SEC_DAILY_API_KEY });const { filings } = await client.getFilings({ticker: "AAPL",formTypes: ["10-K"],limit: 5,});for (const filing of filings) {console.log(`${filing.filingDateInEst} ${filing.formType} - ${filing.entity?.name}`);}
Response
json
{"filings": [{"id": "0000320193-24-000123","accessionNumber": "0000320193-24-000123","formType": "10-K","filingDateInEst": "2024-11-01","filingTimeInEst": "16:32:00","entity": {"name": "Apple Inc.","cik": "0000320193"},"linkToFiling": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm"}],"count": 42,"recordedTimeInUtc": "2025-01-17T21:00:00Z"}
Response fields
| Field | Type | Description |
|---|---|---|
filings | array | List of matching filings |
count | integer | Number of results returned |
recordedTimeInUtc | string | Timestamp when data was recorded (ISO 8601) |
Filing object
| Field | Type | Description |
|---|---|---|
id | string | Unique filing ID |
accessionNumber | string | SEC accession number |
formType | string | SEC form type (10-K, 10-Q, 8-K, etc.) |
filingDateInEst | string | Filing date in Eastern time (YYYY-MM-DD) |
filingTimeInEst | string | Filing time in Eastern time (HH:MM:SS) |
entity.name | string | Company name |
entity.cik | string | Company CIK |
linkToFiling | string | URL to the filing index on SEC.gov |
Common form types
| Form | Description |
|---|---|
10-K | Annual report |
10-Q | Quarterly report |
8-K | Current report (material events) |
4 | Statement of changes in beneficial ownership (insider trades) |
S-1 | IPO registration statement |
DEF 14A | Proxy statement |