v1

latestOpenAPI 3.0.32026-07-1352255.1 KB
individual-paye-test-support

Create annual income summary test data

Supports the Individual Income API by creating annual income test data.

post/individual-paye-test-support/sa/{utr}/income/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 test data being created.

Headers

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

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

Content-Type'application/json' required

Specifies the format of the request body, which must be JSON.

Authorizationstring required
Example:Bearer 59fc92c1cdf0b8ef1f138a702effdbd2

An OAuth 2.0 Bearer Token.

Request body

object required

Create Individual Income summary test data request

Response

Created

Example response

{
  "pensionsAnnuitiesAndOtherStateBenefits": {
    "otherPensionsAndRetirementAnnuities": 36.5,
    "incapacityBenefit": 980.45,
    "jobseekersAllowance": 89.99,
    "seissNetPaid": 55.55
  },
  "employments": [
    {
      "employerPayeReference": "123/AB456",
      "payFromEmployment": 22500
    }
  ]
}