{"openapi":"3.1.0","info":{"title":"HavaHR Public API","version":"1.0.0","summary":"Malaysian statutory payroll calculators as JSON endpoints.","description":"Free, unauthenticated JSON API for Malaysian statutory payroll maths: EPF (KWSP), SOCSO (PERKESO), EIS (SIP), SKBBK (Lindung 24 Jam), PCB (MTD), employer cost, Employment Act 1955 overtime, annual leave proration, Employment Act coverage, and the HRD Corp (HRDF) levy.\n\n**When to use this API:** reach for it whenever a task needs Malaysian payroll or HR statutory numbers — quoting net pay, budgeting a hire, checking a payslip deduction, or validating a leave entitlement. It runs the same engine as the HavaHR product and the `@havahr/mcp-calculators` MCP server, so all three agree to the sen.\n\n**When not to use it:** it does not read or write customer payroll data, and it is not official advice. Confirm filings with KWSP, PERKESO, or LHDN.\n\nNo API key, no rate-limit registration. All monetary values are Malaysian Ringgit (MYR).","contact":{"name":"HavaHR","url":"https://www.havahr.com","email":"info@havahr.com"},"license":{"name":"CC BY 4.0","identifier":"CC-BY-4.0"},"termsOfService":"https://www.havahr.com/terms"},"servers":[{"url":"https://www.havahr.com","description":"Production"}],"externalDocs":{"description":"HavaHR developer documentation","url":"https://www.havahr.com/developers"},"tags":[{"name":"Calculators","description":"Malaysian statutory payroll and HR calculations. No authentication required."}],"paths":{"/api/v1/calculators":{"get":{"operationId":"list_calculators","summary":"List every calculator","description":"Return all Malaysian statutory calculators with their names, when-to-use guidance, endpoints, and input schemas. An agent can call this once and generate function-calling tool definitions for the whole API.","tags":["Calculators"],"responses":{"200":{"description":"Calculator catalog.","content":{"application/json":{"schema":{"type":"object","required":["version","calculators"],"properties":{"version":{"type":"string","description":"Public API version."},"documentation":{"type":"string","format":"uri"},"openapi":{"type":"string","format":"uri"},"calculators":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}}}}},"/api/v1/calculators/malaysia-payroll":{"get":{"operationId":"describe_calculate_malaysia_payroll","summary":"Describe the Malaysia payroll (full statutory) calculator","description":"Return the JSON Schema, defaults, and a worked example for `calculate_malaysia_payroll` without running it. Use this to build a function-calling tool definition at runtime. When to use the calculator itself: A user asks what a Malaysian salary nets after statutory deductions, or wants a payslip breakdown.","tags":["Calculators"],"responses":{"200":{"description":"Calculator descriptor.","content":{"application/json":{"schema":{"type":"object","required":["name","title","description","whenToUse","endpoint","inputSchema"],"properties":{"name":{"type":"string","const":"calculate_malaysia_payroll"},"title":{"type":"string"},"description":{"type":"string"},"whenToUse":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"inputSchema":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"calculate_malaysia_payroll","summary":"Malaysia payroll (full statutory)","description":"Calculate Malaysian net pay with EPF, SOCSO, EIS, SKBBK (Lindung 24 Jam), and PCB deductions plus employer contributions. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.\n\n**When to use:** A user asks what a Malaysian salary nets after statutory deductions, or wants a payslip breakdown.","tags":["Calculators"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/calculate_malaysia_payroll_request"}}}},"responses":{"200":{"description":"Malaysia payroll (full statutory) result.","content":{"application/json":{"schema":{"type":"object","description":"Result envelope for `calculate_malaysia_payroll`.","required":["tool","currency","result"],"properties":{"tool":{"type":"string","const":"calculate_malaysia_payroll","description":"Echoes the calculator that produced the result."},"currency":{"type":"string","const":"MYR","description":"All monetary values in `result` are Malaysian Ringgit."},"disclaimer":{"type":"string","description":"Estimate disclaimer that must be surfaced alongside the numbers."},"result":{"type":"object","additionalProperties":true,"description":"Calculator output. See https://www.havahr.com/developers for a worked example per calculator."}}}}}},"400":{"description":"Request body was not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request `Content-Type` was not `application/json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request body failed schema validation. See `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calculators/epf":{"get":{"operationId":"describe_calculate_epf","summary":"Describe the EPF (KWSP) calculator","description":"Return the JSON Schema, defaults, and a worked example for `calculate_epf` without running it. Use this to build a function-calling tool definition at runtime. When to use the calculator itself: Only the EPF/KWSP employee and employer contribution is needed.","tags":["Calculators"],"responses":{"200":{"description":"Calculator descriptor.","content":{"application/json":{"schema":{"type":"object","required":["name","title","description","whenToUse","endpoint","inputSchema"],"properties":{"name":{"type":"string","const":"calculate_epf"},"title":{"type":"string"},"description":{"type":"string"},"whenToUse":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"inputSchema":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"calculate_epf","summary":"EPF (KWSP)","description":"Calculate Malaysian EPF (KWSP) employee and employer contributions from official Third Schedule rates. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.\n\n**When to use:** Only the EPF/KWSP employee and employer contribution is needed.","tags":["Calculators"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/calculate_epf_request"}}}},"responses":{"200":{"description":"EPF (KWSP) result.","content":{"application/json":{"schema":{"type":"object","description":"Result envelope for `calculate_epf`.","required":["tool","currency","result"],"properties":{"tool":{"type":"string","const":"calculate_epf","description":"Echoes the calculator that produced the result."},"currency":{"type":"string","const":"MYR","description":"All monetary values in `result` are Malaysian Ringgit."},"disclaimer":{"type":"string","description":"Estimate disclaimer that must be surfaced alongside the numbers."},"result":{"type":"object","additionalProperties":true,"description":"Calculator output. See https://www.havahr.com/developers for a worked example per calculator."}}}}}},"400":{"description":"Request body was not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request `Content-Type` was not `application/json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request body failed schema validation. See `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calculators/socso":{"get":{"operationId":"describe_calculate_socso","summary":"Describe the SOCSO (PERKESO) calculator","description":"Return the JSON Schema, defaults, and a worked example for `calculate_socso` without running it. Use this to build a function-calling tool definition at runtime. When to use the calculator itself: Only the SOCSO/PERKESO contribution is needed, including the age 60+ Category 2 split.","tags":["Calculators"],"responses":{"200":{"description":"Calculator descriptor.","content":{"application/json":{"schema":{"type":"object","required":["name","title","description","whenToUse","endpoint","inputSchema"],"properties":{"name":{"type":"string","const":"calculate_socso"},"title":{"type":"string"},"description":{"type":"string"},"whenToUse":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"inputSchema":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"calculate_socso","summary":"SOCSO (PERKESO)","description":"Calculate Malaysian SOCSO (PERKESO) contributions (Category 1 under 60, Category 2 for 60+). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.\n\n**When to use:** Only the SOCSO/PERKESO contribution is needed, including the age 60+ Category 2 split.","tags":["Calculators"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/calculate_socso_request"}}}},"responses":{"200":{"description":"SOCSO (PERKESO) result.","content":{"application/json":{"schema":{"type":"object","description":"Result envelope for `calculate_socso`.","required":["tool","currency","result"],"properties":{"tool":{"type":"string","const":"calculate_socso","description":"Echoes the calculator that produced the result."},"currency":{"type":"string","const":"MYR","description":"All monetary values in `result` are Malaysian Ringgit."},"disclaimer":{"type":"string","description":"Estimate disclaimer that must be surfaced alongside the numbers."},"result":{"type":"object","additionalProperties":true,"description":"Calculator output. See https://www.havahr.com/developers for a worked example per calculator."}}}}}},"400":{"description":"Request body was not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request `Content-Type` was not `application/json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request body failed schema validation. See `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calculators/eis":{"get":{"operationId":"describe_calculate_eis","summary":"Describe the EIS (SIP) calculator","description":"Return the JSON Schema, defaults, and a worked example for `calculate_eis` without running it. Use this to build a function-calling tool definition at runtime. When to use the calculator itself: Only the EIS/SIP contribution is needed, including eligibility by citizenship and age.","tags":["Calculators"],"responses":{"200":{"description":"Calculator descriptor.","content":{"application/json":{"schema":{"type":"object","required":["name","title","description","whenToUse","endpoint","inputSchema"],"properties":{"name":{"type":"string","const":"calculate_eis"},"title":{"type":"string"},"description":{"type":"string"},"whenToUse":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"inputSchema":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"calculate_eis","summary":"EIS (SIP)","description":"Calculate Malaysian EIS (SIP) contributions with eligibility (citizen or PR, age 18–60). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.\n\n**When to use:** Only the EIS/SIP contribution is needed, including eligibility by citizenship and age.","tags":["Calculators"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/calculate_eis_request"}}}},"responses":{"200":{"description":"EIS (SIP) result.","content":{"application/json":{"schema":{"type":"object","description":"Result envelope for `calculate_eis`.","required":["tool","currency","result"],"properties":{"tool":{"type":"string","const":"calculate_eis","description":"Echoes the calculator that produced the result."},"currency":{"type":"string","const":"MYR","description":"All monetary values in `result` are Malaysian Ringgit."},"disclaimer":{"type":"string","description":"Estimate disclaimer that must be surfaced alongside the numbers."},"result":{"type":"object","additionalProperties":true,"description":"Calculator output. See https://www.havahr.com/developers for a worked example per calculator."}}}}}},"400":{"description":"Request body was not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request `Content-Type` was not `application/json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request body failed schema validation. See `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calculators/skbbk":{"get":{"operationId":"describe_calculate_skbbk","summary":"Describe the SKBBK (Lindung 24 Jam) calculator","description":"Return the JSON Schema, defaults, and a worked example for `calculate_skbbk` without running it. Use this to build a function-calling tool definition at runtime. When to use the calculator itself: Checking the Lindung 24 Jam (SKBBK) employee deduction for a specific wage month, including opt-out handling.","tags":["Calculators"],"responses":{"200":{"description":"Calculator descriptor.","content":{"application/json":{"schema":{"type":"object","required":["name","title","description","whenToUse","endpoint","inputSchema"],"properties":{"name":{"type":"string","const":"calculate_skbbk"},"title":{"type":"string"},"description":{"type":"string"},"whenToUse":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"inputSchema":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"calculate_skbbk","summary":"SKBBK (Lindung 24 Jam)","description":"Calculate Malaysian SKBBK (Lindung 24 Jam / non-employment injury) employee contribution from the official PERKESO table (≈0.75% schedule, RM6,000 wage ceiling), with effective-date and opt-out eligibility. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.\n\n**When to use:** Checking the Lindung 24 Jam (SKBBK) employee deduction for a specific wage month, including opt-out handling.","tags":["Calculators"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/calculate_skbbk_request"}}}},"responses":{"200":{"description":"SKBBK (Lindung 24 Jam) result.","content":{"application/json":{"schema":{"type":"object","description":"Result envelope for `calculate_skbbk`.","required":["tool","currency","result"],"properties":{"tool":{"type":"string","const":"calculate_skbbk","description":"Echoes the calculator that produced the result."},"currency":{"type":"string","const":"MYR","description":"All monetary values in `result` are Malaysian Ringgit."},"disclaimer":{"type":"string","description":"Estimate disclaimer that must be surfaced alongside the numbers."},"result":{"type":"object","additionalProperties":true,"description":"Calculator output. See https://www.havahr.com/developers for a worked example per calculator."}}}}}},"400":{"description":"Request body was not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request `Content-Type` was not `application/json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request body failed schema validation. See `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calculators/pcb":{"get":{"operationId":"describe_calculate_pcb","summary":"Describe the PCB (MTD) calculator","description":"Return the JSON Schema, defaults, and a worked example for `calculate_pcb` without running it. Use this to build a function-calling tool definition at runtime. When to use the calculator itself: Estimating monthly income tax withholding (PCB/MTD) for a salary and tax category.","tags":["Calculators"],"responses":{"200":{"description":"Calculator descriptor.","content":{"application/json":{"schema":{"type":"object","required":["name","title","description","whenToUse","endpoint","inputSchema"],"properties":{"name":{"type":"string","const":"calculate_pcb"},"title":{"type":"string"},"description":{"type":"string"},"whenToUse":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"inputSchema":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"calculate_pcb","summary":"PCB (MTD)","description":"Estimate Malaysian PCB / monthly tax deduction (MTD) from salary and tax category inputs. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.\n\n**When to use:** Estimating monthly income tax withholding (PCB/MTD) for a salary and tax category.","tags":["Calculators"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/calculate_pcb_request"}}}},"responses":{"200":{"description":"PCB (MTD) result.","content":{"application/json":{"schema":{"type":"object","description":"Result envelope for `calculate_pcb`.","required":["tool","currency","result"],"properties":{"tool":{"type":"string","const":"calculate_pcb","description":"Echoes the calculator that produced the result."},"currency":{"type":"string","const":"MYR","description":"All monetary values in `result` are Malaysian Ringgit."},"disclaimer":{"type":"string","description":"Estimate disclaimer that must be surfaced alongside the numbers."},"result":{"type":"object","additionalProperties":true,"description":"Calculator output. See https://www.havahr.com/developers for a worked example per calculator."}}}}}},"400":{"description":"Request body was not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request `Content-Type` was not `application/json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request body failed schema validation. See `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calculators/employer-cost":{"get":{"operationId":"describe_calculate_employer_cost","summary":"Describe the Employer hiring cost calculator","description":"Return the JSON Schema, defaults, and a worked example for `calculate_employer_cost` without running it. Use this to build a function-calling tool definition at runtime. When to use the calculator itself: A user asks what an employee really costs the employer, or is budgeting a new hire.","tags":["Calculators"],"responses":{"200":{"description":"Calculator descriptor.","content":{"application/json":{"schema":{"type":"object","required":["name","title","description","whenToUse","endpoint","inputSchema"],"properties":{"name":{"type":"string","const":"calculate_employer_cost"},"title":{"type":"string"},"description":{"type":"string"},"whenToUse":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"inputSchema":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"calculate_employer_cost","summary":"Employer hiring cost","description":"Calculate total employer outlay for a Malaysian salary: gross plus statutory employer contributions (SKBBK is employee-only). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.\n\n**When to use:** A user asks what an employee really costs the employer, or is budgeting a new hire.","tags":["Calculators"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/calculate_employer_cost_request"}}}},"responses":{"200":{"description":"Employer hiring cost result.","content":{"application/json":{"schema":{"type":"object","description":"Result envelope for `calculate_employer_cost`.","required":["tool","currency","result"],"properties":{"tool":{"type":"string","const":"calculate_employer_cost","description":"Echoes the calculator that produced the result."},"currency":{"type":"string","const":"MYR","description":"All monetary values in `result` are Malaysian Ringgit."},"disclaimer":{"type":"string","description":"Estimate disclaimer that must be surfaced alongside the numbers."},"result":{"type":"object","additionalProperties":true,"description":"Calculator output. See https://www.havahr.com/developers for a worked example per calculator."}}}}}},"400":{"description":"Request body was not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request `Content-Type` was not `application/json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request body failed schema validation. See `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calculators/overtime":{"get":{"operationId":"describe_calculate_overtime","summary":"Describe the Overtime & public holiday pay calculator","description":"Return the JSON Schema, defaults, and a worked example for `calculate_overtime` without running it. Use this to build a function-calling tool definition at runtime. When to use the calculator itself: Working out Employment Act 1955 overtime, rest-day, or public-holiday pay, and the 45h/104h compliance limits.","tags":["Calculators"],"responses":{"200":{"description":"Calculator descriptor.","content":{"application/json":{"schema":{"type":"object","required":["name","title","description","whenToUse","endpoint","inputSchema"],"properties":{"name":{"type":"string","const":"calculate_overtime"},"title":{"type":"string"},"description":{"type":"string"},"whenToUse":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"inputSchema":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"calculate_overtime","summary":"Overtime & public holiday pay","description":"Calculate Malaysian overtime pay under the Employment Act 1955: normal day 1.5x, rest day 2x/3x, public holiday 2x daily rate plus 3x hourly OT, with 45-hour week and 104-hour monthly OT compliance checks. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.\n\n**When to use:** Working out Employment Act 1955 overtime, rest-day, or public-holiday pay, and the 45h/104h compliance limits.","tags":["Calculators"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/calculate_overtime_request"}}}},"responses":{"200":{"description":"Overtime & public holiday pay result.","content":{"application/json":{"schema":{"type":"object","description":"Result envelope for `calculate_overtime`.","required":["tool","currency","result"],"properties":{"tool":{"type":"string","const":"calculate_overtime","description":"Echoes the calculator that produced the result."},"currency":{"type":"string","const":"MYR","description":"All monetary values in `result` are Malaysian Ringgit."},"disclaimer":{"type":"string","description":"Estimate disclaimer that must be surfaced alongside the numbers."},"result":{"type":"object","additionalProperties":true,"description":"Calculator output. See https://www.havahr.com/developers for a worked example per calculator."}}}}}},"400":{"description":"Request body was not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request `Content-Type` was not `application/json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request body failed schema validation. See `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calculators/leave-proration":{"get":{"operationId":"describe_calculate_leave_proration","summary":"Describe the Annual leave proration calculator","description":"Return the JSON Schema, defaults, and a worked example for `calculate_leave_proration` without running it. Use this to build a function-calling tool definition at runtime. When to use the calculator itself: Prorating annual leave for a mid-year joiner or leaver, or for an unpaid-leave adjustment.","tags":["Calculators"],"responses":{"200":{"description":"Calculator descriptor.","content":{"application/json":{"schema":{"type":"object","required":["name","title","description","whenToUse","endpoint","inputSchema"],"properties":{"name":{"type":"string","const":"calculate_leave_proration"},"title":{"type":"string"},"description":{"type":"string"},"whenToUse":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"inputSchema":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"calculate_leave_proration","summary":"Annual leave proration","description":"Prorate Malaysian annual leave entitlement for mid-year joiners or leavers by calendar or service year, with optional unpaid-leave adjustment. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.\n\n**When to use:** Prorating annual leave for a mid-year joiner or leaver, or for an unpaid-leave adjustment.","tags":["Calculators"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/calculate_leave_proration_request"}}}},"responses":{"200":{"description":"Annual leave proration result.","content":{"application/json":{"schema":{"type":"object","description":"Result envelope for `calculate_leave_proration`.","required":["tool","currency","result"],"properties":{"tool":{"type":"string","const":"calculate_leave_proration","description":"Echoes the calculator that produced the result."},"currency":{"type":"string","const":"MYR","description":"All monetary values in `result` are Malaysian Ringgit."},"disclaimer":{"type":"string","description":"Estimate disclaimer that must be surfaced alongside the numbers."},"result":{"type":"object","additionalProperties":true,"description":"Calculator output. See https://www.havahr.com/developers for a worked example per calculator."}}}}}},"400":{"description":"Request body was not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request `Content-Type` was not `application/json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request body failed schema validation. See `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calculators/employment-act-coverage":{"get":{"operationId":"describe_check_employment_act_coverage","summary":"Describe the Employment Act coverage check calculator","description":"Return the JSON Schema, defaults, and a worked example for `check_employment_act_coverage` without running it. Use this to build a function-calling tool definition at runtime. When to use the calculator itself: Deciding whether Employment Act 1955 entitlements apply to a given employee.","tags":["Calculators"],"responses":{"200":{"description":"Calculator descriptor.","content":{"application/json":{"schema":{"type":"object","required":["name","title","description","whenToUse","endpoint","inputSchema"],"properties":{"name":{"type":"string","const":"check_employment_act_coverage"},"title":{"type":"string"},"description":{"type":"string"},"whenToUse":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"inputSchema":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"check_employment_act_coverage","summary":"Employment Act coverage check","description":"Check whether an employee is covered by the Malaysian Employment Act 1955 (RM4,000 threshold, manual labor, domestic work) with rationale and references. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.\n\n**When to use:** Deciding whether Employment Act 1955 entitlements apply to a given employee.","tags":["Calculators"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/check_employment_act_coverage_request"}}}},"responses":{"200":{"description":"Employment Act coverage check result.","content":{"application/json":{"schema":{"type":"object","description":"Result envelope for `check_employment_act_coverage`.","required":["tool","currency","result"],"properties":{"tool":{"type":"string","const":"check_employment_act_coverage","description":"Echoes the calculator that produced the result."},"currency":{"type":"string","const":"MYR","description":"All monetary values in `result` are Malaysian Ringgit."},"disclaimer":{"type":"string","description":"Estimate disclaimer that must be surfaced alongside the numbers."},"result":{"type":"object","additionalProperties":true,"description":"Calculator output. See https://www.havahr.com/developers for a worked example per calculator."}}}}}},"400":{"description":"Request body was not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request `Content-Type` was not `application/json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request body failed schema validation. See `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calculators/hrd-corp-levy":{"get":{"operationId":"describe_calculate_hrd_corp_levy","summary":"Describe the HRD Corp (HRDF) levy calculator","description":"Return the JSON Schema, defaults, and a worked example for `calculate_hrd_corp_levy` without running it. Use this to build a function-calling tool definition at runtime. When to use the calculator itself: Working out the HRD Corp (HRDF) levy and the training budget it funds.","tags":["Calculators"],"responses":{"200":{"description":"Calculator descriptor.","content":{"application/json":{"schema":{"type":"object","required":["name","title","description","whenToUse","endpoint","inputSchema"],"properties":{"name":{"type":"string","const":"calculate_hrd_corp_levy"},"title":{"type":"string"},"description":{"type":"string"},"whenToUse":{"type":"string"},"endpoint":{"type":"string","format":"uri"},"inputSchema":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"calculate_hrd_corp_levy","summary":"HRD Corp (HRDF) levy","description":"Calculate the Malaysian HRD Corp (HRDF) levy: mandatory 1% for 10+ Malaysian employees, voluntary 0.5% for 5-9, with monthly/annual levy and training budget. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.\n\n**When to use:** Working out the HRD Corp (HRDF) levy and the training budget it funds.","tags":["Calculators"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/calculate_hrd_corp_levy_request"}}}},"responses":{"200":{"description":"HRD Corp (HRDF) levy result.","content":{"application/json":{"schema":{"type":"object","description":"Result envelope for `calculate_hrd_corp_levy`.","required":["tool","currency","result"],"properties":{"tool":{"type":"string","const":"calculate_hrd_corp_levy","description":"Echoes the calculator that produced the result."},"currency":{"type":"string","const":"MYR","description":"All monetary values in `result` are Malaysian Ringgit."},"disclaimer":{"type":"string","description":"Estimate disclaimer that must be surfaced alongside the numbers."},"result":{"type":"object","additionalProperties":true,"description":"Calculator output. See https://www.havahr.com/developers for a worked example per calculator."}}}}}},"400":{"description":"Request body was not valid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown calculator.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Request `Content-Type` was not `application/json`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Request body failed schema validation. See `error.details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","hint","docs"],"properties":{"code":{"type":"string","enum":["not_found","method_not_allowed","unsupported_media_type","invalid_json","invalid_request","not_acceptable","internal_error"],"description":"Stable machine-readable error code."},"message":{"type":"string","description":"Human-readable summary of what went wrong."},"hint":{"type":"string","description":"Concrete next step to resolve the error."},"docs":{"type":"string","format":"uri","description":"Documentation for this error."},"details":{"type":"array","description":"Per-field validation failures. Present on `invalid_request`.","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string","description":"Dotted path to the offending field."},"message":{"type":"string"}}}}}}}},"calculate_malaysia_payroll_request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross salary in RM"},"epfGrossSalary":{"description":"Optional EPF wage base in RM (e.g. include bonus). Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"socsoGrossSalary":{"description":"Optional SOCSO wage base in RM. Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"eisGrossSalary":{"description":"Optional EIS wage base in RM. Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"skbbkGrossSalary":{"description":"Optional SKBBK (Lindung 24 Jam) wage base in RM. Defaults to socsoGrossSalary then grossSalary.","type":"number","exclusiveMinimum":0},"employeeAge":{"description":"Employee age in years. Default 30.","type":"integer","minimum":0,"maximum":120},"isMalaysian":{"description":"Malaysian citizen. Default true.","type":"boolean"},"isPermanentResident":{"description":"Malaysia PR. Default false.","type":"boolean"},"isNonMalaysianMemberBefore1998":{"description":"Non-Malaysian EPF member before Aug 1998. Default false.","type":"boolean"},"epfEmployeeRate":{"description":"Optional EPF employee rate override as percentage (e.g. 11).","type":"number","minimum":0,"maximum":100},"maritalStatus":{"description":"For PCB. Default single.","type":"string","enum":["single","married"]},"spouseWorking":{"description":"Spouse working (PCB). Default true.","type":"boolean"},"numberOfChildren":{"description":"Children for PCB relief. Default 0.","type":"integer","minimum":0,"maximum":9007199254740991},"daysInMalaysia":{"description":"Days in Malaysia for tax residency. Default 365.","type":"integer","minimum":0,"maximum":366},"omitPcb":{"description":"When true, PCB is zeroed and excluded from aggregates.","type":"boolean"},"payrollYear":{"description":"Payroll period year for SKBBK effective-date gating. Defaults to current UTC year.","type":"integer","minimum":2000,"maximum":2100},"payrollMonth":{"description":"Payroll period month (1–12) for SKBBK. Defaults to current UTC month.","type":"integer","minimum":1,"maximum":12},"socsoActive":{"description":"SOCSO coverage. When false, SKBBK is RM0. Default true.","type":"boolean"},"skbbkOptOutEffectiveYearMonth":{"description":"Local/PR Lindung24 opt-out effective wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]},"skbbkOptOutResumedYearMonth":{"description":"Local/PR Lindung24 resume wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]}},"required":["grossSalary"],"title":"Malaysia payroll (full statutory)","description":"Calculate Malaysian net pay with EPF, SOCSO, EIS, SKBBK (Lindung 24 Jam), and PCB deductions plus employer contributions. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing."},"calculate_epf_request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross wage for EPF in RM"},"employeeAge":{"description":"Employee age. Default 30.","type":"integer","minimum":0,"maximum":120},"employeeRate":{"description":"Optional employee contribution rate override as percentage (e.g. 11).","type":"number","minimum":0,"maximum":100}},"required":["grossSalary"],"title":"EPF (KWSP)","description":"Calculate Malaysian EPF (KWSP) employee and employer contributions from official Third Schedule rates. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing."},"calculate_socso_request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross wage for SOCSO in RM"},"employeeAge":{"description":"Employee age. Under 60 = Category 1; 60+ = Category 2. Default 30.","type":"integer","minimum":0,"maximum":120}},"required":["grossSalary"],"title":"SOCSO (PERKESO)","description":"Calculate Malaysian SOCSO (PERKESO) contributions (Category 1 under 60, Category 2 for 60+). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing."},"calculate_eis_request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross wage for EIS in RM"},"employeeAge":{"description":"Employee age. Default under 60.","type":"integer","minimum":0,"maximum":120},"isMalaysian":{"description":"Malaysian citizen. Default true.","type":"boolean"},"isPermanentResident":{"description":"Malaysia PR. When true, treated as EIS-eligible (same as citizen). Default false.","type":"boolean"}},"required":["grossSalary"],"title":"EIS (SIP)","description":"Calculate Malaysian EIS (SIP) contributions with eligibility (citizen or PR, age 18–60). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing."},"calculate_skbbk_request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"wage":{"type":"number","minimum":0,"description":"Monthly SKBBK wage base in RM (basic + SKBBK-applicable earnings). Ceiling RM6,000."},"payrollYear":{"type":"integer","minimum":2000,"maximum":2100,"description":"Payroll period year"},"payrollMonth":{"type":"integer","minimum":1,"maximum":12,"description":"Payroll period month (1–12)"},"socsoActive":{"description":"SOCSO coverage. When false, contribution is RM0. Default true.","type":"boolean"},"isMalaysian":{"description":"Malaysian citizen. Default true.","type":"boolean"},"isPermanentResident":{"description":"Malaysia PR. Default false.","type":"boolean"},"skbbkOptOutEffectiveYearMonth":{"description":"Local/PR opt-out effective wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]},"skbbkOptOutResumedYearMonth":{"description":"Local/PR resume wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]}},"required":["wage","payrollYear","payrollMonth"],"title":"SKBBK (Lindung 24 Jam)","description":"Calculate Malaysian SKBBK (Lindung 24 Jam / non-employment injury) employee contribution from the official PERKESO table (≈0.75% schedule, RM6,000 wage ceiling), with effective-date and opt-out eligibility. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing."},"calculate_pcb_request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross salary in RM"},"epfContribution":{"description":"Optional monthly EPF employee contribution in RM (used to infer EPF rate).","type":"number","minimum":0},"maritalStatus":{"description":"Default single.","type":"string","enum":["single","married"]},"spouseWorking":{"description":"Default true.","type":"boolean"},"numberOfChildren":{"description":"Default 0.","type":"integer","minimum":0,"maximum":9007199254740991},"isResident":{"description":"Tax resident. Default true.","type":"boolean"}},"required":["grossSalary"],"title":"PCB (MTD)","description":"Estimate Malaysian PCB / monthly tax deduction (MTD) from salary and tax category inputs. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing."},"calculate_employer_cost_request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly gross salary in RM"},"epfGrossSalary":{"description":"Optional EPF wage base in RM (e.g. include bonus). Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"socsoGrossSalary":{"description":"Optional SOCSO wage base in RM. Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"eisGrossSalary":{"description":"Optional EIS wage base in RM. Defaults to grossSalary.","type":"number","exclusiveMinimum":0},"skbbkGrossSalary":{"description":"Optional SKBBK (Lindung 24 Jam) wage base in RM. Defaults to socsoGrossSalary then grossSalary.","type":"number","exclusiveMinimum":0},"employeeAge":{"description":"Employee age in years. Default 30.","type":"integer","minimum":0,"maximum":120},"isMalaysian":{"description":"Malaysian citizen. Default true.","type":"boolean"},"isPermanentResident":{"description":"Malaysia PR. Default false.","type":"boolean"},"isNonMalaysianMemberBefore1998":{"description":"Non-Malaysian EPF member before Aug 1998. Default false.","type":"boolean"},"epfEmployeeRate":{"description":"Optional EPF employee rate override as percentage (e.g. 11).","type":"number","minimum":0,"maximum":100},"maritalStatus":{"description":"For PCB. Default single.","type":"string","enum":["single","married"]},"spouseWorking":{"description":"Spouse working (PCB). Default true.","type":"boolean"},"numberOfChildren":{"description":"Children for PCB relief. Default 0.","type":"integer","minimum":0,"maximum":9007199254740991},"daysInMalaysia":{"description":"Days in Malaysia for tax residency. Default 365.","type":"integer","minimum":0,"maximum":366},"omitPcb":{"description":"When true, PCB is zeroed and excluded from aggregates.","type":"boolean"},"payrollYear":{"description":"Payroll period year for SKBBK effective-date gating. Defaults to current UTC year.","type":"integer","minimum":2000,"maximum":2100},"payrollMonth":{"description":"Payroll period month (1–12) for SKBBK. Defaults to current UTC month.","type":"integer","minimum":1,"maximum":12},"socsoActive":{"description":"SOCSO coverage. When false, SKBBK is RM0. Default true.","type":"boolean"},"skbbkOptOutEffectiveYearMonth":{"description":"Local/PR Lindung24 opt-out effective wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]},"skbbkOptOutResumedYearMonth":{"description":"Local/PR Lindung24 resume wage month (YYYY-MM). Ignored for foreign workers.","anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}$"},{"type":"null"}]}},"required":["grossSalary"],"title":"Employer hiring cost","description":"Calculate total employer outlay for a Malaysian salary: gross plus statutory employer contributions (SKBBK is employee-only). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing."},"calculate_overtime_request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlySalary":{"type":"number","exclusiveMinimum":0,"description":"Monthly basic salary in RM (ordinary rate = salary / 26)"},"normalHoursPerDay":{"description":"Normal working hours per day. Default 8.","type":"number","exclusiveMinimum":0,"maximum":24},"normalDayOtHours":{"description":"OT hours on normal working days this month (paid 1.5x hourly). Default 0.","type":"number","minimum":0},"restDayOtHoursFirst8":{"description":"Hours worked on rest days within normal shift length (paid 2x hourly). Default 0.","type":"number","minimum":0},"restDayOtHoursBeyond8":{"description":"Rest-day hours beyond normal shift length (paid 3x hourly). Default 0.","type":"number","minimum":0},"publicHolidayWorkedDays":{"description":"Public holidays worked at the usual shift length (paid 2x daily rate per day). Default 0.","type":"number","minimum":0},"publicHolidayOtHours":{"description":"Extra hours beyond the usual shift on public holidays (paid 3x hourly). Default 0.","type":"number","minimum":0},"weeklyHours":{"description":"Normal weekly working hours, for the 45-hour compliance check. Default 45.","type":"number","minimum":0},"monthlyOtHours":{"description":"Total OT hours this month, for the 104-hour compliance check. Defaults to the sum of OT hours above.","type":"number","minimum":0}},"required":["monthlySalary"],"title":"Overtime & public holiday pay","description":"Calculate Malaysian overtime pay under the Employment Act 1955: normal day 1.5x, rest day 2x/3x, public holiday 2x daily rate plus 3x hourly OT, with 45-hour week and 104-hour monthly OT compliance checks. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing."},"calculate_leave_proration_request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"joinDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Employee join date (YYYY-MM-DD)"},"annualEntitlement":{"type":"number","minimum":0,"description":"Full-year annual leave entitlement in days"},"usedLeave":{"description":"Annual leave days already taken. Default 0.","type":"number","minimum":0},"cutoffDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Proration cutoff date, e.g. year end or termination date (YYYY-MM-DD)"},"basis":{"description":"Proration basis: calendar year or service year. Default calendar.","type":"string","enum":["calendar","service"]},"unpaidLeaveDays":{"description":"Unpaid leave days to reduce entitlement (1 month unpaid reduces ~1/12). Default 0.","type":"number","minimum":0},"useDayProration":{"description":"Use day-level proration instead of month-level (calendar basis only). Default false.","type":"boolean"}},"required":["joinDate","annualEntitlement","cutoffDate"],"title":"Annual leave proration","description":"Prorate Malaysian annual leave entitlement for mid-year joiners or leavers by calendar or service year, with optional unpaid-leave adjustment. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing."},"check_employment_act_coverage_request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlySalary":{"type":"number","minimum":0,"description":"Monthly wages in RM (RM4,000 threshold applies to key entitlements)"},"isManualLabor":{"description":"Employee mainly performs manual labor. Default false.","type":"boolean"},"isDomesticServant":{"description":"Employee is a domestic servant/worker. Default false.","type":"boolean"},"hasSpecialExclusion":{"description":"Special exclusions apply (e.g. seafarers, statutory bodies). Default false.","type":"boolean"}},"required":["monthlySalary"],"title":"Employment Act coverage check","description":"Check whether an employee is covered by the Malaysian Employment Act 1955 (RM4,000 threshold, manual labor, domestic work) with rationale and references. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing."},"calculate_hrd_corp_levy_request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"totalWages":{"type":"number","minimum":0,"description":"Total eligible monthly wages in RM (basic + fixed allowances + commissions; excludes OT, bonus, reimbursements)"},"employeeCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of Malaysian employees (foreign workers do not count toward the threshold)"},"isVoluntary":{"description":"Employer with 5-9 employees opting into voluntary registration at 0.5%. Default false.","type":"boolean"}},"required":["totalWages","employeeCount"],"title":"HRD Corp (HRDF) levy","description":"Calculate the Malaysian HRD Corp (HRDF) levy: mandatory 1% for 10+ Malaysian employees, voluntary 0.5% for 5-9, with monthly/annual levy and training budget. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing."}}}}