v1

latestOpenAPI 3.0.32026-07-137121.1 KB

Employment Expenses

Ignore Employment Expenses

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

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)