---
title: "Unignore Employment"
method: POST
path: "/individuals/employments-income/{nino}/{taxYear}/{employmentId}/unignore"
tags: ["Employments"]
---

# Unignore Employment

`POST /individuals/employments-income/{nino}/{taxYear}/{employmentId}/unignore`

## Request

- Base URL: `https://test-api.service.hmrc.gov.uk`
- URL: `https://test-api.service.hmrc.gov.uk/individuals/employments-income/{nino}/{taxYear}/{employmentId}/unignore`
- Auth: OAuth 2
  - Authorization code: `https://api.service.hmrc.gov.uk/oauth/authorize`
  - Token URL: `https://api.service.hmrc.gov.uk/oauth/token` scopes: `write:self-assessment`

This endpoint enables you to unignore the HMRC provided employment from a list of employments for this user.
<strong>This endpoint can only be used after the tax year has ended.</strong>
A National Insurance number, tax year and Employment ID 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 success response.                                       |
| CUSTOM_EMPLOYMENT                | Simulates the scenario where a custom employment is submitted.    |
| NOT_FOUND                        | Simulates the scenario where no data is found.                    |
| TAX_YEAR_NOT_ENDED               | Simulates the scenario where the tax year provided has not ended. | 
| REQUEST_CANNOT_BE_FULFILLED      | Simulates the scenario where the request cannot be fulfilled for various reasons other than the ones triggering other errors.|
| OUTSIDE_AMENDMENT_WINDOW         | Simulates the scenario where request cannot be completed as it is outside the amendment window. |

## Path parameters

- `nino` string, required
- `taxYear` string, required
- `employmentId` string, required

## Headers

- `Accept` 'application/vnd.hmrc.2.0+json', required
- `Authorization` string, required
- `Gov-Test-Scenario` string

## Response `200`

Success

## Other responses

- `400`: Bad request
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/hmrc/apis/individuals-employments-income-api.md) - [All operations](https://skmtc.dev/hmrc/apis/individuals-employments-income-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hmrc/apis/individuals-employments-income-api/revisions/45b932910807?raw)
