Delete 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. |
Request
- Base URLhttps://test-api.service.hmrc.gov.uk
- AuthOAuth 2Authorization codehttps://api.service.hmrc.gov.uk/oauth/authorizeToken URLhttps://api.service.hmrc.gov.uk/oauth/tokenScopeswrite:self-assessment
Path parameters
National Insurance number in the format AA999999A.
A unique identifier for the customer provided CIS deduction amendment.
The tax year the data applies to, for example, 2025-26. The start year and end year must not span two tax years.
Headers
An OAuth 2.0 Bearer Token with the write:self-assessment scope.
Specifies the response format and the version of the API to be used.
Only in sandbox environment. See Test Data table for all header values.
Response
Success (No Content)
Changes
No recorded changes to this operation across all 3 revisions of this API.