# Organisation Data Service (ODS)

**URL:** https://developer.community.nhs.uk/c/ods/21.md

[Latest](https://developer.community.nhs.uk/latest.md) · [Categories](https://developer.community.nhs.uk/categories.md) · [Tags](https://developer.community.nhs.uk/tags.md)

---

## [About the Organisation Data Service (ODS) category](https://developer.community.nhs.uk/t/about-the-organisation-data-service-ods-category/483)

<div class="topic-metadata">

**Author:** [@akunna.ndubuisi1](https://developer.community.nhs.uk/u/akunna.ndubuisi1)\
**Replies:** 0\
**Last updated:** [13 September 2023 15:17 UTC](https://developer.community.nhs.uk/t/about-the-organisation-data-service-ods-category/483 "2023-09-13T15:17:43Z")

</div>

The Organisation Data Service (ODS) issues and manages unique identification codes (ODS codes) and accompanying reference data for organisations that interact with any area of the NHS. Data is published via the Organisa…

---

## [Production Access to Organisation Data Terminology - FHIR API](https://developer.community.nhs.uk/t/production-access-to-organisation-data-terminology-fhir-api/15180)

<div class="topic-metadata">

**Author:** [@Aftab\_Ali](https://developer.community.nhs.uk/u/Aftab_Ali)\
**Replies:** 3\
**Last updated:** [30 September 2026 10:15 UTC](https://developer.community.nhs.uk/t/production-access-to-organisation-data-terminology-fhir-api/15180 "2026-09-30T10:15:59Z")

</div>

Hi, I need some help with enabling production access for the Organisation Data Terminology - FHIR API We have completed the DOS process, and it was approved last year. One of our customers is now going live with an int…

---

## [ODT FHIR R4 Local Authority](https://developer.community.nhs.uk/t/odt-fhir-r4-local-authority/13888)

<div class="topic-metadata">

**Author:** [@Bob\_Walker](https://developer.community.nhs.uk/u/Bob_Walker)\
**Replies:** 3\
**Last updated:** [11 September 2026 08:40 UTC](https://developer.community.nhs.uk/t/odt-fhir-r4-local-authority/13888 "2026-09-11T08:40:39Z")

</div>

The LA code returned by the postcode CodeSystem lookup seems to be that of the ONS NSPL data - e.g. for “L1 1LN” I get an LA code of “316”. My understanding is that this is derived from the LSOA associated with the post…

---

## [Changing GP Surgery on a test account](https://developer.community.nhs.uk/t/changing-gp-surgery-on-a-test-account/13859)

<div class="topic-metadata">

**Author:** [@Will\_Robinson](https://developer.community.nhs.uk/u/Will_Robinson)\
**Replies:** 2\
**Last updated:** [4 August 2026 13:35 UTC](https://developer.community.nhs.uk/t/changing-gp-surgery-on-a-test-account/13859 "2026-08-04T13:35:10Z")

</div>

Hi, We’re testing an NHS Login implementation in the sandpit environment and I would like to change the GP Surgery associated with an account, so I can test that when we re-log back in it is fetching the new ODS code an…

---

## [Practitioner-relationship-instance questions](https://developer.community.nhs.uk/t/practitioner-relationship-instance-questions/12860)

<div class="topic-metadata">

**Author:** [@as140](https://developer.community.nhs.uk/u/as140)\
**Replies:** 6\
**Last updated:** [30 July 2026 12:51 UTC](https://developer.community.nhs.uk/t/practitioner-relationship-instance-questions/12860 "2026-07-30T12:51:31Z")

</div>

I’m working on using the APIs to get the content of the egpcur file. I’m using the practitioner and practitioner-relationship-instance codesystems which I think is the best way to do it? The results I’m getting from pr…

---

## [FHIR : Getting updated info from endpoint or from one API call](https://developer.community.nhs.uk/t/fhir-getting-updated-info-from-endpoint-or-from-one-api-call/12970)

<div class="topic-metadata">

**Author:** [@Sean\_Redikin](https://developer.community.nhs.uk/u/Sean_Redikin)\
**Replies:** 1\
**Last updated:** [25 June 2026 08:07 UTC](https://developer.community.nhs.uk/t/fhir-getting-updated-info-from-endpoint-or-from-one-api-call/12970 "2026-06-25T08:07:05Z")

</div>

Greetings , My company currently uses the link provided below to get info about the latest changes to the organization database using ORD. I would like to know if there will be a similar link we can use to just get the…

---

## [INT ODT FHIR R4 data set](https://developer.community.nhs.uk/t/int-odt-fhir-r4-data-set/12788)

<div class="topic-metadata">

**Author:** [@Bob\_Walker](https://developer.community.nhs.uk/u/Bob_Walker)\
**Replies:** 4\
**Last updated:** [20 June 2026 05:55 UTC](https://developer.community.nhs.uk/t/int-odt-fhir-r4-data-set/12788 "2026-06-20T05:55:50Z")

</div>

Hi - is the source data for https://int.api.service.nhs.uk/organisation-data-terminology-api/fhir/ different from the data in NIS1 LDAP? The reason I ask is because we are in a process of migration and we have some proc…

---

## [Practitioner code system query](https://developer.community.nhs.uk/t/practitioner-code-system-query/12466)

<div class="topic-metadata">

**Author:** [@as140](https://developer.community.nhs.uk/u/as140)\
**Replies:** 3\
**Last updated:** [8 June 2026 13:02 UTC](https://developer.community.nhs.uk/t/practitioner-code-system-query/12466 "2026-06-08T13:02:40Z")

</div>

Hello, I’m trying to get a list of records which have changed since a particular date. This is my post method query: { “resourceType”: “Parameters”, “parameter”: \[ { “name”: “valueSet”, “resource”: { “resourceTyp…

---

## [Guidance: External to NHS, GP Email API/Dataset](https://developer.community.nhs.uk/t/guidance-external-to-nhs-gp-email-api-dataset/11973)

<div class="topic-metadata">

**Author:** [@Henry\_Woodland](https://developer.community.nhs.uk/u/Henry_Woodland)\
**Replies:** 8\
**Last updated:** [6 May 2026 13:34 UTC](https://developer.community.nhs.uk/t/guidance-external-to-nhs-gp-email-api-dataset/11973 "2026-05-06T13:34:40Z")

</div>

Hello I am a newbie Developer from the Home Office. I am currently developing referral processes where we refer persons to their respectively registered GP through an email. Currently we’re calling GP Secretaries and a…

---

## [Lookup Isle Of Man GP Practices by Commissioning Org](https://developer.community.nhs.uk/t/lookup-isle-of-man-gp-practices-by-commissioning-org/11730)

<div class="topic-metadata">

**Author:** [@Bob\_Walker](https://developer.community.nhs.uk/u/Bob_Walker)\
**Replies:** 3\
**Last updated:** [21 April 2026 12:49 UTC](https://developer.community.nhs.uk/t/lookup-isle-of-man-gp-practices-by-commissioning-org/11730 "2026-04-21T12:49:13Z")

</div>

Hi, I have a requirement to lookup Gp Practices by their Commissioning Organisation. For England and Wales, I can do this with the ODT FHIR R4 API using an /OrganizationAffiliation search and specifying role=RE4 (Is Co…

---

## [Does ODT FHIR R4 return email for a GP Practice?](https://developer.community.nhs.uk/t/does-odt-fhir-r4-return-email-for-a-gp-practice/11584)

<div class="topic-metadata">

**Author:** [@Bob\_Walker](https://developer.community.nhs.uk/u/Bob_Walker)\
**Replies:** 3\
**Last updated:** [9 April 2026 14:57 UTC](https://developer.community.nhs.uk/t/does-odt-fhir-r4-return-email-for-a-gp-practice/11584 "2026-04-09T14:57:13Z")

</div>

Hi, I’ve seen this question asked of the ODS API - is the answer also true of the ODT FHIR R4 API?

---

## [Organisation Data Terminology - FHIR API - Question](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api-question/10628)

<div class="topic-metadata">

**Author:** [@Rahim\_Qureshi](https://developer.community.nhs.uk/u/Rahim_Qureshi)\
**Replies:** 4\
**Last updated:** [11 February 2026 18:03 UTC](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api-question/10628 "2026-02-11T18:03:35Z")

</div>

Is anyone using the above API and does it let you get practitioner details for a given GP Practice ODS code? Thanks

---

## [Failed to resolve API Key variable request.header.apikey](https://developer.community.nhs.uk/t/failed-to-resolve-api-key-variable-request-header-apikey/10185)

<div class="topic-metadata">

**Author:** [@Alan\_Kings](https://developer.community.nhs.uk/u/Alan_Kings)\
**Replies:** 3\
**Last updated:** [21 January 2026 12:10 UTC](https://developer.community.nhs.uk/t/failed-to-resolve-api-key-variable-request-header-apikey/10185 "2026-01-21T12:10:54Z")

</div>

I’m trying to connect to Organisation Data Terminology - FHIR API in the Integration (INT) environment. get the following error { “resourceType”: “OperationOutcome”, “issue”: \[ { “severity”: “error”, “code”: “401”…

---

## [Onboarding organisation code error](https://developer.community.nhs.uk/t/onboarding-organisation-code-error/10180)

<div class="topic-metadata">

**Author:** [@kathrynn\_taylor](https://developer.community.nhs.uk/u/kathrynn_taylor)\
**Replies:** 2\
**Last updated:** [20 January 2026 17:00 UTC](https://developer.community.nhs.uk/t/onboarding-organisation-code-error/10180 "2026-01-20T17:00:10Z")

</div>

Hi I’m adding a product using the new single assurance method. Q2.Does the organisation named above have an Organisation Data Service (ODS) code? I enter YDDAF but get an invalid ODS code message and cannot proceed. W…

---

## [Organisation Data Terminology - FHIR API: Environments](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api-environments/10007)

<div class="topic-metadata">

**Author:** [@Laura\_Mansell](https://developer.community.nhs.uk/u/Laura_Mansell)\
**Replies:** 4\
**Last updated:** [14 January 2026 09:20 UTC](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api-environments/10007 "2026-01-14T09:20:16Z")

</div>

Hi, We have recently completed the onboarding for the Organisation Data Terminology - FHIR API for the “Production” environment. From this we have 1 “Application” in the developer portal and an API key which we need to…

---

## [Organisation Data Terminology - API for RE8 relationships?](https://developer.community.nhs.uk/t/organisation-data-terminology-api-for-re8-relationships/10031)

<div class="topic-metadata">

**Author:** [@Laura\_Mansell](https://developer.community.nhs.uk/u/Laura_Mansell)\
**Replies:** 2\
**Last updated:** [13 January 2026 14:55 UTC](https://developer.community.nhs.uk/t/organisation-data-terminology-api-for-re8-relationships/10031 "2026-01-13T14:55:53Z")

</div>

Hi, Is there any API where I can supply a PCN ODS code and find out all the practices that are a partner to that PCN (the RE8 relationships)? For example, I know you can go the other way around e.g. https://sandbox.api…

---

## [Organisation Data Terminology - FHIR API: Onboarding](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api-onboarding/9895)

<div class="topic-metadata">

**Author:** [@Laura\_Mansell](https://developer.community.nhs.uk/u/Laura_Mansell)\
**Replies:** 2\
**Last updated:** [7 January 2026 15:04 UTC](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api-onboarding/9895 "2026-01-07T15:04:14Z")

</div>

Hi, We have recently completed the onboarding process for the Organisation Data Terminology - FHIR API and we have been approved to use the API. We filled in the questionnaires, added a Team and our Application. I emai…

---

## [Organisation Data Terminology - FHIR API: PrimaryRole](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api-primaryrole/9517)

<div class="topic-metadata">

**Author:** [@Laura\_Mansell](https://developer.community.nhs.uk/u/Laura_Mansell)\
**Replies:** 2\
**Last updated:** [19 December 2025 14:52 UTC](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api-primaryrole/9517 "2025-12-19T14:52:44Z")

</div>

We are migrating from the ‘Organisation Data Service - ORD API’ to the ‘Organisation Data Terminology - FHIR API’. How do we identify the primary role in the FHIR API? In the ORD API we were using the “primaryRole” att…

---

## [Organisation Data Terminology - FHIR API - CodeSystem Parameter](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api-codesystem-parameter/8865)

<div class="topic-metadata">

**Author:** [@Mahesh](https://developer.community.nhs.uk/u/Mahesh)\
**Replies:** 3\
**Last updated:** [20 November 2025 17:07 UTC](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api-codesystem-parameter/8865 "2025-11-20T17:07:39Z")

</div>

Hello All, I am working with ODT API, For the CodeSystem endpoint I have found 1 parameter within next relation \_getpages=W%2F%228879750316029151521%22 . Unable to access the next page pls check below SS

---

## [ODS API - LastChangeDate - Not returning all changed organisations](https://developer.community.nhs.uk/t/ods-api-lastchangedate-not-returning-all-changed-organisations/8594)

<div class="topic-metadata">

**Author:** [@michael.brown30](https://developer.community.nhs.uk/u/michael.brown30)\
**Replies:** 7\
**Last updated:** [11 November 2025 13:59 UTC](https://developer.community.nhs.uk/t/ods-api-lastchangedate-not-returning-all-changed-organisations/8594 "2025-11-11T13:59:53Z")

</div>

Our system contains a list of providers (General Practices). To keep track of name changes we call the ODS API every night and ask for organisations that have changed since the last time we asked. https://directory.spin…

---

## [Using ODS Data for Public Website Integration](https://developer.community.nhs.uk/t/using-ods-data-for-public-website-integration/8270)

<div class="topic-metadata">

**Author:** [@robben07](https://developer.community.nhs.uk/u/robben07)\
**Replies:** 4\
**Last updated:** [22 October 2025 15:01 UTC](https://developer.community.nhs.uk/t/using-ods-data-for-public-website-integration/8270 "2025-10-22T15:01:39Z")

</div>

Hi all, I am looking to display details for the following NHS organisations on an external, user-facing website: GP Practices Pharmacies Hospitals (Trusts and individual sites) Dentists Opticians The i…

---

## [Querying date ranges in the ODS FHIR API](https://developer.community.nhs.uk/t/querying-date-ranges-in-the-ods-fhir-api/8134)

<div class="topic-metadata">

**Author:** [@Thomas\_G](https://developer.community.nhs.uk/u/Thomas_G)\
**Replies:** 3\
**Last updated:** [21 October 2025 10:44 UTC](https://developer.community.nhs.uk/t/querying-date-ranges-in-the-ods-fhir-api/8134 "2025-10-21T10:44:52Z")

</div>

Hi all, I am using the two queries: https://api.service.nhs.uk/organisation-data-terminology-api/fhir/Organization?lastChangeDate=lt2023-05-04&lastChangeDate=gt2023-05-02 https://api.service.nhs.uk/organisation-data-t…

---

## [API Parameter spelling mistake in Organisation Data Terminology - FHIR API](https://developer.community.nhs.uk/t/api-parameter-spelling-mistake-in-organisation-data-terminology-fhir-api/8203)

<div class="topic-metadata">

**Author:** [@Kevin\_Mayfield](https://developer.community.nhs.uk/u/Kevin_Mayfield)\
**Replies:** 1\
**Last updated:** [20 October 2025 13:18 UTC](https://developer.community.nhs.uk/t/api-parameter-spelling-mistake-in-organisation-data-terminology-fhir-api/8203 "2025-10-20T13:18:05Z")

</div>

On behalf of NHS North West Genomics. On this page https://digital.nhs.uk/developer/api-catalogue/organisation-data-terminology#get-/OrganizationAffiliation the parameter primay-organisation is spelt using English spel…

---

## [Best API for Replacing TRUD CSV Downloads – DSE or FHIR?](https://developer.community.nhs.uk/t/best-api-for-replacing-trud-csv-downloads-dse-or-fhir/7253)

<div class="topic-metadata">

**Author:** [@Samuel\_Fadare](https://developer.community.nhs.uk/u/Samuel_Fadare)\
**Replies:** 2\
**Last updated:** [26 August 2025 11:55 UTC](https://developer.community.nhs.uk/t/best-api-for-replacing-trud-csv-downloads-dse-or-fhir/7253 "2025-08-26T11:55:17Z")

</div>

As we prepare for the deprecation of the ODS ORD TRUD packs this September, I’m evaluating the best approach for replacing our current setup. Our workflow involves downloading selected CSV reports and loading them into …

---

## [Organisation Data Terminology - FHIR API](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api/6996)

<div class="topic-metadata">

**Author:** [@Samuel\_Fadare](https://developer.community.nhs.uk/u/Samuel_Fadare)\
**Replies:** 2\
**Last updated:** [20 August 2025 15:22 UTC](https://developer.community.nhs.uk/t/organisation-data-terminology-fhir-api/6996 "2025-08-20T15:22:51Z")

</div>

Hi all, Has anyone migrated to Organisation Data Terminology - FHIR API. I am wondering if NHSE has provided us with a solution on how to download the gridall csv extract?

---

## [ODS FHIR API 422 Unprocessable Entity retrieving larger amounts of data](https://developer.community.nhs.uk/t/ods-fhir-api-422-unprocessable-entity-retrieving-larger-amounts-of-data/6853)

<div class="topic-metadata">

**Author:** [@Robert\_Bolton](https://developer.community.nhs.uk/u/Robert_Bolton)\
**Replies:** 4\
**Last updated:** [31 July 2025 12:33 UTC](https://developer.community.nhs.uk/t/ods-fhir-api-422-unprocessable-entity-retrieving-larger-amounts-of-data/6853 "2025-07-31T12:33:36Z")

</div>

Hi, previously we’ve been using the ODS data dumps from TRUD for practitioner and org data and converting them to FHIR. We’re looking to switch to the Organisation Data Terminology FHIR API but are encountering an issue…

---

## [Data Search Portal - GDS Compliance](https://developer.community.nhs.uk/t/data-search-portal-gds-compliance/6832)

<div class="topic-metadata">

**Author:** [@michael.brown30](https://developer.community.nhs.uk/u/michael.brown30)\
**Replies:** 1\
**Last updated:** [28 July 2025 15:58 UTC](https://developer.community.nhs.uk/t/data-search-portal-gds-compliance/6832 "2025-07-28T15:58:31Z")

</div>

This isn’t a typical question. The ODS Data Search portal was recently redesigned, and very good it is too. ODS Data Search and Export I was just wondering if the redesign had to take into account the NHS GDS rules: htt…

---

## [ORD API deprecation timeline](https://developer.community.nhs.uk/t/ord-api-deprecation-timeline/5722)

<div class="topic-metadata">

**Author:** [@theRoss](https://developer.community.nhs.uk/u/theRoss)\
**Replies:** 2\
**Last updated:** [9 May 2025 14:19 UTC](https://developer.community.nhs.uk/t/ord-api-deprecation-timeline/5722 "2025-05-09T14:19:49Z")

</div>

The Choosing an Organisation Data Service API - NHS England Digital page says that the ORD API will be " withdrawn over the next 2 years", but doesn’t give any further information, or say when that 2 year timeframe start…

---

## [How can i find API's endpoints for development/testtin](https://developer.community.nhs.uk/t/how-can-i-find-apis-endpoints-for-development-testtin/5034)

<div class="topic-metadata">

**Author:** [@Assad\_Rehman](https://developer.community.nhs.uk/u/Assad_Rehman)\
**Replies:** 1\
**Last updated:** [18 March 2025 07:22 UTC](https://developer.community.nhs.uk/t/how-can-i-find-apis-endpoints-for-development-testtin/5034 "2025-03-18T07:22:57Z")

</div>

I am new here and want to consume Open Access APIs, Application Restricted APIs and User Restricted APIs in PHP Laravel for testing. If someone provide guide and steps i will appreciate. And also I am looking for endpoi…

---

## [Searching for particular relationships using FHIR API](https://developer.community.nhs.uk/t/searching-for-particular-relationships-using-fhir-api/3965)

<div class="topic-metadata">

**Author:** [@n.hepke1](https://developer.community.nhs.uk/u/n.hepke1)\
**Replies:** 2\
**Last updated:** [9 January 2025 14:59 UTC](https://developer.community.nhs.uk/t/searching-for-particular-relationships-using-fhir-api/3965 "2025-01-09T14:59:36Z")

</div>

Hi, I am trying to obtain all active relationships with a value of RE4 using the URL: https://sandbox.api.service.nhs.uk/organisation-data-terminology-api/fhir/OrganizationAffiliation?role=RE4&\_count=1000&active=true. I…

[Next page](https://developer.community.nhs.uk/c/ods/21.md?page=1)
