Skip to main content

ODSOrganisationRole

Terminology CodeSystem containing reference data for roles held by organisations and sites within the ODS.

Overview

The ODSOrganisationRole is a reference CodeSystem held on the NHS England Terminology Server (ODS Instance) which provides the valid subset of roles that an organisation or site may have.

Each role has a property called primaryRole which is set to true when the role is a primary role, all other roles are considered non-primary.

An organisation will have one and only one primary role, but may have none or several non-primary roles.

It is potentially subject to change daily as new roles could be introduced at any time, therefore we suggest that you retrieve the latest version via the API.

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


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
primaryRole Indicates whether the role is a Primary Role (True) or Non-Primary Role (False)

Other CodeSystems available

The CodeSystem names in the tables below are case sensitive.

Resolvable CodeSystems

The following CodeSystems are resolvable.

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.

Last edited: 27 October 2025 2:08 pm