# API to look-up username and role from UUID

**URL:** <https://developer.community.nhs.uk/t/api-to-look-up-username-and-role-from-uuid/4150>\
**Category:** e-Referral Service (e-RS)\
**Created:** [21 January 2025 14:29 UTC](https://developer.community.nhs.uk/t/api-to-look-up-username-and-role-from-uuid/4150 "2025-01-21T14:29:57Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![product1](https://avatars.discourse-cdn.com/v4/letter/p/9de053/32.png) [@product1](https://developer.community.nhs.uk/u/product1)\
**Post date:** [21 January 2025 14:29 UTC](https://developer.community.nhs.uk/t/api-to-look-up-username-and-role-from-uuid/4150/1 "2025-01-21T14:29:57Z")

</div>

Hello, is there an API to look up an individual’s name and role when their UUID is know?

Thank you.

---

<div class="post-metadata">

**Author:** ![adam.oldfield](https://dub1.discourse-cdn.com/nhsdigitaldeveloper/user_avatar/developer.community.nhs.uk/adam.oldfield/32/327_2.png) [@adam.oldfield](https://developer.community.nhs.uk/u/adam.oldfield)\
**Post date:** [22 January 2025 10:03 UTC](https://developer.community.nhs.uk/t/api-to-look-up-username-and-role-from-uuid/4150/2 "2025-01-22T10:03:31Z")

</div>

Hhi @product1,

This is not functionally offered by the e-RS as the data is not owned by us.

For user and role information I think you would need to use [Spine Directory Service - LDAP API](https://digital.nhs.uk/developer/api-catalogue/spine-directory-service-ldap).

There is also a new FHIR based API (that is still in Alpha) that allows you to retrieve basic Healthcare Worker information: [Healthcare Worker - FHIR API](https://digital.nhs.uk/developer/api-catalogue/healthcare-fhir-api).

You would be best contacting the related teams for further information.

Regards,

Adam.

---

<div class="post-metadata">

**Author:** ![product1](https://avatars.discourse-cdn.com/v4/letter/p/9de053/32.png) [@product1](https://developer.community.nhs.uk/u/product1)\
**Post date:** [23 January 2025 21:03 UTC](https://developer.community.nhs.uk/t/api-to-look-up-username-and-role-from-uuid/4150/3 "2025-01-23T21:03:28Z")

</div>

Thank you Adam! That is very helpful.

---

<div class="post-metadata">

**Author:** ![Catherine](https://avatars.discourse-cdn.com/v4/letter/c/c67d28/32.png) [@Catherine](https://developer.community.nhs.uk/u/Catherine)\
**Post date:** [4 February 2025 15:27 UTC](https://developer.community.nhs.uk/t/api-to-look-up-username-and-role-from-uuid/4150/4 "2025-02-04T15:27:18Z")

</div>

Hello Adam and  
Please contact [Catherine.Ejiogu1@nhs.net](mailto:Catherine.Ejiogu1@nhs.net) via email to discuss Healthcare worker look up using UUID. The app is called Healthcare worker api should be going live in March. Keen to hear from you.  
Thanks  
Catherine

---

<div class="post-metadata">

**Author:** ![zubeir.tai](https://dub1.discourse-cdn.com/nhsdigitaldeveloper/user_avatar/developer.community.nhs.uk/zubeir.tai/32/413_2.png) [@zubeir.tai](https://developer.community.nhs.uk/u/zubeir.tai)\
**Post date:** [5 February 2025 09:34 UTC](https://developer.community.nhs.uk/t/api-to-look-up-username-and-role-from-uuid/4150/5 "2025-02-05T09:34:26Z")

</div>

Thank you @Catherine, great work in delivering this API.

@product1 please reach out to Catherine if the HCW API is of interest to you.

Thanks,  
Z.

---

<div class="post-metadata">

**Author:** ![tony.heap](https://dub1.discourse-cdn.com/nhsdigitaldeveloper/user_avatar/developer.community.nhs.uk/tony.heap/32/47_2.png) [@tony.heap](https://developer.community.nhs.uk/u/tony.heap)\
**Post date:** [29 April 2026 12:10 UTC](https://developer.community.nhs.uk/t/api-to-look-up-username-and-role-from-uuid/4150/6 "2026-04-29T12:10:38Z")

</div>

Although Catherine Ejiogu is no longer working on it, the Healthcare Worker API is now available for use - see [https://digital.nhs.uk/developer/api-catalogue/healthcare-worker-fhir](https://digital.nhs.uk/developer/api-catalogue/healthcare-worker-fhir) for details.

---

<div class="post-metadata">

**Author:** ![Jason\_chung](https://avatars.discourse-cdn.com/v4/letter/j/c2a13f/32.png) [@Jason\_chung](https://developer.community.nhs.uk/u/Jason_chung)\
**Post date:** [29 April 2026 14:35 UTC](https://developer.community.nhs.uk/t/api-to-look-up-username-and-role-from-uuid/4150/7 "2026-04-29T14:35:46Z")

</div>

What if their UUID is not known? There seems to be no way to search for a worker’s UUID (or even know if they exist) based on their name, prefix, etc.
