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.
Access a reduced dataset of health and social care organisations in England and Wales, such as trusts or GP practices, using our Organisation Data Service (ODS) FHIR API.
This API is not designed for high volume usage - to ensure a good level of service you should aim to keep usage below 5 requests per second.
We are working on increasing the capacity of the API. If you have an exceptional need for higher throughput, contact us to discuss your options.
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 our Organisation Data Service (ODS). This FHIR API contains a reduced dataset, most useful for helping with transactions, while the ODS ORD API contains the full dataset from ODS.
You can search for information about an organisation using one or more of their:
An ODS code is a unique identification codes for an organisation that interact with any area of the NHS. 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
For an alternative API that returns full dataset, see Related APIs below.
Who can use this API
This API can only be used to support the delivery of health and social care.
The following API also gives access to the Organisation Data Service:
we do not authenticate or authorise the calling application
we do not authenticate or authorise the end user - they might not even be present
We generally use open-access APIs for public data, where security is not a concern. Our open-access APIs are generally RESTful APIs. For more details on how to access them, see our open-access REST API tutorial.