What inputs does list_restatements accept?

event_id (string, optional): Fetch exactly one event by its id (from a prior response). ticker (string, optional): Restrict to one company — ticker (e.g. 'AAPL') or CIK (e.g. '0000320193'). sector (string, optional): Restrict to one GICS-style sector (e.g. 'Technology'). severity ("high" | "medium" | "low", optional): high = |Δ|≥10%, medium = ≥2%, low = ≥0.5%. min_abs_delta_pct (number, optional): Only events whose absolute restatement is at least this percent (e.g. 5 = ≥5% swings). max_importance (integer, optional): Only lines at or above this importance tier: 1 = headline only (revenue, net income, EPS, total assets, operating cash flow), 2 = + primary statement lines, 3 = everything incl. footnotes. Severity says how far a number moved; importance says whether anyone cares. amendments_only (boolean, optional): Only restatements that arrived in an AMENDED filing (10-K/A, 10-Q/A) — the company formally telling the SEC it got a number wrong. The sharpest cut there is: it separates real restatements from routine re-files (a next-year 10-K carrying a revised comparative). disclosure (array, optional): Filter by HOW the company told the market. 'non_reliance' = it filed an 8-K Item 4.02 ('Non-Reliance on Previously Issued Financial Statements') — formally telling the SEC not to rely on what it already reported. The loudest signal in US disclosure, and rare. 'amended' = corrected in a 10-K/A or 10-Q/A. 'undisclosed' = the value changed inside a ROUTINE 10-Q or 10-K: no amendment, no 4.02, the old number is simply gone. ~94% of events. Anyone can parse an 8-K, so anyone can list what companies ANNOUNCED; finding what they didn't requires every vintage back to 1993. filed_since (string, optional): Only restatements FILED on or after this date — the 'what changed recently' window. as_of_date (string, optional): Point-in-time filter: only restatements whose restating filing was accepted (last_filed_at) on or before this day, inclusive. Results are point-in-time ONLY when this is passed — omit it and later restatements are included. Use for backtests and dated analyses to avoid look-ahead bias. sort ("recent" | "significance", optional, default "recent"): 'recent' = newest restating filing first (a market-wide radar). 'significance' = importance tier, then swing size (one company's history). limit (integer, optional, default 25): Page size (1-100, default 25). cursor (string, optional): Opaque pagination cursor from a prior response's next_cursor.

Which Valuein plans include list_restatements?

Available on every plan, including the free tier with no account. Not point-in-time safe.

Discovery

Restatement Radar Feed

list_restatements

Sample and above

List financial-statement restatements — facts a later SEC filing materially changed (>0.5% swing) from what was originally reported. Each event carries the as-reported value, the restated value, the signed delta, a severity bucket, the RAW XBRL tag both filings used (the diff ...

Example Call

example_call.pypython

# Using the Valuein MCP server from Python (via MCP SDK)# Or call directly from Claude / Cursor after setup result = await client.call_tool(    "list_restatements",    arguments={})print(result)

Direct tool call:list_restatements(...)

Try it now

No token required

Paste this in your terminal — the free tier returns real sample data without authentication.

try-it.shbash

# No auth required — the Sample tier covers a large-cap US benchmark universe with a 5-year window.# Add -H "Authorization: Bearer $VALUEIN_TOKEN" for the full universe and history.curl -X POST https://mcp.valuein.biz/mcp \    -H "Content-Type: application/json" \    -H "Accept: application/json, text/event-stream" \    -d '{        "jsonrpc": "2.0",        "id": 1,        "method": "tools/call",        "params": {          "name": "list_restatements",          "arguments": {            "limit": 3          }        }      }'

Inputs

Parameter	Type	Required	Description
`event_id`	string	optional	Fetch exactly one event by its id (from a prior response).
`ticker`	string	optional	Restrict to one company — ticker (e.g. 'AAPL') or CIK (e.g. '0000320193').
`sector`	string	optional	Restrict to one GICS-style sector (e.g. 'Technology').
`severity`	"high" \| "medium" \| "low"	optional	high = \|Δ\|≥10%, medium = ≥2%, low = ≥0.5%.
`min_abs_delta_pct`	number	optional	Only events whose absolute restatement is at least this percent (e.g. 5 = ≥5% swings).
`max_importance`	integer	optional	Only lines at or above this importance tier: 1 = headline only (revenue, net income, EPS, total assets, operating cash flow), 2 = + primary statement lines, 3 = everything incl. footnotes. Severity says how far a number moved; importance says whether anyone cares.
`amendments_only`	boolean	optional	Only restatements that arrived in an AMENDED filing (10-K/A, 10-Q/A) — the company formally telling the SEC it got a number wrong. The sharpest cut there is: it separates real restatements from routine re-files (a next-year 10-K carrying a revised comparative).
`disclosure`	array	optional	Filter by HOW the company told the market. 'non_reliance' = it filed an 8-K Item 4.02 ('Non-Reliance on Previously Issued Financial Statements') — formally telling the SEC not to rely on what it already reported. The loudest signal in US disclosure, and rare. 'amended' = corrected in a 10-K/A or 10-Q/A. 'undisclosed' = the value changed inside a ROUTINE 10-Q or 10-K: no amendment, no 4.02, the old number is simply gone. ~94% of events. Anyone can parse an 8-K, so anyone can list what companies ANNOUNCED; finding what they didn't requires every vintage back to 1993.
`filed_since`	string	optional	Only restatements FILED on or after this date — the 'what changed recently' window.
`as_of_date`	string	optional	Point-in-time filter: only restatements whose restating filing was accepted (last_filed_at) on or before this day, inclusive. Results are point-in-time ONLY when this is passed — omit it and later restatements are included. Use for backtests and dated analyses to avoid look-ahead bias.
`sort`	"recent" \| "significance"	optional	'recent' = newest restating filing first (a market-wide radar). 'significance' = importance tier, then swing size (one company's history).Default: `"recent"`
`limit`	integer	optional	Page size (1-100, default 25).Default: `25`
`cursor`	string	optional	Opaque pagination cursor from a prior response's next_cursor.

Output Fields

eventstotalnext_cursornote

Paging

Pass the next_cursor of one result as cursor on the next call, with the same other arguments. A null next_cursor is the last page.

Errors and paging for every tool: the agent contract.

Example Response

Illustrative

response.jsonjson

{  "events": null,  "total": null,  "next_cursor": null,  "note": null}

Shape only — field names match the live schema; values are placeholders, not real filings. See MCP server for the structured response shape.

Notes

Available from the Sample plan and above.

Try this tool

Get token All tools

CategoryDiscovery

PIT-safeNo

Min planSample

Inputs13 (0 required)

Plan Access

Sample (guest)

Available

Benchmark (token)

Available

Pro

Available

Institutional

Available

Related Tools

search_companies

Search Companies

get_company_fundamentals

Company Fundamentals

get_valuation_metrics

Valuation Metrics

get_financial_ratios

Financial Ratios

Resources

Point-in-Time methodology →Parquet schema reference →Bulk Data API reference →Python SDK guide →

Index names are trademarks of their owners; Valuein is not affiliated with or endorsed by any index provider.