A Dark Vector Cognition product
Developer API

SEC filings API: sections, facts and changes.

Get 10-K, 10-Q and 8-K sections as JSON or Markdown, read XBRL facts, and compare filings with their preceding period. Inspect a real result, try the API, then choose a plan for your work. Read existing filings; this is not an SEC submission service.

Inspect a real resultStarter: $19/month

1. Inspect a source-linked result

Apple's 10-K for 2025-09-27, compared with 2024-09-28. Start at Item 1A, Risk Factors, to read the changed disclosure beside its sources.

Read Apple's risk-factor changes

The comparison's JSON button downloads counts and limited change samples for all filing items, with both source URLs. It is not a full redline. This dated example is not a claim about the latest filing. Sources: 10-K filed 2025-10-31 and 10-K filed 2024-11-01.

2. Make your first API request

Every API request requires a key. Get a free API key for your email (200 calls a day for personal use) or choose a monthly plan, then find Apple's latest 10-K:

curl -fsS -H "x-api-key: YOUR_KEY" "https://filings.tools/api/v1/filings?ticker=AAPL&form=10-K&limit=1"

The response contains the company, a filing ID, its date and the SEC source. Use that ID in the section and facts requests below.

Responses are not cached, because each carries your own allowance. Parsed filings are kept on our server so repeated calls usually avoid another EDGAR fetch.

Get a free API key · See monthly plans

To get filing content, replace YOUR_KEY with your free API key or subscription key. This request returns the dated example's Item 1A as Markdown, with its SEC source. It uses one API call.

curl -fsS -H "x-api-key: YOUR_KEY" "https://filings.tools/api/v1/filings/320193-000032019325000079/sections?section=item-1a&format=md"

Omit format=md for JSON with a sections array. Use the filing ID from the first request for another filing. If the requested section is absent, JSON can contain an empty array; omit section to inspect the available sections. An empty result does not prove a disclosure is absent from the original filing.

3. Choose a plan for your work

Free use is for one person: your own projects or your studies. Production, team and commercial use need a paid plan.

A free key for your email allows 200 calls per UTC day for personal use. Starter is $19 a month for production use: the batch call (one section across up to 25 companies per request) and table exports, within 10,000 calls per UTC day. Pro adds bulk XBRL facts. Plans renew monthly; there are no automatic overage charges.

Review Starter: $19/month

Review the plan and its checkout terms before subscribing. You do not need a subscription to read the example.

Use in an assistant

Connect an assistant or IDE that supports remote MCP to https://filings.tools/mcp using Streamable HTTP with your API key in x-api-key or Authorization: Bearer. Free use shares a free key's 200 calls per UTC day; paid keys use their plan allowance. Each lookup uses one call; connecting and listing tools use none. Availability of custom connectors and header authentication depends on your client and account.

Add to ClaudeAdd to CursorAdd to VS Code

Export FILINGS_API_KEY in your shell before running the CLI or opening Cursor or VS Code so each client sends Authorization: Bearer. Web chat connectors (Claude, ChatGPT) work only where your client lets you configure an Authorization: Bearer or x-api-key header for https://filings.tools/mcp; OAuth sign-in is not implemented and keyless tool calls return 401.

By hand: in Cursor, use mcpServers.filings.url; in VS Code, use servers.filings with type: http and the same URL. Connecting directly is separate from a directory listing.

Start with “Find Apple's latest 10-K and its SEC source.” Use its returned filing id to read a section or facts. Section replies are excerpts; comparisons show up to eight sections, two samples per change type and 400 characters per sample. These are not complete redlines. Missing data does not prove the company omitted a disclosure. Check important values against the cited original. Aggregate usage excludes arguments and filing text; see privacy.

List filings

GET /api/v1/filings?ticker=NVDA&form=10-K&limit=20
GET /api/v1/filings?cik=1045810              # or ?ticker=1045810: a CIK works in place of a ticker

Returns the company profile and the recent filings with ids. Forms: 10-K, 10-Q, 8-K, amendments, 20-F, 40-F. Any company in the SEC's ticker list works, by ticker (EDGAR spelling, so BRK-B; BRK.B is accepted) or by CIK. An unknown ticker or CIK returns 404 with unknown_ticker or unknown_cik, close matches when there are any, and a link to the SEC's company search. A ticker in ?cik= returns 400 invalid_cik.

