CalcHub UK Tax API

Take-home pay

GET /api/v1/take-home/<salary>-<region>

• salary — gross annual salary in GBP (round £5k steps £10k–£200k pre-generated)
• region — england, scotland, wales or northern-ireland

curl https://calchub.uk/api/v1/take-home/50000-england

{
  "endpoint": "take-home",
  "year": "2026-27",
  "input": { "grossSalary": 50000, "region": "england" },
  "result": {
    "takeHomePay": ...,
    "incomeTax": ...,
    "nationalInsurance": ...,
    "monthlyTakeHome": ...
  },
  "attribution": "Calculated by CalcHub.uk",
  "source": "https://www.gov.uk/income-tax-rates"
}

More endpoints

• GET /api/v1/income-tax/<income>-<region> — UK Income Tax bands (England/Wales/NI + Scotland 6-band)
• GET /api/v1/national-insurance/<salary> — Class 1 employee NI (UK-wide)
• GET /api/v1/stamp-duty/<price>-<region> — SDLT (england), LBTT (scotland), LTT (wales)
• GET /api/v1/vat/<amount>-<rate>-<direction> — add/remove VAT (rate: standard|reduced)

Round-number values are pre-generated; arbitrary inputs, first-time-buyer / additional-property stamp duty, and more endpoints are on the roadmap.

Code examples

# curl
curl https://calchub.uk/api/v1/take-home/50000-england

// JavaScript (fetch)
const r = await fetch('https://calchub.uk/api/v1/take-home/50000-england');
const data = await r.json();
console.log(data.result.takeHomePay);

# Python (requests)
import requests
data = requests.get('https://calchub.uk/api/v1/take-home/50000-england').json()
print(data['result']['takeHomePay'])

Machine-readable contract: OpenAPI 3.1 spec · Postman collection.

Attribution & limits

• Free for non-commercial and commercial use with a visible do-follow link to CalcHub.uk.
• Figures are estimates for the 2026/27 UK tax year and may change as rules update.
• Arbitrary inputs (any integer) via a forthcoming Cloudflare Worker; OpenAPI spec on the roadmap.