A client's employment income for a tax year under MTD Income Tax: the employments themselves, the financial details held against each, and the income belonging to no single employment (non-PAYE tips, share schemes, lump sums, deductions). Employments come from two places and what can be done to them differs: one HMRC hold from the employer's RTI submissions cannot be edited or deleted, only ignored, while a custom employment added here can be amended and deleted but never ignored.

Ignore Employment

POST /tenants/{tenant}/clients/{client}/mtd/employments/{taxYear}/{employmentId}/ignore

Marks an HMRC-held employment as ignored, leaving it out of the year's tax calculation. This is how a duplicated or wrong employment from an employer's submissions is dealt with: the record stays at HMRC — it is the employer's, not ours to delete — but stops counting. Not available for custom employments, which are deleted instead.

Parameters

Name	Type	Description
tenant*	path string	The Tenant.Code
The Tenant.Code
client*	path string
employmentId*	path string
taxYear*	path string

Responses

204 No Content

400 Bad Request

401 Unauthorized – Invalid or missing API key

404 Not Found

Ignore Employment

Parameters

Responses

Try it