---
title: "Delete CIS Deductions for Subcontractor"
method: DELETE
path: "/individuals/deductions/cis/{nino}/amendments/{submissionId}/{taxYear}"
---

# Delete CIS Deductions for Subcontractor

`DELETE /individuals/deductions/cis/{nino}/amendments/{submissionId}/{taxYear}`

## Request

- Base URL: `https://test-api.service.hmrc.gov.uk`
- URL: `https://test-api.service.hmrc.gov.uk/individuals/deductions/cis/{nino}/amendments/{submissionId}/{taxYear}`
- Auth: OAuth 2
  - Authorization code: `https://api.service.hmrc.gov.uk/oauth/authorize`
  - Token URL: `https://api.service.hmrc.gov.uk/oauth/token` scopes: `write:self-assessment`

This endpoint allows a developer to remove a customer’s CIS deductions data that has been previously populated. A National Insurance number, submission ID and tax year must be provided.

### Test data
Scenario simulation using Gov-Test-Scenario headers is only available in the sandbox environment.

| Header Value (Gov-Test-Scenario) | Scenario                                                                                         |
|----------------------------------|--------------------------------------------------------------------------------------------------|
| N/A - DEFAULT                    | Simulates successfully deleting CIS deductions.                                                  |
| NOT_FOUND                        | Simulates the scenario where the CIS deduction was not found.                                    |
| TAX_YEAR_NOT_SUPPORTED           | Simulates the scenario where the tax year is not supported.                                  |
| OUTSIDE_AMENDMENT_WINDOW         | Simulates the scenario where request cannot be completed as it is outside the amendment window.  |
| STATEFUL                         | Performs a stateful delete.                                                                      |

## Path parameters

- `nino` string, required
- `submissionId` string, required
- `taxYear` string, required

## Headers

- `Authorization` string, required
- `Accept` string, required
- `Gov-Test-Scenario` string

## Response `204`

Success (No Content)

## Other responses

- `400`: Bad request
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/hmrc/apis/cis-deductions-mtd.md) - [All operations](https://skmtc.dev/hmrc/apis/cis-deductions-mtd/llms.txt) - [OpenAPI document](https://skmtc.dev/hmrc/apis/cis-deductions-mtd/revisions/a0f7d1c5512d?raw)
