Malaysia payroll API
One JSON API for statutory deductions and payroll calendars in Malaysia. PCB reproduces LHDN's 2026 worked examples to the sen.
Endpoints
Base URL on RapidAPI: https://malaysia-payroll-api.p.rapidapi.com/api/v1
| Method | Path | Returns |
|---|---|---|
| POST | /payslip | Full payslip: EPF, SOCSO, EIS, PCB, net pay and employer cost |
| GET | /epf?wage=3250&age=30&category=citizen | EPF employee and employer contribution (Third Schedule bands) |
| GET | /socso?wage=3000&age=30&lindung24=true | SOCSO contribution incl. LINDUNG 24 Jam |
| GET | /eis?wage=3000 | EIS contribution |
| POST | /pcb | PCB / MTD with year-to-date figures, bonus, reliefs and zakat (LHDN computerised method) |
| GET | /overtime?monthly=2600&normal_ot_hours=10 | Employment Act overtime and rest-day / public-holiday pay |
| GET | /prorate?monthly=3100&days_in_month=31&unpaid_days=3 | Pro-rated pay for part months and unpaid leave |
| GET | /holidays?year=2027&state=selangor | Federal, state and replacement holidays |
| GET | /working-days?state=10&from=2027-03-01&to=2027-03-31 | Working days between two dates |
| GET | /tables/socso | Full SOCSO table |
| GET | /tables/eis | Full EIS table |
| GET | /tables/pcb | PCB Table 1 and reliefs |
| GET | /meta | Rules version and sources |
Example: POST /payslip
{
"basic": 5000,
"allowances": 300,
"bonus": 2000,
"age": 30,
"epf_category": "citizen",
"marital": "single"
}
Response (shortened):
{
"ok": true,
"data": {
"gross_pay": 7300,
"deductions": {
"epf": 803,
"socso": 65.6,
"eis": 10.5,
"pcb": 350.5,
"zakat": 0
},
"net_pay": 6070.4,
"employer": {
"epf": 876,
"socso": 91.85,
"eis": 10.5
},
"cost_to_employer": 8278.35
}
}
Inputs
basic,allowances(fixed, taxable),overtime,commission,bonus,exempt_allowances,unpaid_leaveage,epf_category:citizen,pr,foreign,exempt;epf_employee_rateto override 11%;lindung24(default true);socso_categorymarital(single / married / divorced / widowed),spouse_workingorcategory1–3;children: {under18, study18, higher, disabled, disabled_higher};disabled_self,disabled_spousetp1_deductions,claim_socso_relief,zakat,resident; for exact month-by-month PCB:monthandytd{gross, epf, pcb, zakat, deductions}
Overtime is excluded from EPF wages; bonus is excluded from SOCSO/EIS wages; overtime, commission and bonus are treated as additional remuneration for PCB.
Sources
- LHDN — Specification for MTD Calculations Using Computerized Calculation for 2026
- PERKESO — contribution tables for Act 4 (incl. SKBBK) and Act 800
- KWSP — Third Schedule contribution rates
- Public Holidays in Malaysia for Year 2027 (National and State), Cabinet, Constitution and Inter-Governmental Relations Division, Prime Minister's Department, via FMM circular GI/15/2026 dated 27 August 2026