Latest filings

GET/api/filings/latest

Returns the most recent SEC filings across all companies, sorted by filing date descending. Limited to the last 30 days. Includes the company's ticker symbol and name.

Use the event parameter to find specific 8-K events across the entire market — for example, event=earnings returns all recent earnings announcements, event=officer_change returns all recent executive departures/appointments.

Get API key Try it live in the API explorer

Query parameters

type string (enum) optional

SEC form type to filter by. Ignored when event is provided.

Example: 8-K
event string (enum) optional

Filter 8-K filings by event type. Automatically implies type=8-K.

Example: earnings
page integer optional min 1 · max 100 · default 1

Page number (1-indexed)
pageSize integer optional min 1 · max 100 · default 25

Number of filings per page

Example request

curl 'https://api.stockfit.io/v1/api/filings/latest?type=8-K&event=earnings' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Paginated list of recent SEC filings with company info

Response schema

page integer
pageSize integer
totalPages integer
totalResults integer
data array of object
array of:
- type string
  SEC form type
- accessionNumber string
  SEC accession number
- url string
  URL to the filing document
- dateFiled string
  Date the filing was submitted to the SEC (YYYY-MM-DD)
- xbrl boolean
  Whether the filing includes XBRL data
- amendment boolean
  Whether this filing is an amendment
- periodEndDate string
  Period end date for the report (YYYY-MM-DD). Omitted for filings without a reporting period (Form 144, 4, etc).
- documents array of string
  Ordered list of slide/exhibit filenames (images >= 50KB). To get the full URL, replace the filename in the filing `url` with the document filename. Omitted when no extractable documents are present.
- title string
  Descriptive title of the filing. Omitted when the filing has no meaningful title.
- items array of string
  Extracted item identifiers. For 10-K/10-Q: section numbers (e.g. "1A", "7"). For 8-K: SEC item codes (e.g. "2.02", "9.01"). For S-1: section keys (e.g. "risk-factors"). Omitted when no items are extracted. Use `/api/filings/item` to retrieve the full content of any listed item.
- events array of string
  Developer-friendly event type names for 8-K filings. Omitted for non-8-K filings. See the `event` parameter for the full enum.
- symbol string
  Primary ticker symbol. Omitted for filers without a resolved ticker (private issuers, funds).
- companyName string
  Company name. Omitted when unresolved.

Example response

{
  "page": 1,
  "pageSize": 25,
  "totalPages": 12,
  "totalResults": 284,
  "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,
      "amendment": false,
      "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"
      ],
      "symbol": "AAPL",
      "companyName": "Apple Inc."
    }
  ]
}

400 Bad Request

Invalid parameters

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}