Get ATO lodgment program due dates
get_lodgment_due_datesList ATO lodgement, payment and concession due dates for BAS, IAS and income tax returns, including holiday-adjusted timing and DETERMINED or UNKNOWN status.
Instructions
List lodgement, payment and concession due dates from lodgment-calendar.
Covers the ATO 2026-27 lodgment program: monthly and quarterly BAS and IAS for 2026-27 periods, and 2025-26 income tax returns for individuals, trusts, partnerships, companies (including consolidated head companies) and SMSFs, lodged by the taxpayer or a registered tax or BAS agent. Each row gives status DETERMINED or UNKNOWN, due_date after the next-business-day roll under the ATO's public holiday table, nominal_due_date, rule_id, summary, source_url, source_provision, source_checked and missing. A payment row appears only where payment is not due with the lodgement. UNKNOWN names each fact not supplied or question the ATO pages leave open; report it as UNKNOWN. Dates after 30 June 2027 stay UNKNOWN unless holidays_complete_until covers them. Retain not_decided and warnings. Not advice; lodges nothing and 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": {
"obligation": "<obligation>",
"entity_type": "<entity_type>",
"financial_year": "<financial_year>",
"channel": "<channel>"
},
"name": "get_lodgment_due_dates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| facts | No | Program conditions as established; omit any that is not. | |
| channel | Yes | Who lodges. A BAS agent cannot lodge an income tax return. | |
| obligation | Yes | Activity statement (BAS or IAS) or income tax return. | |
| entity_type | Yes | The entity that lodges. | |
| extra_holidays | No | Public holidays for the whole of a state or territory that the ATO table (1 July 2026 to 30 June 2027) does not list, from an official source. Omit unless established. | |
| financial_year | Yes | YYYY-YY: the year of the statement periods (2026-27 recorded), or the income year a return covers (2025-26 recorded). Other years return UNKNOWN. | |
| reporting_cycle | No | Required for bas and ias; omit for income_tax_return. A monthly bas reports GST monthly; other monthly activity statements are ias. A quarterly instalment reported on a monthly BAS is monthly. For a consolidated head company, a quarterly ias is its PAYG instalment activity statement. | |
| holidays_complete_until | No | YYYY-MM-DD: only when the ATO table plus extra_holidays hold every such holiday to this date. Settles dates after 30 June 2027; never guess it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | The review ran; this does not mean compliance or a known verdict. | |
| counts | Yes | Rows per status. | |
| engine | Yes | Delegated distribution that produced this result. | |
| request | Yes | Obligation, entity, year, channel. | |
| calendar | Yes | ||
| warnings | Yes | Retain when presenting the result. | |
| disclaimer | Yes | ||
| facts_used | Yes | Each fact; null is not supplied. | |
| not_decided | Yes | Retain when presenting the result. | |
| obligations | Yes | ||
| program_year | Yes | Income or dataset year in YYYY-YY form. | |
| engine_version | Yes | Installed version of that engine. | |
| source_checked | Yes | Date in YYYY-MM-DD form. | |
| holiday_calendar | Yes | Holiday rule, ATO table source and coverage. |