v1

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

Create tax summary test data

Supports the Individual Tax API by creating annual tax test data.

post/individual-paye-test-support/sa/{utr}/tax/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 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 Tax summary test data request

Response

Created

Example response

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