---
title: "SEC Filings"
method: GET
path: "/v1/reference/sec/filings"
tags: ["reference:sec:filings"]
---

# SEC Filings

`GET /v1/reference/sec/filings`

List filings

## Query parameters

- `type` '10-K' | '10-Q' — Filing Type
- `filing_date` string — The date when the filing was filed in YYYYMMDD format.
- `period_of_report_date` string — The period of report for the filing in YYYYMMDD format.
- `has_xbrl` boolean, nullable
- `entities.company_data.name` string
- `entities.company_data.cik` string — Central Index Key (CIK) Number
- `entities.company_data.ticker` string — Ticker
- `entities.company_data.sic` string — Standard Industrial Classification (SIC)
- `filing_date.gte` string — The date when the filing was filed in YYYYMMDD format.
- `filing_date.gt` string — The date when the filing was filed in YYYYMMDD format.
- `filing_date.lte` string — The date when the filing was filed in YYYYMMDD format.
- `filing_date.lt` string — The date when the filing was filed in YYYYMMDD format.
- `period_of_report_date.gte` string — The period of report for the filing in YYYYMMDD format.
- `period_of_report_date.gt` string — The period of report for the filing in YYYYMMDD format.
- `period_of_report_date.lte` string — The period of report for the filing in YYYYMMDD format.
- `period_of_report_date.lt` string — The period of report for the filing in YYYYMMDD format.
- `entities.company_data.name.search` string
- `order` 'asc' | 'desc'
- `limit` integer
- `sort` 'filing_date' | 'period_of_report_date'

## Response `200`

FIXME

- object
  - `count` integer, required
  - `next_url` string
  - `request_id` string, required
  - `results` object[], required
    - `acceptance_datetime` string — The datetime when the filing was accepted by EDGAR in EST (format: YYYYMMDDHHMMSS)
    - `accession_number` string, required — Filing Accession Number
    - `entities` object[], required — Entities related to the filing (e.g. the document filers).
      - `company_data` object
        - `cik` string, required — Central Index Key (CIK) Number
        - `name` string, required
        - `sic` string, required — Standard Industrial Classification (SIC)
        - `ticker` string — Ticker
      - `relation` 'filer', required — Relationship of this entity to the filing.
    - `files_count` integer, required — The number of files associated with the filing.
    - `filing_date` string, required — The date when the filing was filed in YYYYMMDD format.
    - `id` string, required — Unique identifier for the filing.
    - `period_of_report_date` string, required — The period of report for the filing in YYYYMMDD format.
    - `source_url` string, uri, required — The source URL is a link back to the upstream source for this filing document.
    - `type` '10-K' | '10-Q', required — Filing Type
  - `status` string, required

---

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