What inputs does list_report_versions accept?

report_id (string, required): Identifier of the report whose version history to list, as returned by create_report or list_my_reports. limit (integer, optional, default 20): Maximum number of archived versions to return (1–100). Defaults to 20. cursor (integer, optional): Cursor from the previous response's `next_cursor` — the smallest version number on the previous page. Omit for the first page.

Which Valuein plans include list_report_versions?

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

reports

List Report Versions

list_report_versions

Sample and above

Author-only newest-first listing of a report's archived version history. Each entry summarises what changed (sections edited, etc.) so the workspace UI can render a clickable history without loading every artifact. Pair with `get_report_version` to fetch a specific version's c...

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_report_versions",    arguments={    "report_id": "EXAMPLE"})print(result)

Direct tool call:list_report_versions(...)

Inputs

Parameter	Type	Required	Description
`report_id`	string	required	Identifier of the report whose version history to list, as returned by create_report or list_my_reports.
`limit`	integer	optional	Maximum number of archived versions to return (1–100). Defaults to 20.Default: `20`
`cursor`	integer	optional	Cursor from the previous response's `next_cursor` — the smallest version number on the previous page. Omit for the first page.

Output Fields

versionsnext_cursor

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

{  "versions": null,  "next_cursor": 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

Categoryreports

PIT-safeNo

Min planSample

Inputs3 (1 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.