Employment API Reference
National minimum wage rates and pension auto-enrolment thresholds.
Base URL: https://api.govdata.dev/v1
Minimum Wage
GET
/v1/employment/minimum-wage/rates
response
Waiting for request...
Current national minimum and living wage rates by age band.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
tax_year |
string | No | Tax year in YYYY-YY format. Defaults to current year. |
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.govdata.dev/v1/employment/minimum-wage/rates
uri = URI("https://api.govdata.dev/v1/employment/minimum-wage/rates") req = Net::HTTP::Get.new(uri) req["Authorization"] = "Bearer YOUR_API_KEY" res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
response = requests.get( "https://api.govdata.dev/v1/employment/minimum-wage/rates", headers={"Authorization": "Bearer YOUR_API_KEY"} )
const response = await fetch("https://api.govdata.dev/v1/employment/minimum-wage/rates", { headers: { "Authorization": "Bearer YOUR_API_KEY" } });
Response
{ "data": { "tax_year": "2025-26", "effective_from": "2025-04-01", "rates": [ { "band": "National Living Wage (21+)", "hourly_rate": 12.21 }, { "band": "18-20", "hourly_rate": 10.00 }, { "band": "16-17", "hourly_rate": 7.55 }, { "band": "Apprentice", "hourly_rate": 7.55 } ] }, "meta": { "api_version": "v1", "licence": "Open Government Licence v3.0", "source": "GOV.UK", "source_url": "https://www.gov.uk/national-minimum-wage-rates" } }
Auto-Enrolment
GET
/v1/employment/auto-enrolment/thresholds
response
Waiting for request...
Pension auto-enrolment earnings thresholds and contribution rates.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
tax_year |
string | No | Tax year in YYYY-YY format. Defaults to current year. |
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.govdata.dev/v1/employment/auto-enrolment/thresholds
uri = URI("https://api.govdata.dev/v1/employment/auto-enrolment/thresholds") req = Net::HTTP::Get.new(uri) req["Authorization"] = "Bearer YOUR_API_KEY" res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
response = requests.get( "https://api.govdata.dev/v1/employment/auto-enrolment/thresholds", headers={"Authorization": "Bearer YOUR_API_KEY"} )
const response = await fetch("https://api.govdata.dev/v1/employment/auto-enrolment/thresholds", { headers: { "Authorization": "Bearer YOUR_API_KEY" } });
Response
{ "data": { "tax_year": "2025-26", "thresholds": { "lower_qualifying_earnings": 6240, "earnings_trigger": 10000, "upper_qualifying_earnings": 50270 }, "contribution_rates": { "employee_minimum": 0.05, "employer_minimum": 0.03, "total_minimum": 0.08 } }, "meta": { "api_version": "v1", "licence": "Open Government Licence v3.0", "source": "GOV.UK", "source_url": "https://www.gov.uk/workplace-pensions/what-your-employer-must-do" } }
Employment data is sourced from GOV.UK and updated at the start of each tax year. Contains public sector information licensed under the Open Government Licence v3.0.
Data Coverage
| Source | HMRC / GOV.UK |
| Date range | 2020-21 to 2025-26 tax years |
| Records | Minimum wage rates and auto-enrolment thresholds |
| Updated | Annually |
| Limitations | Historical rates before 2020-21 not yet available |