Last updated 9 October 2026View as Markdown

Tax years

GET /v1/tax-years No key

The tax years supported, with the HMRC test data each one passes. No key needed.

Request

No parameters.

Example

curl https://api.checktakehomepay.co.uk/v1/tax-years

const response = await fetch('https://api.checktakehomepay.co.uk/v1/tax-years');
const result = await response.json();

import requests

response = requests.get("https://api.checktakehomepay.co.uk/v1/tax-years")
result = response.json()

Response

200, with the result and what produced it: tax_year, engine, hmrc_test_data, assumptions and sources. This is the example's real response. Every field's type is in the OpenAPI document.

200 OK

{
  "tax_year": "2026-27",
  "engine": "2026-27.1",
  "hmrc_test_data": "rest of UK and Welsh tax v1.0, Scottish tax v1.1, NI v1.0, directors NI v1.0, student loans v1.0",
  "tax_years": [
    {
      "id": "2026-27",
      "latest": true,
      "tax_year": "2026-27",
      "engine": "2026-27.1",
      "hmrc_test_data": "rest of UK and Welsh tax v1.0, Scottish tax v1.1, NI v1.0, directors NI v1.0, student loans v1.0"
    }
  ],
  "assumptions": [
    "A tax year runs from 6 April to 5 April."
  ],
  "sources": [
    "https://www.gov.uk/government/publications/software-developers-payroll-test-data-2026-to-2027"
  ]
}

Errors

400 INVALID_INPUT: the message names each field that is wrong.

Every code, and how to handle them: Errors.