Skip to main content
Table of contents

Organisation Data Service - FHIR API

Overview

Use this API to access a reduced dataset of health and social care organisations in England and Wales, such as trusts or GP practices, using the Organisation Data Service (ODS).

This FHIR API contains a reduced dataset, most useful for  transactions. To access the full ODS dataset, including data about succession (history) or relationships, use the ODS ORD API.

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, such as trusts or GP practices

You can also limit the number of results returned, or just request a count of the number of search results.

You cannot:

  • access the full dataset from ODS, specifically no information about succession (history) or relationships
  • search for an organisation using an address

An ODS code is a unique identification code for an organisation that interacts with any area of the NHS. For a full list of the organisation types available, see CSV downloads.

This API returns the following reduced dataset of an organisation, when searched with an ODS code:

  • organisation - ODS code, name, open date, close date, last change date and status if active or inactive
  • address - house or flat number, line 1, line 2, line 3, town, postcode and country
  • contacts - email, website, telephone and fax
  • roles - primary and non-primary roles

To access the full ODS dataset, use the ODS ORD API.

Documentation

Organisation Data Service - FHIR API documentation

Endpoint

https://digital.nhs.uk/developer/api-catalogue/organisation-data-service-fhir

Contact

https://digital.nhs.uk/developer/help-and-support