v1
latestOpenAPI 3.0.32026-07-131416.5 KBindividual-income
Get annual income summary
Fetches an individual’s annual income summary for the given tax year.
get/individual-income/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 income being retrieved.
Headers
Accept'application/vnd.hmrc.1.2+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-income scope.
Response
OK
Example response
{
"pensionsAnnuitiesAndOtherStateBenefits": {
"otherPensionsAndRetirementAnnuities": 36.5,
"incapacityBenefit": 980.45,
"jobseekersAllowance": 89.99,
"seissNetPaid": 55.55
},
"employments": [
{
"employerPayeReference": "123/AB456",
"payFromEmployment": 22500
}
]
}