v1

latestOpenAPI 3.0.32026-07-131515.9 KB
individual-tax

Get tax summary

Fetches an individual’s annual tax summary for the given tax year.

get/individual-tax/sa/{utr}/annual-summary/{taxYear}

Path parameters

utrstring required
Example:2234567890

The 10 digit self-assessment UTR for the individual.

taxYearstring required
Example:2016-17

The tax year for the tax being retrieved.

Headers

Accept'application/vnd.hmrc.1.1+json' required

Specifies the response format and the version of the API to be used.

Authorizationstring required
Example:Bearer bb7fed3fe10dd235a2ccda3d50fb

An OAuth 2.0 Bearer Token with the read:individual-tax scope.

Response

OK

Example response

{
  "pensionsAnnuitiesAndOtherStateBenefits": {
    "otherPensionsAndRetirementAnnuities": 36.5,
    "incapacityBenefit": 980.45
  },
  "refunds": {
    "taxRefundedOrSetOff": 325
  },
  "employments": [
    {
      "employerPayeReference": "123/AB456",
      "taxTakenOffPay": 890.35
    }
  ]
}
All 1 operations