{"openapi":"3.1.0","info":{"title":"New Zealand Minimum Wage API","version":"0.1.0","description":"New Zealand Minimum Wage gives an owner's agent the current minimum hourly rates with their effective date, and does the small sums around them. get_minimum_wage returns the adult, starting-out and training rates (NZD 23.95, 19.16 and 19.16 from 1 April 2026) with the eligibility conditions quoted from Employment New Zealand, without deciding who qualifies. check_pay_rate compares an hourly rate...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://nz-min-wage-pay.connectorbay.com/mcp.\n\nDisclaimer: General information only, not legal, tax, accounting or payment advice. New Zealand Minimum Wage 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/nz-min-wage-pay/docs"},"termsOfService":"https://connectorbay.com/nz-min-wage-pay/terms"},"servers":[{"url":"https://nz-min-wage-pay.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/nz-min-wage-pay/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/get_minimum_wage":{"post":{"operationId":"get_minimum_wage","summary":"Adult, starting-out and training minimum hourly wage in force on a date, with effective date and the eligibility conditi","description":"Adult, starting-out and training minimum hourly wage in force on a date, with effective date and the eligibility conditions quoted from Employment New Zealand. Use for \"What is the New Zealand minimum wage today, and who can be paid the starting-out rate?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"rate_type":{"default":"all","description":"adult, starting_out, training or all (default)","title":"Rate Type","type":"string"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date the rate should be in force, YYYY-MM-DD, on or after 2026-04-01; defaults to today","title":"On Date"}},"title":"get_minimum_wageArguments","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/check_pay_rate":{"post":{"operationId":"check_pay_rate","summary":"Compare an hourly pay rate with a minimum wage rate and show the shortfall or margin per hour. Use for \"We pay a 25 year","description":"Compare an hourly pay rate with a minimum wage rate and show the shortfall or margin per hour. Use for \"We pay a 25 year old 23.50 an hour: is that at or above the minimum wage?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"hourly_rate":{"description":"Hourly pay before tax, NZD decimal string","title":"Hourly Rate","type":"string"},"rate_type":{"default":"adult","description":"adult (default), starting_out or training: the tool compares, it does not decide which applies","title":"Rate Type","type":"string"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date to test, YYYY-MM-DD, on or after 2026-04-01; defaults to today","title":"On Date"}},"required":["hourly_rate"],"title":"check_pay_rateArguments","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/salary_to_hourly":{"post":{"operationId":"salary_to_hourly","summary":"Convert pay for a week, fortnight, month or year and the hours worked into an hourly equivalent and test it against the ","description":"Convert pay for a week, fortnight, month or year and the hours worked into an hourly equivalent and test it against the minimum. Use for \"A part-timer earns 46,000 a year for 40 hours a week: what is that per hour and is it above the minimum?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gross_pay":{"description":"Total pay including tax for the period, NZD decimal string","title":"Gross Pay","type":"string"},"period":{"description":"hour, week, fortnight, month or year","title":"Period","type":"string"},"hours_per_week":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Hours worked in a week, greater than 0 and at most 100 (ignored for period hour)","title":"Hours Per Week"},"rate_type":{"default":"adult","description":"adult (default), starting_out or training","title":"Rate Type","type":"string"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date to test, YYYY-MM-DD; defaults to today","title":"On Date"}},"required":["gross_pay","period"],"title":"salary_to_hourlyArguments","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/weekly_pay_at_minimum":{"post":{"operationId":"weekly_pay_at_minimum","summary":"Gross pay per day, week and fortnight at a minimum wage rate for the hours entered. Use for \"What is the weekly and fort","description":"Gross pay per day, week and fortnight at a minimum wage rate for the hours entered. Use for \"What is the weekly and fortnightly gross pay at the adult minimum wage for 30 hours a week?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"hours_per_week":{"description":"Hours worked in a week, greater than 0 and at most 100","title":"Hours Per Week","type":"string"},"rate_type":{"default":"adult","description":"adult (default), starting_out or training","title":"Rate Type","type":"string"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date whose rate is used, YYYY-MM-DD, on or after 2026-04-01; defaults to today","title":"On Date"}},"required":["hours_per_week"],"title":"weekly_pay_at_minimumArguments","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/next_review_reminder":{"post":{"operationId":"next_review_reminder","summary":"When the minimum wage was last changed, whether a change has been announced, and when the next annual review is expected","description":"When the minimum wage was last changed, whether a change has been announced, and when the next annual review is expected, for a scheduled reminder. Use for \"When will the New Zealand minimum wage next change, so I can put a reminder in the calendar?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date used to count the days, YYYY-MM-DD; defaults to today","title":"On Date"}},"title":"next_review_reminderArguments","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}}}}