filingstudio docs
API statusAccount ↗
Filing Studio API

Financial context for AI.

Use Filing Studio when your application needs the SEC filing behind a number: exact printed rows, tables, disclosures, source context, and traceable evidence.

Quickstart

Start with /v1/search. You do not need to know which filing table contains the answer before you search.

curl "https://api.filingstudio.com/v1/search?ticker=NVDA&q=revenue&type=rows&period=2025" \ -H "X-API-Key: $KEY"
Get an API key from your account page — it's shown once at creation and only a hash is stored.

Authentication

Send your API key in the X-API-Key header (or as a ?key= query parameter when headers aren't possible). Keep production keys on your server.

X-API-Key: fsk_...

Response shape

Every /v1 endpoint answers with the same envelope, and every numeric cell has the same shape — the filer's printed value plus everything needed to understand and verify it.

{ "data": { "results": [{ "value": 130497, "printedText": "130,497", "label": "Revenue", "period": "FY2025", "units": "in millions", "traceId": "NVDA|…|p10|3|2|v10", "viewerUrl": "…", "source": { accession, form, filedDate, tableId, rowIndex, physCol } }]}, "provenance": { … }, "pagination": { "limit": 50, "offset": 0, "returned": 7 }, "links": { "self": "…" } }

Filings

GET/v1/filings/{ticker}

A company's indexed filings — filter with form, year, start_date, end_date.

GET/v1/filings/{ticker}/{accession}

One filing. Add ?include=tables,prose,exhibits to expand it in one call, or use the sub-routes /tables, /prose, /exhibits.

Tables

GET/v1/tables/{ticker}/{accession}/{tableId}

The filer's printed table with heading, row order, period headers, labels, values, units, and traces preserved. ?format=grid|records|csv picks the shape; /xlsx downloads Excel, /periods lists its printed period headers, and /same-in finds the same table in other filings.

GET /v1/tables/FDX/0000950170-22-012762/primary:83?format=records

Trace

GET/v1/trace/{traceId}

Resolve any returned traceId back to the exact printed evidence: the filing, the table, the row, the literal, and a viewer URL a human can open on that line.

Verify

POST/v1/verify

Check a financial claim against what the filings actually print. Deterministic — no model can invent support. The verdict is supported, unsupported (with what the filing prints instead), or ambiguous (e.g. a restatement, with both receipts).

{ "ticker": "FDX", "claim": "FedEx reported $69.2 billion of revenue in fiscal 2020" } // or structured: { "ticker": "FDX", "metric": "Revenue", "value": 69217000000, "period": "2020" }

MCP

The same infrastructure as native agent tools. Point any MCP client (Claude, Cursor, Codex, …) at the endpoint and authenticate with your API key — the same key as the REST API, sent as a Bearer token or X-API-Key header. Clients that only accept a URL can append the key as a path segment: /mcp/{key}.

{ "mcpServers": { "filingstudio": { "url": "https://api.filingstudio.com/mcp", "headers": { "X-API-Key": "YOUR_API_KEY" } } } }

Agent guide

How coding and research agents should use Filing Studio:

  • Search source evidence before generating a financial claim.
  • Preserve traceId and viewerUrl whenever presenting a financial fact.
  • Open surrounding table context when a caption or value is ambiguous.
  • Do not invent values when Filing Studio returns no supporting evidence.
  • If evidence conflicts across filings, present the conflict instead of guessing.

The account page has a one-click Copy docs for agent block you can paste straight into an agent conversation.

Errors

400 Bad input (e.g. missing ticker on /v1/verify) 401 Invalid or missing research key 404 Resource not found 429 Daily request limit reached

Pagination

List endpoints take limit and offset. The envelope's pagination object echoes them with returned, and includes nextOffset when a full page came back — keep paging until it disappears.

Rate limits

Free accounts get 500 requests/day; Pro ($10/month) gets 5,000/day. Limits count per account across all your keys, for REST and MCP alike. Hitting the cap returns 429 until the UTC day rolls over. Need more? support@filingstudio.com.