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

MethodPathReturns
POST/payslipFull payslip: EPF, SOCSO, EIS, PCB, net pay and employer cost
GET/epf?wage=3250&age=30&category=citizenEPF employee and employer contribution (Third Schedule bands)
GET/socso?wage=3000&age=30&lindung24=trueSOCSO contribution incl. LINDUNG 24 Jam
GET/eis?wage=3000EIS contribution
POST/pcbPCB / MTD with year-to-date figures, bonus, reliefs and zakat (LHDN computerised method)
GET/overtime?monthly=2600&normal_ot_hours=10Employment Act overtime and rest-day / public-holiday pay
GET/prorate?monthly=3100&days_in_month=31&unpaid_days=3Pro-rated pay for part months and unpaid leave
GET/holidays?year=2027&state=selangorFederal, state and replacement holidays
GET/working-days?state=10&from=2027-03-01&to=2027-03-31Working days between two dates
GET/tables/socsoFull SOCSO table
GET/tables/eisFull EIS table
GET/tables/pcbPCB Table 1 and reliefs
GET/metaRules version and sources

Get a free API key on RapidAPI →

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_leave
  • age, epf_category: citizen, pr, foreign, exempt; epf_employee_rate to override 11%; lindung24 (default true); socso_category
  • marital (single / married / divorced / widowed), spouse_working or category 1–3; children: {under18, study18, higher, disabled, disabled_higher}; disabled_self, disabled_spouse
  • tp1_deductions, claim_socso_relief, zakat, resident; for exact month-by-month PCB: month and ytd {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