practitioner-relationship-instance
The practitioner-relationship-instance is a terminology CodeSystem which holds the individual relationships held by a practitioner to their employing organisation.
Overview
The practitioner-relationship-instance is a CodeSystem held on the NHS England Terminology Server (ODS Instance) which holds the individual relationships held by a practitioner to their employing organisation.
It is subject to change daily as new practitioners 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 |
|---|---|
| joinDate | Date prescriber joined organisation |
| leftDate | Date prescriber left organisation |
| orgCode | Organisation where the practitioner role is held |
| practitionerCode | Unique identifier for the prescribing practitioner |
| status | Status of the practitioner membership/affiliation with an organisation (active/inactive) |
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:55 pm