organization-role-instance
The organization-role-instance is a terminology CodeSystem which holds the history of which roles are or have been assigned to an organisation or site.
Overview
The organization-role-instance is a CodeSystem held on the NHS England Terminology Server (ODS Instance) that holds the history of which roles are or have been assigned to an organisation or site.
It is subject to change daily as new organisations are created, 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 |
|---|---|
| legEndDate | Legal end date for an instance of an organisation role |
| legStartDate | Legal start date for an instance of an organisation role |
| opEndDate | Operational end date for an instance of an organisation role |
| opStartDate | Operational start date for an instance of an organisation role |
| orgCode | Organisation code to which the role applies |
| primaryRole | Identifies if an instance of an organisation role is its primary role (true) |
| role | Role ID |
| status | Status (active/inactive) of an instance of an organisation role |
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:21 pm