# Healthcare Worker API

**URL:** https://developer.community.nhs.uk/c/healthcare-worker-api/70.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 Healthcare Worker API category](https://developer.community.nhs.uk/t/about-the-healthcare-worker-api-category/11762)

<div class="topic-metadata">

**Author:** [@akunna.ndubuisi1](https://developer.community.nhs.uk/u/akunna.ndubuisi1)\
**Replies:** 0\
**Last updated:** [21 April 2026 10:49 UTC](https://developer.community.nhs.uk/t/about-the-healthcare-worker-api-category/11762 "2026-04-21T10:49:32Z")

</div>

Queries and announcements related to the Healthcare Worker FHIR API.

---

## [Healthcare Worker FHIR API - professional registration IDs added](https://developer.community.nhs.uk/t/healthcare-worker-fhir-api-professional-registration-ids-added/15116)

<div class="topic-metadata">

**Author:** [@tony.heap](https://developer.community.nhs.uk/u/tony.heap)\
**Replies:** 1\
**Last updated:** [19 September 2026 15:59 UTC](https://developer.community.nhs.uk/t/healthcare-worker-fhir-api-professional-registration-ids-added/15116 "2026-09-19T15:59:08Z")

</div>

We’ve enhanced the Healthcare Worker FHIR API to include various professional registration IDs. Specifically, you can now get the following: GMC number consultant code Doctor’s Index Number GMP code You can’t search …

---

## [Healthcare Worker FHIR API - enhanced sandbox](https://developer.community.nhs.uk/t/healthcare-worker-fhir-api-enhanced-sandbox/15115)

<div class="topic-metadata">

**Author:** [@tony.heap](https://developer.community.nhs.uk/u/tony.heap)\
**Replies:** 0\
**Last updated:** [14 September 2026 09:47 UTC](https://developer.community.nhs.uk/t/healthcare-worker-fhir-api-enhanced-sandbox/15115 "2026-09-14T09:47:20Z")

</div>

We’ve made some improvements to the Healthcare Worker FHIR API sandbox environment. Our sandbox environment: is for early developer testing only covers a limited set of scenarios is open-access, so does not allow you …

---

## [Minor breaking change - 200 response if no matches](https://developer.community.nhs.uk/t/minor-breaking-change-200-response-if-no-matches/13744)

<div class="topic-metadata">

**Author:** [@tony.heap](https://developer.community.nhs.uk/u/tony.heap)\
**Replies:** 2\
**Last updated:** [2 September 2026 08:05 UTC](https://developer.community.nhs.uk/t/minor-breaking-change-200-response-if-no-matches/13744 "2026-09-02T08:05:21Z")

</div>

This is an advance warning of a minor breaking change we’re planning to make to the Healthcare Worker (HCW) FHIR API. Currently, when you search for a healthcare worker, or for healthcare worker roles: if there is no …

---

## [PractitionerRole.fullURL missing \`/\`](https://developer.community.nhs.uk/t/practitionerrole-fullurl-missing/14489)

<div class="topic-metadata">

**Author:** [@david.hamill1](https://developer.community.nhs.uk/u/david.hamill1)\
**Replies:** 4\
**Last updated:** [25 August 2026 09:47 UTC](https://developer.community.nhs.uk/t/practitionerrole-fullurl-missing/14489 "2026-08-25T09:47:37Z")

</div>

Hi, More of an FYI, than a question. The response bundle for a PractitionerRole search has a malformed URL. "fullUrl": "https://int.api.service.nhs.uk/healthcare-workerPractitionerRole/555085026102" The above Practit…

---

## [\_include org for PractionerRole endpoint](https://developer.community.nhs.uk/t/include-org-for-practionerrole-endpoint/14466)

<div class="topic-metadata">

**Author:** [@david.hamill1](https://developer.community.nhs.uk/u/david.hamill1)\
**Replies:** 0\
**Last updated:** [18 August 2026 21:03 UTC](https://developer.community.nhs.uk/t/include-org-for-practionerrole-endpoint/14466 "2026-08-18T21:03:12Z")

</div>

Hi, If the PractitionerRole resource returned in the GET /PractitionerRole response bundle contains a reference to the Organisation under which that role is performed, what additional details does a response for the sam…

---

## [Minor breaking change - separate given names](https://developer.community.nhs.uk/t/minor-breaking-change-separate-given-names/12973)

<div class="topic-metadata">

**Author:** [@tony.heap](https://developer.community.nhs.uk/u/tony.heap)\
**Replies:** 0\
**Last updated:** [23 June 2026 12:24 UTC](https://developer.community.nhs.uk/t/minor-breaking-change-separate-given-names/12973 "2026-06-23T12:24:16Z")

</div>

This is an advance warning of a minor breaking change we’re planning to make to the Healthcare Worker (HCW) FHIR API. We’re planning to change to the way we return healthcare worker names from the API. Currently, they …

---

## [Given name in Healthcare Worker API](https://developer.community.nhs.uk/t/given-name-in-healthcare-worker-api/12373)

<div class="topic-metadata">

**Author:** [@Bob\_Walker](https://developer.community.nhs.uk/u/Bob_Walker)\
**Replies:** 6\
**Last updated:** [15 June 2026 10:35 UTC](https://developer.community.nhs.uk/t/given-name-in-healthcare-worker-api/12373 "2026-06-15T10:35:04Z")

</div>

https://digital.nhs.uk/developer/api-catalogue/healthcare-worker-fhir#get-/Practitioner The docs given an example of a Practitioner given name as: "given": \[ "Jane Allison" \] Is this right? Why is it a list if the…

---

## [Health Practitioner API (plans)?](https://developer.community.nhs.uk/t/health-practitioner-api-plans/12189)

<div class="topic-metadata">

**Author:** [@Kevin\_Mayfield](https://developer.community.nhs.uk/u/Kevin_Mayfield)\
**Replies:** 2\
**Last updated:** [3 June 2026 06:02 UTC](https://developer.community.nhs.uk/t/health-practitioner-api-plans/12189 "2026-06-03T06:02:19Z")

</div>

I’m working on a regional integration project and I’d like to query health practitioner details (in Spine or ODS). We are already doing this with other care directory APIM services such as PDS (for Patient NHS Number ide…

---

## [Way to Search for Healthcare Worker?](https://developer.community.nhs.uk/t/way-to-search-for-healthcare-worker/11904)

<div class="topic-metadata">

**Author:** [@Jason\_chung](https://developer.community.nhs.uk/u/Jason_chung)\
**Replies:** 2\
**Last updated:** [29 May 2026 13:54 UTC](https://developer.community.nhs.uk/t/way-to-search-for-healthcare-worker/11904 "2026-05-29T13:54:57Z")

</div>

Hello, I was wondering if there was a way to search healthcare workers by name, prefix, or other basic information? I noticed that the Healthcare Worker API only supported lookups using the CIS identifier (unique UUID f…

---

## [Standard test data now available in the integration environment for the Healthcare Worker API](https://developer.community.nhs.uk/t/standard-test-data-now-available-in-the-integration-environment-for-the-healthcare-worker-api/11765)

<div class="topic-metadata">

**Author:** [@tony.heap](https://developer.community.nhs.uk/u/tony.heap)\
**Replies:** 0\
**Last updated:** [21 April 2026 13:51 UTC](https://developer.community.nhs.uk/t/standard-test-data-now-available-in-the-integration-environment-for-the-healthcare-worker-api/11765 "2026-04-21T13:51:47Z")

</div>

To make testing easier, we’ve set up some standard test data in our integration environment that you can use when testing the Healthcare Worker API. For details, see https://digital.nhs.uk/developer/api-catalogue/health…

---

## [Healthcare Worker - FHIR API](https://developer.community.nhs.uk/t/healthcare-worker-fhir-api/5701)

<div class="topic-metadata">

**Author:** [@gareth.perkins](https://developer.community.nhs.uk/u/gareth.perkins)\
**Replies:** 17\
**Last updated:** [16 March 2026 16:05 UTC](https://developer.community.nhs.uk/t/healthcare-worker-fhir-api/5701 "2026-03-16T16:05:01Z")

</div>

Is the Healthcare worker API available for testing on the INT environment? I’ve followed the documentation but when making a request in the format below, which I believe is correct, I get a 404 response with no content. …
