---
title: "Get deletion notices"
method: GET
path: "/List/{id}"
---

# Get deletion notices

`GET /List/{id}`

## Overview

Use this endpoint to check for any full record or partial record deletions. As these occur infrequently a full `List` of deletions will be provided. 
There are four `Lists` which provide details of deletions that have occured within the ODS Data:
  * Organization-deletion
  * OrganizationAffiliation-deletion
  * Organization-role-deletion
  * Organization-succession-deletion
  
  #### Organization-deletion
  From time to time it is possible that we create or receive organisations which are created in error and removed from the source data. When this occurs there is no update to the record, it is simply no longer available. 
  
  To inform you when organisations have been deleted, we have used the `List` resource to provide the ODS Code of the records which have been deleted so that you may remove them from any local copies you may be maintaining.
  
  #### OrganizationAffilliation-deletion
  In the unlikely event that a relationship must be deleted rather then given an end date, the RelationshipID will be provided in this `List` resource. 
    
  #### Organization-role-deletion
  In the unlikely event that a role is deleted, rather than given an end date, the roleID will be provided in this list resource. As the role forms part of the Organization Resource you may not need to take action other than to verify the role was intentionally removed.
  
  #### Organization-succession-deletion
  In the unlikely event that the succession is removed from an organisation, the Organisation's ODS Code and that of its successor will be published in this list resource. As the successor and predecessor are properties of the ods-organization-code CodeSystem, you may not need to take action if you are maintaining a local copy of the CodeSystem other than to verify the succession was intentionally removed.

## Path parameters

- `id` string, required

## Response `200`

a valid List resource containing details of deleted records

---

[API](https://skmtc.net/nhs/apis/organisation-data-terminology-api-2.md) · [All operations](https://skmtc.net/nhs/apis/organisation-data-terminology-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nhs/organisation-data-terminology-api-2/versions/c2df8e70fcf4/schema)