---
title: "Create and Amend Test ITSA Status"
method: POST
path: "/individuals/self-assessment-test-support/itsa-status/{nino}/{taxYear}"
tags: ["ITSA Status"]
---

# Create and Amend Test ITSA Status

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

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.

## Path parameters

- `nino` string, required
- `taxYear` string, YYYY-YY, required

## Headers

- `Accept` 'application/vnd.hmrc.1.0+json', required
- `Authorization` string, required

## Request body

- object
  - `itsaStatusDetails` object[], required
    - `submittedOn` string, YYYY-MM-DDThh:mm:ss.SSSZ, required — The date the ITSA status was submitted, in the format YYYY-MM-DDThh:mm:ss.SSSZ
    - `status` 'No Status' | 'MTD Mandated' | 'MTD Voluntary' | 'Annual' | 'Non Digital' | 'Dormant' | 'MTD Exempt', required — The ITSA status for the tax year.
    - `statusReason` 'Sign up - return available' | 'Sign up - no return available' | 'ITSA final declaration' | 'ITSA Q4 declaration' | 'CESA SA return' | 'Complex' | 'Ceased income source' | 'Reinstated income source' | 'Rollover' | 'Income Source Latency Changes' | 'MTD ITSA Opt-Out' | 'MTD ITSA Opt-In' | 'Digitally Exempt', required — The reason for the ITSA status.
    - `businessIncome2YearsPrior` number — The business income for 2 years prior to the specified taxYear. For example, if the tax year requested is 2026-27, then 'businessIncome2YearsPrior' is for the 2024-25 tax year. For Q4 check, the business income 1 year prior will be used.

## Response `204`

Success (No Content)

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

[API](https://skmtc.net/hmrc/apis/mtd-sa-test-support-api.md) · [All operations](https://skmtc.net/hmrc/apis/mtd-sa-test-support-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hmrc/mtd-sa-test-support-api/revisions/5ea7ba089419/schema)