List annual reports
list_annual_reportsRetrieve a company's filed annual reports by registry code or year, including submission dates, revenue, balance-sheet totals, employee counts, audit status, and report file links.
Instructions
Annual reports filed by a company (REST, needs an API key): year, submission date, revenue, balance-sheet total, employee count, audit status, and links to the report files (PDF, BDOC/DDOC, XBRL). For the actual balance-sheet and income-statement lines use get_annual_report_figures.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_annual_reports"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (default 1). | |
| year | No | Reporting year. | |
| language | No | Language of classifier texts (statuses, roles, legal forms): 'eng' (default) or 'est'. | |
| page_size | No | Results per page, 1–1000 (default 100). | |
| submitted_to | No | Submitted on or before this date-time (ISO 8601). | |
| document_type | No | A = PDF, D = BDOC/DDOC, X = XBRL. | |
| registry_code | No | 8-digit Estonian registry code (registrikood), e.g. 14663023. Find it with search_companies. | |
| submitted_from | No | Submitted on or after this date-time (ISO 8601). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list | Yes | ||
| total | Yes |