Filings

The financial reports (10-K, 10-Q, 20-F, 40-F and their Korean, Japanese, Chinese and European equivalents) on file for a company.

MCP tool	CLI command
`akkru_filings`	`akkru filings`

#Actions

Action	What it does
`list`	One company's filings for one fiscal year, with each filing's id, form, quarter, registrant, fact count, whether it has an Excel file (has_excel), and a note when an amendment was merged in. 10 credits.
`excel`	A download URL for one filing's Excel file, valid for one hour. 300 credits.

Older years and some markets depend on your plan.

#Parameters

filing_idinteger

Filing id from the list action of Filings. Name the filing with filing_id, or with ticker and fiscal_year, not both.

tickerstring

Company ticker, e.g. "AAPL" (US), "000100" (Korea), "1332" (Japan), "VIRI_F" (Europe), "600519_CN" (China A-share); any symbol the company has traded under.

fiscal_yearinteger

Fiscal year of the filing (1990-2100).

form_typestring

Form: "10-K", "10-Q", "20-F" or "40-F" (Korean, Japanese, Chinese and European filings use "10-K" for annual and "10-Q" for interim reports). list: filters the list, omit for every form; excel: defaults to "10-K".

quarterstring

"FY", "Q1", "Q2", "Q3" or "Q4". list: filters the list, omit for every quarter; excel: needed only when the fiscal year has several filings of the form; the error then lists the quarters on file.

detailstring

Response detail, same price at every level: "full" (default) returns everything; "light" leaves out the bulkiest fields, such as breakdown lists; "minimal" returns only the values and what identifies them, without sources or calculation details. Every action takes it; a call without detail levels ignores it. Try "light" or "minimal" for shorter replies that use less context and fewer tokens. One of full, light, minimal.

#Examples

MCP

{"action": "list", "ticker": "AAPL", "fiscal_year": 2025}

CLI

akkru filings list --ticker AAPL --fiscal-year 2025

MCP

{"action": "excel", "ticker": "AAPL", "fiscal_year": 2025}

CLI

akkru filings excel --ticker AAPL --fiscal-year 2025