---
title: "GET /v1/users/{userIdOrEmail}"
method: GET
path: "/v1/users/{userIdOrEmail}"
tags: ["[v1] Admin Users"]
---

# GET /v1/users/{userIdOrEmail}

`GET /v1/users/{userIdOrEmail}`

Get user info.

## Path parameters

- `userIdOrEmail` union, required
  - string, uuid
  - string, email

## Response `200`

Success

- object
  - `id` string, uuid, required
  - `email` string, required
  - `name` string, required
  - `phone` string
  - `isActive` boolean, required
  - `jobTitle` string, nullable
  - `roles` object[]
    - `id` string, uuid, required
    - `role` 'ADMIN' | 'INNOVATOR' | 'ACCESSOR' | 'ASSESSMENT' | 'QUALIFYING_ACCESSOR'
    - `isActive` boolean, required
    - `organisation` object
      - `id` string, uuid, required
      - `name` string, required
      - `acronym` string, nullable, required
    - `organisationUnit` object
      - `id` string, uuid, required
      - `name` string, required
      - `acronym` string, required
    - `displayTeam` string
  - `strategicRoles` object[], required
    - `id` string, uuid, required
    - `role` 'CHAMPION' | 'SENIOR_SPONSOR', required

## Other responses

- `400` — The request is invalid.
- `401` — The user is not authenticated.
- `403` — The user is not authorized to access this resource.
- `500` — An error occurred while processing the request.

## Changes

- **2026-01-08** `1a84c9639e0b` — 1 info
  - added the required property `strategicRoles` to the response with the `200` status
- **2026-01-01** `aeb173b7f5b1` — 1 info
  - added the optional property `jobTitle` to the response with the `200` status
- **2024-11-08** `62a90ce96852` — 1 breaking
  - the `path` request parameter `userIdOrEmail` became required
- **2024-11-07** `bf0b42ebdc02` — 9 info
  - the `path` request parameter `userIdOrEmail` became optional
  - added the optional property `roles/items/organisation` to the response with the `200` status
  - added the optional property `roles/items/organisationUnit` to the response with the `200` status
  - the response property `email` became required for the status `200`
  - …5 more
- **2023-08-11** `0335d130db4e` — 1 breaking
  - the `path` request parameter `userIdOrEmail` became required

[Change history](https://skmtc.dev/nhs/apis/admin-api-nhs-innovation-service/changes/v1/users/:userIdOrEmail/get.md)

---

[API](https://skmtc.dev/nhs/apis/admin-api-nhs-innovation-service.md) · [All operations](https://skmtc.dev/nhs/apis/admin-api-nhs-innovation-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nhs/admin-api-nhs-innovation-service/revisions/e3ae090557ab/schema)