---
title: "Changes to GET /v1/me"
method: GET
path: "/v1/me"
---

# Changes to GET /v1/me

`GET /v1/me`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 73 revisions.

- **2026-09-22** `fc4082ccc5c4`: 2 info
- **2026-01-14** `943444df31ae`: 1 info
- **2026-01-05** `729e8dc21397`: 1 info
- **2024-11-07** `173650e3e033`: 1 breaking, 16 warning
- **2024-10-23** `cb38754d8aef`: 1 warning, 1 info
- **2024-10-23** `842c9fcf282b`: 6 breaking, 12 info
- **2024-10-15** `ae0b97f44bd5`: 1 breaking, 5 info

## Changes

- **2026-09-22** `fc4082ccc5c4`: 2 info
  - added the required property `items/givenName` to the response with the `200` status
  - added the required property `items/surname` to the response with the `200` status
- **2026-01-14** `943444df31ae`: 1 info
  - added the optional property `items/strategicRoles` to the response with the `200` status
- **2026-01-05** `729e8dc21397`: 1 info
  - added the required property `items/jobTitle` to the response with the `200` status
- **2024-11-07** `173650e3e033`: 1 breaking, 16 warning
  - the response's body type changed from `object` to `array` for status `200`
  - removed the optional property `contactByEmail` from the response with the `200` status
  - removed the optional property `contactByPhone` from the response with the `200` status
  - removed the optional property `contactByPhoneTimeframe` from the response with the `200` status
  - removed the optional property `contactDetails` from the response with the `200` status
  - removed the optional property `displayName` from the response with the `200` status
  - removed the optional property `email` from the response with the `200` status
  - removed the optional property `firstTimeSignInAt` from the response with the `200` status
  - removed the optional property `hasInnovationCollaborations` from the response with the `200` status
  - removed the optional property `hasInnovationTransfers` from the response with the `200` status
  - removed the optional property `hasLoginAnnouncements` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `organisations` from the response with the `200` status
  - removed the optional property `passwordResetAt` from the response with the `200` status
  - removed the optional property `phone` from the response with the `200` status
  - removed the optional property `roles` from the response with the `200` status
  - removed the optional property `termsOfUseAccepted` from the response with the `200` status
- **2024-10-23** `cb38754d8aef`: 1 warning, 1 info
  - deleted the `path` request parameter `forceRefresh`
  - added the new optional `query` request parameter `forceRefresh`
- **2024-10-23** `842c9fcf282b`: 6 breaking, 12 info
  - the response property `contactByPhoneTimeframe` became nullable for the status `200`
  - the response property `contactDetails` became nullable for the status `200`
  - the response property `firstTimeSignInAt` became nullable for the status `200`
  - the response property `passwordResetAt` became nullable for the status `200`
  - the response property `phone` became nullable for the status `200`
  - the `roles/items/` response's property type changed from `string` to `object` for status `200`
  - added the optional property `organisations/items/acronym` to the response with the `200` status
  - added the optional property `organisations/items/description` to the response with the `200` status
  - added the optional property `organisations/items/id` to the response with the `200` status
  - added the optional property `organisations/items/isShadow` to the response with the `200` status
  - added the optional property `organisations/items/name` to the response with the `200` status
  - added the optional property `organisations/items/organisationUnits` to the response with the `200` status
  - added the optional property `organisations/items/registrationNumber` to the response with the `200` status
  - added the optional property `organisations/items/size` to the response with the `200` status
  - added the optional property `roles/items/id` to the response with the `200` status
  - added the optional property `roles/items/isActive` to the response with the `200` status
  - added the optional property `roles/items/organisation` to the response with the `200` status
  - added the optional property `roles/items/role` to the response with the `200` status
- **2024-10-15** `ae0b97f44bd5`: 1 breaking, 5 info
  - added the new path request parameter `forceRefresh`
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `500`

---

[Operation](https://skmtc.dev/nhs-england/apis/users-api-nhs-innovation-service/docs/v1/me/get.md) - [API](https://skmtc.dev/nhs-england/apis/users-api-nhs-innovation-service.md) - [Page](https://skmtc.dev/nhs-england/apis/users-api-nhs-innovation-service/changes/v1/me/get)
