---
title: "Search filings"
method: GET
path: "/api/filings"
tags: ["SEC Filings"]
---

# Search filings

`GET /api/filings`

![Free](https://img.shields.io/badge/Free-22c55e) ![Starter](https://img.shields.io/badge/Starter-3b82f6) ![Stock](https://img.shields.io/badge/Stock-f97316) ![ETF](https://img.shields.io/badge/ETF-14b8a6) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

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`

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string
- `type` '10-K' | '10-Q' | '20-F' | '8-K' | 'DEF 14A' | 'DEFA14A' | '13D' | '13G' | '3' | '4' | '5' | '13F-HR' | 'NPORT-P' | 'N-CEN' | 'EFFECT' | '25-NSE' | 'ARS' — SEC filing form type.
- `event` 'material_agreement' | 'agreement_termination' | 'bankruptcy' | 'mine_safety' | 'acquisition_disposition' | 'earnings' | 'debt_obligation' | 'debt_acceleration' | 'restructuring' | 'impairment' | 'delisting' | 'unregistered_sale' | 'rights_modification' | 'auditor_change' | 'restatement' | 'control_change' | 'officer_change' | 'bylaws_amendment' | 'trading_suspension' | 'ethics_amendment' | 'shell_status_change' | 'shareholder_vote' | 'shareholder_nomination' | 'abs_material' | 'servicer_change' | 'credit_enhancement' | 'distribution_failure' | 'securities_act_update' | 'reg_fd' | 'other' | 'financial_exhibits' — Material event category extracted from an 8-K filing.
- `page` integer
- `pageSize` integer

## Response `200`

Paginated list of SEC filings

- object
  - `page` integer
  - `pageSize` integer
  - `totalPages` integer
  - `totalResults` integer
  - `data` FilingInfo[]
    - `type` string, required — SEC form type
    - `accessionNumber` string, required — SEC accession number
    - `url` string, required — URL to the filing document
    - `dateFiled` string, required — Date the filing was submitted to the SEC (YYYY-MM-DD)
    - `xbrl` boolean, required — Whether the filing includes XBRL data
    - `amendment` boolean, required — 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` 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` 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` string[] — Developer-friendly event type names for 8-K filings. Omitted for non-8-K filings. See the `event` parameter for the full enum.

## Other responses

- `400` — Invalid parameters or company not found
- `403` — Feature not available on current plan

---

[API](https://skmtc.net/stockfit/apis/stockfit-api.md) · [All operations](https://skmtc.net/stockfit/apis/stockfit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockfit/stockfit-api/revisions/3d5897270d8a/schema)