Dashboard

Search filings

GET/api/filings

Free Starter Pro

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

Get API key Try it live in the API explorer

Query parameters

Example request

curl 'https://api.stockfit.io/v1/api/filings?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8&type=10-K&event=earnings' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Paginated list of SEC filings

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)

    • acceptedAt string (date-time)

      EDGAR acceptance timestamp of the filing whose date sits next to it (`dateFiled`, or `filingDate` on insider transactions). Always ISO 8601 in UTC with second precision, e.g. `2024-11-01T10:01:36Z`. Optional: omitted when that filing date is absent or the acceptance time is unknown (common for older filings and for the most recent ones, whose acceptance time is filled in after a short delay). Normally on the same calendar day as the filing date. Exceptions: a filing accepted after EDGAR's daily cutoff (5:30 p.m. ET for most forms, 10 p.m. ET for insider Forms 3, 4, 5 and 144) is dated the next business day, and an acceptance late in the Eastern evening is already the next day in UTC.

    • 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.

Example response

{
  "page": 1,
  "pageSize": 25,
  "totalPages": 8,
  "totalResults": 189,
  "data": [
    {
      "type": "8-K",
      "accessionNumber": "0000320193-24-000123",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm",
      "dateFiled": "2024-11-01",
      "acceptedAt": "2024-11-01T10:01:36Z",
      "xbrl": true,
      "amendment": false,
      "periodEndDate": "2024-09-28",
      "documents": [
        "g230399ex99_2p1g1.jpg",
        "g230399ex99_2p2g1.jpg"
      ],
      "title": "APPLE INC ANNUAL REPORT 2024",
      "items": [
        "1",
        "1A",
        "7",
        "7A",
        "8"
      ],
      "events": [
        "earnings",
        "financial_exhibits"
      ]
    }
  ]
}

400 Bad Request

Invalid parameters or company not found

Response schema

  • error string

    Human-readable error message

Example response

{
  "error": "Error description goes here"
}

403 Forbidden

Feature not available on current plan

Response schema

  • error string

    Human-readable error message

Example response

{
  "error": "Error description goes here"
}