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