Look up a reviewed ATO rate for a date
get_reviewed_rateReturns one reviewed ATO rate or threshold for a specific date, plus its source URL and verbatim quote, and refuses out-of-range dates so you never rely on a nearby year.
Instructions
Return one reviewed ATO rate or threshold for a date, with its source and quote.
Reads a bundled copy of reviewed records, each holding the figure, its unit and period, the ATO page, when that page was captured and a verbatim quote containing the figure, with no folder to configure. The records cover 2025-26 and 2026-27 only. status is FOUND only when as_at falls in those years and in the named record's own period. Otherwise status is REFUSED, the reason says so and no figure is returned: a date outside those years, even for an open-ended record; a date outside the record's period, with covering_ids naming any record of the same figure that holds that date; a record with no recorded period; or an unknown id. Never answer a refusal with a nearby year. An open-ended record stays FOUND for a date after it was last read, with after_last_read true and after_last_read_note saying that it was last read on that date and does not show the figure still applied on as_at. A record is a point-in-time copy, not a live lookup, and takes no account of an entity's facts: retain source_url, quote, notes and the statement, and confirm the figure at the source. Use search_tax_rates for a configured legislation corpus and the reviewed engines for a calculation. Reads no network.
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": {
"record_id": "<record_id>",
"as_at": "<as_at>"
},
"name": "get_reviewed_rate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_at | Yes | The YYYY-MM-DD date the figure is needed for. Do not infer today. | |
| record_id | Yes | Record id, such as 'concessional-cap-2026-27' or 'gst-registration-threshold'. An unknown id is refused with every id in known_ids. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | The lookup ran; see status for its outcome. | |
| as_at | Yes | Date in YYYY-MM-DD form. | |
| reason | Yes | The refusal in words; null when FOUND. | |
| record | Yes | The record when FOUND, otherwise null. | |
| status | Yes | REFUSED carries no figure; never fill the gap with a nearby year. | |
| refusal | Yes | Why no figure came back, or null when FOUND. | |
| currency | Yes | A record never establishes that a figure is current. | |
| known_ids | Yes | Every record id; supplied for an unknown id only. | |
| record_id | Yes | ||
| statement | Yes | Limits to retain when presenting the result. | |
| covering_ids | Yes | Records of the same figure that do cover as_at, if any. | |
| covered_years | Yes | The income years the bundled records cover. | |
| record_period | Yes | The period the named record holds; null when FOUND or unknown. | |
| after_last_read | Yes | True when an open-ended record is asked about a date after it was last read, so it does not show the figure still applied. | |
| after_last_read_note | Yes | That limit in words; retain it. Null when after_last_read is false. |