Succession - NHS England Digital

Overview

Succession is a CodeSystem stored on the NHS England Terminology Server (ODS Instance) that holds succession (mergers and acquisition) data for statutory organisations.

It is subject to change daily as new organisations are created, therefore we suggest that you retrieve the latest version via the Organisation Data Terminology FHIR R4 API.

This API forms part of the strategic products provided by ODS and is intended to replace our two existing APIs (ORD and ODS STU3).

CodeSystem usage

You can retrieve reference CodeSystems in full, as they are small enough to be returned in a single query.

Larger CodeSystems which generally contain instance data cannot be retrieved in full due to their size.

You can also search or validate individual concepts; codes stored within the CodeSystem.

Refer to our OAS specification for more information.

CodeSystem properties

Property code	Property description
forwardSuccession	A given subject record will only hold reference to an immediate target successor(s). ‘hasForwardSuccession’ indicates whether there is any further forward succession held on the target (i.e. the organisation which succeeded this organisation has been succeeded itself)
legStartDate	The legal start date on which the succession between organisation entities began
predecessor	An entity which has closed and been succeeded by another entity
successor	The entity that has succeeded or persisted following the closure of a predecessor

Other CodeSystems available

The CodeSystem names in the tables below are case sensitive.

Resolvable CodeSystems

The following CodeSystems are resolvable.

CodeSystem	System URL
ODSRecordClass	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/ODSRecordClass
ODSOrganisationRole	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/ODSOrganisationRole
ODSRelationship	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/ODSRelationship
practitioner-role	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/practitioner-role
organization-role-instance	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/organization-role-instance
organization-relationship-instance	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/organization-relationship-instance
succession	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/succession
postcode	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/postcode
geography-name	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/geography-name
practitioner	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/practitioner
practitioner-relationship-instance	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/practitioner-relationship-instance
practitioner-additional-attribute	https://digital.nhs.uk/services/organisation-data-service/CodeSystem/practitioner-additional-attribute

Non-resolvable CodeSystems

The following CodeSystems are non-resolvable.

If you try and navigate to the System URL the browser will display an error. For more details about these CodeSystems refer to our Simplifier pages.

CodeSystem	System URL
ods-organization-code	https://fhir.nhs.uk/Id/ods-organization-code
England-ODSDateTime	https://fhir.nhs.uk/England/CodeSystem/England-ODSDateTime
England-ODSRecordUseType	https://fhir.nhs.uk/England/CodeSystem/England-ODSRecordUseType
England-PeriodType	https://fhir.nhs.uk/England/CodeSystem/England-PeriodType

Companion product

We have also produced a user interface that allows access to the same information through our companion product: ODS Data Search and Export.

Further information

For more specific information about the data refer to our Reference Data Catalogue.

Additional CodeSystems are referenced by the Implementation Guidance, and these can be found on our Simplifier pages.