We have detected that you are using Internet Explorer to visit this website. Internet Explorer is now being phased out by Microsoft. As a result, NHS Digital no longer supports any version of Internet Explorer for our web-based products, as it involves considerable extra effort and expense, which cannot be justified from public funds. Some features on this site will not work. You should use a modern browser such as Edge, Chrome, Firefox, or Safari. If you have difficulty installing or accessing a different browser, contact your IT support team.
Organisation Data Service - FHIR API
Access details of health and social care organisations using our Organisation Data Service (ODS) FHIR API.
Page contents
Overview
Use this API to access details of health and social care organisations from the Organisation Data Service (ODS).
You can search for information about an organisation using one or more of their:
- ODS code
- last updated date
- name
- active or inactive status
- postcode or city
- organisation's role or primary role
You can also limit the number of results returned, or just request a count of the number of search results.
For more details, see the Introduction to FHIR® ODS Lookup API.
Note this ODS FHIR API contains a reduced dataset of the full ODS record, providing a simple way to support health transactions and interoperability. For alternatives, see Technology below.
API status
This API is stable.
Technology
This API is a FHIR API.
Specifically, it is based on the HL7 FHIR STU3 Messaging Implementation.
For more details, see FHIR.
We also have an ODS Organisation Reference Data (ORD) API available that contains the full record dataset from ODS. To choose which one best suits your needs, see the Benefits of the ODS API suite.
Interactions
For a full list of interactions for this API, see the Resources Overview.
For details on the general structure of the interactions, see FHIR.