{"openapi":"3.1.0","info":{"title":"Australia Payday Super API","version":"0.1.0","description":"Australia Payday Super answers the three questions an owner's payroll agent asks every pay run. super_due_date gives the last day the employee's fund must have received the contribution: 7 business days after payday, or 20 business days for a first contribution to a new employee or fund, with the ATO's business-day definition (any day that is not a weekend or a public holiday for the whole of any...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://au-payday-super.connectorbay.com/mcp.\n\nDisclaimer: General information only, not legal, tax, accounting or payment advice. Australia Payday Super is an independent tool: it is not affiliated with, endorsed by or operated by any government body, central bank, standards body or scheme operator. Rates, thresholds and rules change; check the cited official source and confirm with a qualified professional before you rely on a result.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/au-payday-super/docs"},"termsOfService":"https://connectorbay.com/au-payday-super/terms"},"servers":[{"url":"https://au-payday-super.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/au-payday-super/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/super_due_date":{"post":{"operationId":"super_due_date","summary":"Last day an employee's super fund must have received the contribution for a payday under Payday Super: 7 business days a","description":"Last day an employee's super fund must have received the contribution for a payday under Payday Super: 7 business days after payday, 20 for first contributions, with the ATO business-day rule applied. Use for \"Staff are paid on Thursday 10 December 2026: by what date must the super be in their funds?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pay_date":{"description":"Payday (the day qualifying earnings are paid), YYYY-MM-DD, on or after 2026-07-01","title":"Pay Date","type":"string"},"situation":{"default":"standard","description":"standard (default), first_contribution_new_employee_or_fund, recommenced_contributions, out_of_cycle or exceptional_circumstances","title":"Situation","type":"string"},"next_regular_pay_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Only for out_of_cycle: the next payment of qualifying earnings that is not out of cycle, YYYY-MM-DD","title":"Next Regular Pay Date"},"determination_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Only for exceptional_circumstances: the date the ATO determination is made, YYYY-MM-DD","title":"Determination Date"},"public_holidays":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"ISO dates (YYYY-MM-DD) that are a public holiday for the whole of ANY Australian state or territory inside the counting window; weekends are excluded automatically","title":"Public Holidays"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date used for 'days remaining' (YYYY-MM-DD); defaults to today","title":"On Date"}},"required":["pay_date"],"title":"super_due_dateArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/upcoming_super_deadlines":{"post":{"operationId":"upcoming_super_deadlines","summary":"Every standard 7-business-day super deadline falling in the next N days for a payroll calendar. Use for \"Which super pay","description":"Every standard 7-business-day super deadline falling in the next N days for a payroll calendar. Use for \"Which super payments fall due in the next two weeks for my fortnightly payroll?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pay_dates":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Explicit list of paydays (YYYY-MM-DD); use this or first_pay_date with frequency","title":"Pay Dates"},"first_pay_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A known payday of a recurring cycle, YYYY-MM-DD","title":"First Pay Date"},"frequency":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"weekly, fortnightly or four_weekly (with first_pay_date)","title":"Frequency"},"days":{"default":14,"description":"Look-ahead window in days, 1 to 120","maximum":120,"minimum":1,"title":"Days","type":"integer"},"public_holidays":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"ISO dates that are a public holiday for the whole of any Australian state or territory","title":"Public Holidays"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start of the window, YYYY-MM-DD; defaults to today","title":"On Date"}},"title":"upcoming_super_deadlinesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/calc_sg_qualifying_earnings":{"post":{"operationId":"calc_sg_qualifying_earnings","summary":"Super guarantee at 12% of the qualifying earnings you enter for one pay run (ordinary time earnings, salary sacrifice co","description":"Super guarantee at 12% of the qualifying earnings you enter for one pay run (ordinary time earnings, salary sacrifice contributions and other amounts). Use for \"What is the 12% super on $3,000 of ordinary time earnings plus $200 salary sacrificed?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ordinary_time_earnings":{"description":"Ordinary time earnings paid in this pay run, AUD as a decimal string","title":"Ordinary Time Earnings","type":"string"},"salary_sacrifice_contributions":{"default":"0","description":"Salary sacrifice contributions in this pay run, AUD","title":"Salary Sacrifice Contributions","type":"string"},"other_qualifying_amounts":{"default":"0","description":"Other amounts you have determined are included in salary or wages for super guarantee, AUD","title":"Other Qualifying Amounts","type":"string"},"earnings_cap":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional ceiling on the earnings base that you supply (for example a maximum contribution base from the ATO); applied as given","title":"Earnings Cap"},"pay_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Payday, YYYY-MM-DD, on or after 2026-07-01; defaults to today","title":"Pay Date"}},"required":["ordinary_time_earnings"],"title":"calc_sg_qualifying_earningsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/estimate_sgc_exposure":{"post":{"operationId":"estimate_sgc_exposure","summary":"Estimate of the super guarantee charge for one late payday: shortfall, daily-compounding interest at the ATO general int","description":"Estimate of the super guarantee charge for one late payday: shortfall, daily-compounding interest at the ATO general interest charge rate, administrative uplift, choice loading and the late payment penalty. Use for \"If we miss the super for the 14 August 2026 payday and are assessed on 15 December 2026, what could the charge be?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"unpaid_super_amount":{"description":"Total unpaid super guarantee for the payday (the shortfall), AUD","title":"Unpaid Super Amount","type":"string"},"qe_day":{"description":"The payday the shortfall relates to, YYYY-MM-DD, on or after 2026-07-01","title":"Qe Day","type":"string"},"assessment_date":{"description":"Assumed date of the ATO assessment, YYYY-MM-DD","title":"Assessment Date","type":"string"},"gic_annual_rate_percent":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional single annual general interest charge rate (percent) to apply to every day; if omitted the built-in 2026 quarterly table is used","title":"Gic Annual Rate Percent"},"no_ato_assessment_in_prior_2_years":{"default":false,"description":"True if there was no ATO-initiated super guarantee charge assessment in the 2 years up to the payday (uplift reduced by 20 points)","title":"No Ato Assessment In Prior 2 Years","type":"boolean"},"voluntary_disclosure_reduction_points":{"default":0,"description":"Percentage points the ATO cut from the uplift for a voluntary disclosure, 0 to 40","maximum":40,"minimum":0,"title":"Voluntary Disclosure Reduction Points","type":"integer"},"choice_loading_contribution_value":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Value of contributions where choice-of-fund rules were not followed, AUD (choice loading is 25% of it)","title":"Choice Loading Contribution Value"},"choice_notice_periods":{"default":1,"description":"Number of notice periods for the choice loading maximum of AUD 1,200 each","maximum":100,"minimum":1,"title":"Choice Notice Periods","type":"integer"},"previous_same_penalty_within_24_months":{"default":false,"description":"True if liable for the same late payment penalty in the previous 24 months (penalty 50% instead of 25%)","title":"Previous Same Penalty Within 24 Months","type":"boolean"},"public_holidays":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"ISO dates that are a public holiday for the whole of any Australian state or territory, used to find the last on-time day","title":"Public Holidays"}},"required":["unpaid_super_amount","qe_day","assessment_date"],"title":"estimate_sgc_exposureArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/payday_super_rules":{"post":{"operationId":"payday_super_rules","summary":"The Payday Super rules as published by the ATO with wording, effective dates, status and verification level. Use for \"Wh","description":"The Payday Super rules as published by the ATO with wording, effective dates, status and verification level. Use for \"What are the Payday Super rules and when did the small business clearing house close?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"default":"all","description":"all (default), deadlines, business_days, earnings_base, sgc, gic_rates or clearing_house","title":"Topic","type":"string"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date used to work out each rule's status, YYYY-MM-DD; defaults to today","title":"On Date"}},"title":"payday_super_rulesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}