Skip to main content

Organisation Data Service - FHIR API

Access details of health and social care organisations using our Organisation Data Service (ODS) FHIR API.


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.


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.


For a full list of interactions for this API, see the Resources Overview.

For details on the general structure of the interactions, see FHIR.

Last edited: 12 July 2021 4:17 pm