---
title: "Amend CIS Deductions for Subcontractor"
method: PUT
path: "/individuals/deductions/cis/{nino}/amendments/{submissionId}"
---

# Amend CIS Deductions for Subcontractor

`PUT /individuals/deductions/cis/{nino}/amendments/{submissionId}`

This endpoint allows a developer to amend a customer’s CIS deductions data that has been previously populated. A National Insurance number and submission ID 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 success response.                                                                                                    |
| DEDUCTIONS_DATE_RANGE_INVALID    | Simulates the scenario where the deductions period does not align from the 6th of one month to the 5th of the following month. |
| UNALIGNED_DEDUCTIONS_PERIOD      | Simulates the scenario where the deductions periods do not align with the tax year supplied.                                   |
| DUPLICATE_PERIOD                 | Simulates the scenario where CIS deductions already exists for this period.                                                    |
| 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 update.                                                                                                    |

## Path parameters

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

## Headers

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

## Request body

- object
  - `periodData` object[], required — List of deductions. At least one item is required.
    - `deductionAmount` number, required — The amount of tax deducted by the contractor. The value must be between 0 and 99999999999.99 up to 2 decimal places.
    - `deductionFromDate` string, date, required — The From date when the deduction was made within the CIS tax year period. Must conform to the format `YYYY-MM-DD`
    - `deductionToDate` string, date, required — The To date when the deduction was made within the CIS tax year period. Must conform to the format `YYYY-MM-DD`
    - `costOfMaterials` number — The cost of materials incurred under CIS. This value must be between 0 and 99999999999.99 up to 2 decimal places.
    - `grossAmountPaid` number — The gross amount paid under CIS. The value must be between 0 and 99999999999.99 up to 2 decimal places.

## Response `204`

Success (No Content)

## Other responses

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

---

[API](https://skmtc.net/hmrc/apis/cis-deductions-api.md) · [All operations](https://skmtc.net/hmrc/apis/cis-deductions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hmrc/cis-deductions-api/revisions/2ca83b456b18/schema)