practitioner-role
The practitioner-role terminology CodeSystem provides the valid subset of roles that a practitioner may have.
Overview
The practitioner-role is a reference CodeSystem held on the NHS England Terminology Server (ODS Instance) which provides the valid subset of roles that a practitioner may have.
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.
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: 23 June 2025 2:15 pm