Filings

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

CategoryFormsDescription
Annual10-K, 10-K/A, 20-FYearly financial statements
Quarterly10-Q, 10-Q/AQuarterly financial updates
Current8-K, 8-K/A, 6-KMaterial event disclosures
Ownership3, 4, 5Insider transaction reports
ProxyDEF 14A, DEFA14AShareholder meeting materials
RegistrationS-1, S-3, S-4Securities registration
Institutional13F-HR, SC 13D, SC 13GLarge 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

  1. Track earnings season: Filter by forms=10-K,10-Q + date range
  2. Monitor a company: Filter by ticker=AAPL
  3. Watch insider activity: Filter by forms=4
  4. Find activist positions: Filter by forms=SC 13D
  5. 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
get/api/v1/filings

Request

  • Base URL: https://earningsfeed.com
  • URL: https://earningsfeed.com/api/v1/filings
  • Auth: HTTP bearer

Query parameters

limitinteger

Number of items to return (1-100)

Example:25
cursorstring

Cursor for pagination (opaque string from the nextCursor of a previous response)

Example:eyJzb3J0IjoiMjAyNC0xMS0wMVQxMjozMDowMC4wMDBaIiwiaWQiOjEyMzQ1fQ
string
OR
string[]
status'all' | 'final' | 'provisional'

Filter by filing status. 'final' excludes provisional filings, 'provisional' shows only provisional.

Example:final
issuerType'company' | 'person'

Filter by entity type. 'company' shows filings from issuers, 'person' shows filings from individuals.

Example:company
cikinteger

SEC Central Index Key (CIK) - unique company/filer identifier

Example:320193
tickerstring

Filter by stock ticker symbol

Example:AAPL
qstring

Search query for company name, accession number, or title

Example:Apple
startDatestring

First US Eastern calendar day (YYYY-MM-DD) of SEC acceptance to include, on the same clock as acceptTs

Example:2026-10-01
endDatestring

Last US Eastern calendar day (YYYY-MM-DD) of SEC acceptance to include, on the same clock as acceptTs

Example:2026-10-02

Response

Successful response with filing feed

nextCursorstring nullable required

Cursor for next page, null if no more pages

hasMoreboolean required

Whether more items exist beyond this page

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.