Filings

TOOLfiling_list

Which filings are indexed for a ticker — fiscal period, type, filing date — before you search inside them.

Coverage: US / CN / JP
Billing: Per call · 0.1 cr / call

Input parameters

Parameter	Type	Required	Description
ticker	string	required	Stock ticker, e.g. NVDA, 600519.SH, 6758.T.
filing_types	string[]	optional	Omit for the default set: periodic reports, IPO and shelf registrations, amendments — no ad-hoc disclosures. Pass [] for every indexed type, or an explicit allowlist taken from the filing_type column of an earlier unfiltered call.

Example

Arguments

{ "ticker": "NVDA", "filing_types": ["10-K"] }

Response

NVDA — 7 filings (67 total before filing_types filter)
Period coverage: 2019-01-27 → 2026-01-31
Types: 10-K×7

| FY | Q | Type | Filed | Period |
|---|---|---|---|---|
| 2026 | FY | 10-K | 2026-02-25 | 2025-02-01 ~ 2026-01-31 |
| 2025 | FY | 10-K | 2025-02-26 | 2024-01-27 ~ 2025-01-26 |
| 2024 | FY | 10-K | 2024-02-21 | 2023-01-29 ~ 2024-01-28 |

Trimmed: Three of seven rows shown.

Limits

Limit	Value	Past it
Filings rendered	50	Header still counts all; narrow with filing_types

Errors

Invalid arguments are refused before the tool runs; the rest arrive as a tool failure whose text is the message. The four shapes are on MCP server.

When	You get	Do
Unknown ticker	"No filings found for <ticker>."	Check the symbol with ticker_lookup
Filter matches nothing	"<n> filings indexed but none match filter"	filing_types: [] or an allowlist from an unfiltered call

Notes

Filing types are market-native: SEC form names for the US (10-K, 10-Q, 8-K, 20-F …), plain names for A-shares (annual_report, quarterly_report, q1_report), EDINET numeric codes for Japan (120 annual, 140 quarterly, 160 semi-annual). Opaque codes come back labelled.
At most 50 rows per call. Narrow with filing_types to see a specific kind.

Endpoint, client setup and billing are common to all tools. For details, please refer to MCP server.