v1

latestOpenAPI 3.0.32026-07-131313.0 KB
individual-employment

Get employment history

Fetches an individual’s employment history for the given tax year.

get/individual-employment/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-employment scope.

Response

OK

Example response

{
  "employments": [
    {
      "employerPayeReference": "123/AB456",
      "employerName": "Company XYZ"
    }
  ]
}
All 1 operations