v1

latestOpenAPI 3.0.32026-07-138463.8 KB
ITSA Status

Create and Amend Test ITSA Status

This endpoint enables you to create and amend a test ITSA status for a specified customer for use within the sandbox environment. The ITSA status provided is used to validate periodic and annual submissions for the customer's income sources.

A National Insurance number and tax year must be provided.

Any test ITSA status is automatically purged from the database 7 days after its creation.

post/individuals/self-assessment-test-support/itsa-status/{nino}/{taxYear}

Path parameters

ninostring required
Example:TC663795B

National Insurance number.

taxYearstring YYYY-YY required
Example:2023-24

The tax year to submit data for. The start year and end year must not span two tax years. No gaps are allowed - for example, 2023-25 is not valid. There is no minimum tax year.

Headers

Accept'application/vnd.hmrc.1.0+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 write:self-assessment scope.

Request body

Response

Success (No Content)