get_financials
Get financial statements for an NZX company. Includes income statement, balance sheet, cash flow, and financial ratios. Filter by statement type and year range.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "get_financials"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Year or range (e.g. "2024" or "2020-2024") | |
| limit | No | Max results per statement type | |
| ticker | Yes | NZX ticker symbol | |
| statement | No | Statement type: income, balance, cashflow, ratios, or comma-separated (default: all) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or "none found". | |
| meta | Yes | ||
| tool | Yes | Tool that produced this result. | |
| schema_version | Yes | Envelope contract version. Bumps only on a breaking shape change. |