v1

latestOpenAPI 3.0.32026-07-237121.0 KB

Employment Expenses

Ignore Employment Expenses

This endpoint enables you to ignore HMRC-provided employment expenses for this user. A National Insurance number and tax year must be provided. This endpoint can only be used after the tax year has ended.

Ignoring an expense will remove any amended expenses and add the "dateIgnored" flag to HMRC-provided expenses.

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.
TAX_YEAR_NOT_ENDED	Simulates the scenario where the submission is for a tax year that has not ended.
NOT_FOUND	Scenario to simulate not found error.
OUTSIDE_AMENDMENT_WINDOW	Simulates the scenario where request cannot be completed as it is outside the amendment window.

post/individuals/expenses/employments/{nino}/{taxYear}/ignore

Path parameters

ninostring required

Example:TC663795B

National Insurance number, in the format AA999999A

taxYearstring required

Example:2022-23

The tax year to which the data applies. For example: 2022-23. The start year and end year must not span two tax years. The minimum tax year is 2022-23. No gaps are allowed, for example, 2022-24 is not valid. (The minimum tax year in Sandbox is 2021-22.)

Headers

Accept'application/vnd.hmrc.3.0+json' required

Specifies the response format and the version of the API to be used.

Authorizationstring required

Example:Bearer bb7fed3fe10dd235a2ccda3d50fb

An OAuth 2.0 Bearer Token with the write:self-assessment scope.

Gov-Test-Scenariostring

Example:-

Only in sandbox environment. See Test Data table for all header values.

Response

Success(No Content)