The SEC allows ten requests a second, so filings not yet cached are fetched in turn. When too many are waiting, or EDGAR does not answer, any endpoint returns 503 with edgar_busy or edgar_unavailable and a Retry-After header in seconds.

Parsed sections

Send your free API key or subscription key in the x-api-key header. The reader's Copy and Markdown controls export the document already on the page. Free keys retain the shared free capacity limit; subscription keys use their plan allowance.

GET /api/v1/filings/{id}/sections            # JSON: sections[] with id, title, markdown, chars
GET /api/v1/filings/{id}/sections?format=md  # one markdown document
GET /api/v1/filings/{id}/sections?section=item-1a   # a single section

XBRL facts

GET /api/v1/filings/{id}/facts        # revenue, net income, EPS, assets, cash, debt, shares, opex, capex, operating cash flow
GET /api/v1/filings/{id}/facts?all=1  # every reported period for those concepts (Pro and Business)

Compare with the preceding filing

GET /api/v1/filings/{id}/diff   # counts of added, removed and changed sentences per section, against the preceding filing of the same form

Returns totals, one entry per section with limited samples, and the two filings compared. It is not a full redline. The earliest filing of a form has nothing to compare against: that is a 200 with comparable: false and a reason, not an error.

One section across companies (paid plans)

curl -fsS -H "x-api-key: YOUR_KEY" "https://filings.tools/api/v1/sections?tickers=AAPL,MSFT,NVDA&form=10-K&section=item-1a"

GET /api/v1/sections returns the same section of the latest filing of one form for up to 25 tickers or CIKs: the risk factors of a whole watchlist in one request. Each company has its own status (ok, unknown_ticker, no_filing, no_section or error), its filing id and dates, the SEC source and the section text, so one missing company never fails the rest. A company named twice (a ticker and its CIK) is answered once and listed under duplicates. Add format=md for one Markdown document with a heading per company. One answer holds at most 3.5 MB: when the sections are longer, each is cut to its share, marked truncated, and filing.sectionsUrl returns the whole section.

It is part of the paid plans and uses one call per company. The whole batch is checked against your remaining calls before any company's filing is fetched. Companies with status error are given back, but a request always uses at least one call. A request without a key answers 401 api_key_required; a free key or RapidAPI BASIC answers 402 plan_required and uses none of your calls. One company at a time works with a key through the sections route above.

Tables as CSV (plans)

curl -H "x-api-key: YOUR_KEY" -OJ "https://filings.tools/api/v1/filings/{id}/tables"                 # every table in the filing
curl -H "x-api-key: YOUR_KEY" -OJ "https://filings.tools/api/v1/filings/{id}/tables?section=item-8"  # one section
curl -H "x-api-key: YOUR_KEY" "https://filings.tools/api/v1/filings/{id}/tables?format=json"         # rows as JSON

Every table in a filing or section, with split figures joined and spacer columns dropped, so columns line up in a spreadsheet. Values are copied as filed, never recomputed. Any plan; one call each. Without a subscription key it answers 401 or 403 and uses none of your allowance.

Keys and limits

curl -H "x-api-key: YOUR_KEY" https://filings.tools/api/v1/filings?ticker=AAPL

Every request requires an API key in x-api-key or Authorization: Bearer; without one, the API answers 401 api_key_required. Every counted response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. A free key for your email keeps 200 calls a day, and a plan from pricing raises it to 10,000 and more. Over the limit returns 429 with a pricing link. Reading filings on the site never counts against the API.

Your own standing

curl -H "x-api-key: YOUR_KEY" https://filings.tools/api/v1/me

Returns your plan, your daily ceiling, how much is left, and when it resets. Counters run per UTC day. Reading this does not use any of your allowance.

{
  "product": "filings",
  "caller": "key",
  "plan": "filings_pro_monthly",
  "limitKind": "calls_day",
  "unit": "calls",
  "limit": 50000,
  "remaining": 49873,
  "used": 127,
  "resetIso": "2026-09-21T00:00:00.000Z",
  "persistent": true
}

persistent says whether the count is held in shared storage. When false it is held per instance and a deploy resets it.

Terms

Source documents are public domain SEC filings. Attribution to filings.tools is requested on the free tier. No warranty; verify against the original on sec.gov before relying on a number.