---
title: "Company SEC Filings"
method: POST
path: "/v1/tools/company_filings"
---

# Company SEC Filings

`POST /v1/tools/company_filings`

## Request

- Base URL: `https://unstuckapi.com`
- URL: `https://unstuckapi.com/v1/tools/company_filings`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

List a US public company's recent SEC filings (10-K annual reports, 10-Q quarterlies, 8-K current reports, proxies and more) by stock ticker or CIK: form, filing date, period, description and direct document links. Data source: SEC EDGAR public filings (free public data; not affiliated with or endorsed by the SEC).

Price: $0.02 per call. Charged once per call that returns a result, including an empty result list. Failed calls are free.

## Request body

- object
  - `ticker_or_cik` string, required: Stock ticker (e.g. "AAPL", "BRK.B") or the company's numeric SEC CIK (e.g. "320193").
  - `form_types` string[]: Only these form types, e.g. ["10-K","10-Q","8-K"]. Exact match (amendments are "10-K/A"). Default: all forms.
  - `limit` integer: How many filings, newest first. Default 10, max 20.

## Response `200`

Success

- object
  - `tool` 'company_filings', required
  - `result` object, required
    - `source` 'SEC EDGAR', required
    - `company` string, nullable, required: Company name as filed.
    - `cik` string, required: 10-digit SEC Central Index Key.
    - `tickers` string[], required
    - `filings` object[], required
      - `form` string, required: Form type, e.g. "10-K".
      - `filed` string, nullable, required: Filing date (YYYY-MM-DD).
      - `report_date` string, nullable, required: Period of report (YYYY-MM-DD), if any.
      - `description` string, nullable, required: Document description, or 8-K item numbers.
      - `accession_number` string, required
      - `document_url` string, nullable, required: Main document.
      - `filing_index_url` string, required: Filing index with all documents and exhibits.
  - `charged_usd` number, required
  - `balance_usd` number, required

## Other responses

- `400`: Invalid JSON or input. Not charged.
- `401`: Paid tool without a valid API key.
- `402`: Balance too low for this call. Not charged.
- `404`: Unknown tool.
- `422`: The tool failed. Not charged.
- `429`: Rate limited, free tries used up, or the uncharged-result limit reached. See Retry-After.

---

[API](https://skmtc.dev/unstuckapi/apis/unstuck-api.md) · [All operations](https://skmtc.dev/unstuckapi/apis/unstuck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unstuckapi/apis/unstuck-api/revisions/ef3ec951224f?raw)