List SEC filings
Retrieve a paginated feed of SEC filings with optional filters.
Data Source
Returns filings from SEC EDGAR, including annual reports, quarterly reports, current reports, and ownership filings. Updated continuously as new filings are accepted.
Form Type Categories
| Category | Forms | Description |
|---|---|---|
| Annual | 10-K, 10-K/A, 20-F | Yearly financial statements |
| Quarterly | 10-Q, 10-Q/A | Quarterly financial updates |
| Current | 8-K, 8-K/A, 6-K | Material event disclosures |
| Ownership | 3, 4, 5 | Insider transaction reports |
| Proxy | DEF 14A, DEFA14A | Shareholder meeting materials |
| Registration | S-1, S-3, S-4 | Securities registration |
| Institutional | 13F-HR, SC 13D, SC 13G | Large holder disclosures |
Filtering Options
- forms: Comma-separated form types (e.g., 10-K,10-Q,8-K)
- cik: SEC Central Index Key for specific company
- ticker: Stock ticker symbol (e.g., AAPL)
- status: final (excludes provisional), provisional, or all
- issuerType: company (issuers) or person (individual filers)
- startDate/endDate: Inclusive range of US Eastern calendar days (YYYY-MM-DD) of SEC acceptance, the same clock as acceptTs. A filing accepted at 8:01 PM ET on 2026-10-01 is returned for 2026-10-01 (the SEC's own filing date can be the next business day). Impossible dates such as 2026-02-30 return a 400.
- q: Search by company name, accession number, or title
Example Use Cases
- Track earnings season: Filter by forms=10-K,10-Q + date range
- Monitor a company: Filter by ticker=AAPL
- Watch insider activity: Filter by forms=4
- Find activist positions: Filter by forms=SC 13D
- Latest from all companies: No filters, sorted by acceptance time
Response Notes
- Results are sorted by sortedAt (acceptance timestamp, most recent first)
- provisional filings are pending final SEC acceptance
- logoUrl is provided when available for company identification
Request
- Base URL: https://earningsfeed.com
- URL: https://earningsfeed.com/api/v1/filings
- Auth: HTTP bearer
Query parameters
Number of items to return (1-100)
Cursor for pagination (opaque string from the nextCursor of a previous response)
Filter by filing status. 'final' excludes provisional filings, 'provisional' shows only provisional.
Filter by entity type. 'company' shows filings from issuers, 'person' shows filings from individuals.
SEC Central Index Key (CIK) - unique company/filer identifier
Filter by stock ticker symbol
Search query for company name, accession number, or title
First US Eastern calendar day (YYYY-MM-DD) of SEC acceptance to include, on the same clock as acceptTs
Last US Eastern calendar day (YYYY-MM-DD) of SEC acceptance to include, on the same clock as acceptTs
Response
Successful response with filing feed
Example response
{
"items": [
{
"accessionNumber": "0000320193-24-000126",
"accessionNoDashes": "000119312524123456",
"cik": 320193,
"companyName": "Apple Inc.",
"formType": "10-K",
"filedAt": "2024-10-30T00:00:00.000Z",
"acceptTs": "2024-10-30T16:05:12.000Z",
"feedDay": "2024-10-30",
"sizeBytes": 1234567,
"url": "https://www.sec.gov/Archives/edgar/data/320193/000119312524123456/0001193125-24-123456-index.htm",
"title": "Form 10-K - Annual Report",
"status": "live",
"updatedAt": "2024-10-30T18:00:00.000Z",
"primaryTicker": "AAPL",
"primaryExchange": "Nasdaq",
"company": {
"cik": 320193,
"name": "Apple Inc.",
"stateOfIncorporation": "CA",
"stateOfIncorporationDescription": "California",
"fiscalYearEnd": "0930"
},
"sortedAt": "2024-10-30T16:05:12.000Z",
"logoUrl": "https://example.com/logos/aapl.png",
"entityClass": "company",
"issuer": {
"cik": 320193,
"name": "QUALCOMM INC/DE",
"ticker": "QCOM"
}
}
],
"appliedFilters": {
"status": "final"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.