Skip to main content
Table of contents

Organisation Data Service - ORD API

Overview

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

This ORD-compatible API contains the full dataset from ODS, including information on succession (history) and relationships.

We also have an ODS FHIR API which contains a reduced dataset, most useful for transactions.

You can:

  • search for organisations
  • get the organisation details for a given ODS code
  • get a list of recently modified organisations
  • get metadata for roles, relationships and record classes
  • get a list of organisations that have been modified since a specific date to synchronise data locally

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 full dataset for 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
  • relationships - legal and operational relationships including history where it was captured by ODS
  • succession - history of legal succession following reconfiguration or mergers
  • additional attributes - data items included to support policy and pragmatic change

For an alternative API that returns a reduced dataset, use the ODS FHIR API.

Documentation

Organisation Data Service - ORD API documentation

Endpoint

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

Contact

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