latest
Retrieve the most recent observations per measure from a dataset, automatically trimming time-series to the latest period and limiting rows for large registers.
Instructions
Return the most recent observation(s) per measure for a dataset.
For transposed time-series tables (GST_MONTHLY etc.) this trims to the
most-recent period. For wide register-shaped tables (ACNC_REGISTER,
IND_POSTCODE etc.) it returns the same shape as get_data, capped at
limit rows. Truncated responses set DataResponse.truncated_at.
Examples: # Latest monthly net GST nationally resp = await latest("GST_MONTHLY", measures="net_gst")
# 50 charities (default cap) — narrow with filters to get specific ones
resp = await latest("ACNC_REGISTER", filters={"state": "nsw", "charity_size": "Large"})Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return. Register-shaped datasets (ACNC_REGISTER ~65k charities, ACNC_AIS_FINANCIALS ~50k) would otherwise blow an agent's context window. Pass filters to narrow to one entity, or raise `limit` only if you need a bulk dump. Truncated responses set DataResponse.truncated_at to the original row count so agents can detect + surface it. Time-series datasets (GST_MONTHLY etc.) already trim to the latest period and are unaffected by this cap. | |
| filters | No | Same filter shape as get_data. Useful for narrowing to one entity. | |
| measures | No | Same as get_data. | |
| dataset_id | Yes | Curated dataset ID. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| csv | No | ||
| unit | No | ||
| query | No | ||
| stale | No | ||
| period | No | ||
| source | No | Australian Taxation Office | |
| ato_url | Yes | Click-through URL for this dataset's source page. ato-mcp legacy name — prefer source_url (canonical) for new code. Both fields are populated identically. | |
| records | No | ||
| row_count | No | ||
| dataset_id | Yes | ||
| source_url | Yes | Canonical click-through URL. Same value as ato_url; both populated for backward compat. | |
| attribution | No | Data sourced from the Australian Taxation Office (and, for charity data, the Australian Charities and Not-for-profits Commission) via data.gov.au. Licensed under Creative Commons Attribution 3.0 Australia (CC BY 3.0 AU). https://creativecommons.org/licenses/by/3.0/au/ | |
| dataset_name | Yes | ||
| retrieved_at | Yes | ||
| stale_reason | No | ||
| truncated_at | No | ||
| server_version | No |