Search filings

GET/api/filings

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

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

type string (enum) optional

SEC form type to filter by. If omitted, all filing types are returned. Ignored when event is provided (event implies type=8-K).

Type	Description
`10-K`	Annual report
`10-Q`	Quarterly report
`20-F`	Annual report for foreign private issuers
`8-K`	Current report (key events)
`DEF 14A`	Proxy statement
`DEFA14A`	Additional proxy solicitation materials
`13D`	Beneficial ownership (>5%, active)
`13G`	Beneficial ownership (>5%, passive)
`3`	Insider initial ownership
`4`	Insider ownership changes
`5`	Insider annual summary
`13F-HR`	Institutional holdings (quarterly)
`NPORT-P`	Fund portfolio holdings (monthly)
`N-CEN`	Fund annual census report
`EFFECT`	SEC notice of registration effectiveness (the first `EFFECT` per company is its IPO date)
`25-NSE`	Exchange-filed notification of removal from listing (authoritative delisting; the `signatureDate` is the official delisting date)
`ARS`	Annual Report to Shareholders (glossy/narrative companion to the 10-K)

Example: 10-K

event string (enum) optional

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

Event	SEC Item	Description
`earnings`	2.02	Earnings results
`officer_change`	5.02	Officer or director departure/appointment
`material_agreement`	1.01	Entry into material definitive agreement
`acquisition_disposition`	2.01	Acquisition or disposition of assets
`control_change`	5.01	Change in control of registrant
`restatement`	4.02	Financial restatement
`bankruptcy`	1.03	Bankruptcy or receivership
`restructuring`	2.05	Exit or disposal activities
`reg_fd`	7.01	Regulation FD disclosure
`other`	8.01	Other events
`financial_exhibits`	9.01	Financial statements and exhibits

Example: earnings

page integer optional min 1 · max 1000 · 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?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)
- 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": [
    {}
  ]
}

400 Bad Request

Invalid parameters or company not found

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

{}