# ODS FHIR Terminology API

**URL:** <https://developer.community.nhs.uk/t/ods-fhir-terminology-api/2810>\
**Category:** Organisation Data Service (ODS)\
**Tags:** fhir\
**Created:** [21 October 2024 14:51 UTC](https://developer.community.nhs.uk/t/ods-fhir-terminology-api/2810 "2024-10-21T14:51:31Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![james.lloyd](https://avatars.discourse-cdn.com/v4/letter/j/5f8ce5/32.png) [@james.lloyd](https://developer.community.nhs.uk/u/james.lloyd)\
**Post date:** [21 October 2024 14:51 UTC](https://developer.community.nhs.uk/t/ods-fhir-terminology-api/2810/1 "2024-10-21T14:51:31Z")

</div>

Hello, I’ve started looking at the new Organisation Data Terminology - FHIR API (R4).

The documents here [https://digital.nhs.uk/developer/api-catalogue/organisation-data-terminology](https://digital.nhs.uk/developer/api-catalogue/organisation-data-terminology) mention a \_revinclude parameter to expand the resultset to include Relationships. Unfortunately it doesn’t mention what the parameter value should be.

I’ve tried the usual “true”, 1, “yes” etc.

Any ideas?

---

<div class="post-metadata">

**Author:** ![laura.reeves](https://avatars.discourse-cdn.com/v4/letter/l/d26b3c/32.png) [@laura.reeves](https://developer.community.nhs.uk/u/laura.reeves)\
**Post date:** [21 October 2024 15:42 UTC](https://developer.community.nhs.uk/t/ods-fhir-terminology-api/2810/2 "2024-10-21T15:42:52Z")

</div>

Hi James

We can share a couple examples of the use of revinclude:

This call returns Organization information for A81060 along with all relationships where it appears as the “primary-organization”.

[https://api.service.nhs.uk/organisation-data-terminology-api/fhir/Organization?identifier=A81060&\_revinclude=OrganizationAffiliation:primary-organization](https://gbr01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fapi.service.nhs.uk%2Forganisation-data-terminology-api%2Ffhir%2FOrganization%3Fidentifier%3DA81060%26_revinclude%3DOrganizationAffiliation%3Aprimary-organization&data=05%7C02%7Claura.reeves%40nhs.net%7C2c19289b14104286622908dcf1e46a16%7C37c354b285b047f5b22207b48d774ee3%7C0%7C0%7C638651210530532057%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C0%7C%7C%7C&sdata=EWrZD5uXmWWe2UYVSIB1Wh1oMLLn5yZseIKaqnmQLTE%3D&reserved=0)

And this call returns the Organization information for A81060 along with all relationships where it appears as a “participating-organization”.

[https://api.service.nhs.uk/organisation-data-terminology-api/fhir/Organization?identifier=A81060&\_revinclude=OrganizationAffiliation:participating-organization](https://gbr01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fapi.service.nhs.uk%2Forganisation-data-terminology-api%2Ffhir%2FOrganization%3Fidentifier%3DA81060%26_revinclude%3DOrganizationAffiliation%3Aparticipating-organization&data=05%7C02%7Claura.reeves%40nhs.net%7C2c19289b14104286622908dcf1e46a16%7C37c354b285b047f5b22207b48d774ee3%7C0%7C0%7C638651210530607364%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C0%7C%7C%7C&sdata=PR9QSzrt%2Fb5KGdAuPOAq6%2FAsX3%2BDo%2BzlRuOl9qCuoOk%3D&reserved=0)

Do they help?  
Thanks  
Laura