---
title: "Search EDGAR filings and entity history"
method: POST
path: "/legal/v1/sec-filing"
tags: ["Legal"]
---

# Search EDGAR filings and entity history

`POST /legal/v1/sec-filing`

Search SEC EDGAR full-text filings via efts.sec.gov or fetch a filer's structured filing history via data.sec.gov. Returns direct SEC archive URLs with filing metadata and match snippets when available.

## Request body

- object
  - `type` 'search' | 'entity', required — Run a full-text search or fetch a single entity filing history
  - `query` string — Full-text SEC search query (required for type: search)
  - `formTypes` string[] — Optional SEC form type filter such as 10-K, 10-Q, 8-K, or 4
  - `ticker` string — Optional company ticker. Valid for both search and entity lookups.
  - `entity` string — Optional entity filter passed through to EDGAR full-text search
  - `cik` string — CIK for entity lookups. Accepts padded or unpadded digits.
  - `dateAfter` string, date — Optional lower filing date bound (YYYY-MM-DD)
  - `dateBefore` string, date — Optional upper filing date bound (YYYY-MM-DD)
  - `limit` integer — Maximum filings to return
  - `offset` integer — Result offset for pagination

## Response `200`

SEC filings retrieved successfully

- object
  - `type` 'search' | 'entity'
  - `query` string, nullable
  - `entity` string, nullable
  - `ticker` string, nullable
  - `cik` string, nullable
  - `formTypes` string[]
  - `dateAfter` string, date, nullable
  - `dateBefore` string, date, nullable
  - `limit` integer
  - `offset` integer
  - `total` integer
  - `filings` object[]
    - `accessionNumber` string
    - `formType` string
    - `filedAt` string, date
    - `periodOfReport` string, date, nullable
    - `entity` object
      - `name` string, nullable
      - `cik` string
      - `ticker` string, nullable
      - `sic` string, nullable
      - `sicDescription` string, nullable
      - `stateOfIncorporation` string, nullable
      - `entityType` string, nullable
    - `description` string, nullable
    - `documents` object[]
      - `type` string
      - `description` string
      - `url` string
    - `snippet` string, nullable
    - `secUrl` string

## Other responses

- `400` — Bad request - invalid SEC filing parameters
- `401` — Unauthorized - invalid API key
- `403` — Forbidden - insufficient permissions
- `404` — Ticker or SEC entity not found
- `503` — Service unavailable - SEC upstream unavailable or throttled

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/versions/5b7e64e6d6f9/schema)