Net salary API
A read-only JSON API that runs the same engines as the website. No key needed; limited to 60 requests a minute per IP address.
Request
GET https://www.example.com/api/v1/net?cc=de&gross=36000®ion=BY&class=1| Parameter | Meaning |
|---|---|
cc | Country code (gb, de, nl, ca, au). |
gross | Gross salary. Annual unless period is set. |
period | year (default), month, fortnight, biweekly, week or hour. |
region | Region code where it matters (UK: ENG, SCT, WLS, NIR; Germany: Land code such as BY; Canada: ON, QC, BC, AB, MB). |
year | Tax year (the year it starts in). Defaults to the year in force today. |
| options | Country options by name, e.g. class (German tax class), church=1, student_loan=plan2, help=1. |
Countries and options
| cc | Tax year | region | Options |
|---|---|---|---|
gb | 2026/27 | ENG, SCT, WLS, NIR | student_loan (none|plan1|plan2|plan4|plan5) postgrad_loan (bool) pension (percent) pension_method (net_pay|relief_at_source|salary_sacrifice) |
de | 2026 | NW, BY, BW, NI, HE, SN, RP, BE, SH, BB, ST, TH, HH, MV, SL, HB | tax_class (1|2|3|4|5|6) church (bool) children (int) under_23 (bool) health (gkv|pkv) zusatzbeitrag (percent) pkv_premium (number) |
nl | 2026 | holiday_pay (bool) thirteenth_month (bool) tax_credit (bool) pension (percent) | |
ca | 2026 | ON, QC, BC, AB, MB | rrsp (number) |
au | 2026–27 | super_included (bool) help (bool) private_cover (bool) standard_deduction (bool) |
Response
The response lists every line (tax, contribution, credit) in annual amounts, net per year, month and week, the tax year and any value not yet confirmed with an official source.
Figures are estimates for a standard employee; please link back when you publish them.