get_dividends
Get dividend history for an NZX company. Includes ex-date, payment date, amount (DPS), imputation %, DRP availability, summary stats. Company pages also show Dividend Safety Score (0-100 with 5 components), Forward Dividend Cut Probability (0-100% with risk factors), and Payout Ratio Trend Charts with sector benchmarks.
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_dividends"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Dividend type: final, interim, special | |
| year | No | Year or range (e.g. "2024" or "2020-2024") | |
| limit | No | Max results | |
| ticker | Yes | NZX ticker symbol |
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. |