v1
latestOpenAPI 3.0.32026-07-234697.5 KBDelete CIS Deductions for Subcontractor
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. |
delete/individuals/deductions/cis/{nino}/amendments/{submissionId}/{taxYear}
Path parameters
ninostring required
Example:TC663795B
National Insurance number in the format AA999999A.
submissionIdstring required
Example:4557ecb5-fd32-48cc-81f5-e6acd1099f3c
A unique identifier for the customer provided CIS deduction amendment.
taxYearstring required
Example:2021-22
The tax year the data applies to, for example, 2021-22. The start year and end year must not span two tax years.
Headers
Authorizationstring required
Example:Bearer bb7fed3fe10dd235a2ccda3d50fb
An OAuth 2.0 Bearer Token with the write:self-assessment scope.
Acceptstring required
Example:application/vnd.hmrc.3.0+json
Specifies the response format and the version of the API to be used.
Gov-Test-Scenariostring
Example:-
Only in sandbox environment. See Test Data table for all header values.
Response
Success (No Content)