# SEC EDGAR Filings API

> SEC EDGAR company filings, XBRL financial facts, full-text search and ticker to CIK map

- Vendor: `secedgarfilingsapi` · version 1.0 · category Finance · tags sec edgar api, sec filings api, xbrl financial data api, 10-k 10-q api, cik lookup api, company financials api, edgar full text search, ticker to cik api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/secedgarfilingsapi
- This document: https://apiclay.com/docs/secedgarfilingsapi.md
- OpenAPI 3.1: https://apiclay.com/api/secedgarfilingsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `secedgarfilingsapi`
- Updated: 2026-11-18

## About

## SEC EDGAR Filings API

Look up any US public company's filing history, pull XBRL financial values (revenue, assets, payables...) for one company or across every filer for a period, map tickers to CIKs, and run EDGAR full-text search.

Data comes from **sec.gov** (https://www.sec.gov/edgar). Every route below calls the source's own public endpoint directly and returns the upstream response unchanged.

### Routes

#### GET `/tickers` - Ticker to CIK map
Every listed company's ticker, title and CIK.

Returns: an object keyed by index with `cik_str`, `ticker`, `title`.

#### GET `/submissions` - Filing history
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| cik | path | string | yes | 10-digit CIK with leading zeros, e.g. `0000320193` (Apple). |

Returns: `name`, `tickers`, `exchanges`, `sic`, `sicDescription`, `addresses`, and `filings.recent` (parallel arrays: `accessionNumber`, `form`, `filingDate`, `primaryDocument`).

#### GET `/company-concept` - One financial tag over time
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| cik | path | string | yes | 10-digit CIK, e.g. `0000320193`. |
| taxonomy | path | string | yes | `us-gaap`, `ifrs-full`, `dei` or `srt`. |
| tag | path | string | yes | XBRL tag, e.g. `Revenues`, `AccountsPayableCurrent`. |

Returns: `label`, `description`, `units.[]` with `val`, `fy`, `fp`, `form`, `filed`, `end`.

#### GET `/frames` - One tag across all companies
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| taxonomy | path | string | yes | e.g. `us-gaap`. |
| tag | path | string | yes | e.g. `AccountsPayableCurrent`. |
| unit | path | string | yes | e.g. `USD`, `shares`, `USD-per-shares`. |
| period | path | string | yes | `CY2023` (annual), `CY2023Q4` (quarter) or `CY2023Q4I` (instant). |

Returns: `data[]` with `cik`, `entityName`, `val`, `end`, `accn`.

#### GET `/search` - Full-text search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | yes | Words or a quoted phrase, e.g. `"restaurant"`. |
| forms | query | string | no | Comma-separated form types, e.g. `10-K,8-K`. |
| dateRange | query | string | no | `custom`, `1y`, `5y`... use with `startdt`/`enddt`. |
| startdt | query | string | no | YYYY-MM-DD. |
| enddt | query | string | no | YYYY-MM-DD. |
| from | query | number | no | Result offset (pages of 100). |

Returns: `hits.total.value`, `hits.hits[]._source` with `display_names`, `form`, `file_date`, `adsh`.

### Not yet available

| Endpoint | Why |
|---|---|
| companyfacts (all tags at once) | responses reach ~4 MB; use `/company-concept` per tag |

### License

EDGAR data is US government work and in the public domain.

### Caveats

- CIKs must be zero-padded to 10 digits.
- SEC allows about 10 requests per second per caller; bursts may be throttled.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by sec.gov.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /submissions — Company submissions (filing history)
- Gateway: `GET https://api.apiclay.com/v1/api/secedgarfilingsapi/submissions`
- Public query params: `cik` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /company-concept — Company concept (one XBRL tag over time)
- Gateway: `GET https://api.apiclay.com/v1/api/secedgarfilingsapi/company-concept`
- Public query params: `cik` (string, required), `taxonomy` (string, required), `tag` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /frames — Frames (one XBRL tag across all companies)
- Gateway: `GET https://api.apiclay.com/v1/api/secedgarfilingsapi/frames`
- Public query params: `taxonomy` (string, required), `tag` (string, required), `unit` (string, required), `period` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /tickers — Ticker to CIK map
- Gateway: `GET https://api.apiclay.com/v1/api/secedgarfilingsapi/tickers`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /search — Full-text search
- Gateway: `GET https://api.apiclay.com/v1/api/secedgarfilingsapi/search`
- Public query params: `q` (string, required), `forms` (string), `dateRange` (string), `startdt` (string), `enddt` (string), `from` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/secedgarfilingsapi/submissions?cik=<cik>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
