---
title: "GET /v1/me/announcements"
method: GET
path: "/v1/me/announcements"
tags: ["[v1] Announcements"]
---

# GET /v1/me/announcements

`GET /v1/me/announcements`

## Request

- Base URL: `https://nhse-${ENV}-innovation-service-user-functions.azurewebsites.net/api`
- URL: `https://nhse-${ENV}-innovation-service-user-functions.azurewebsites.net/api/v1/me/announcements`
- Auth: none declared

Returns unread announcements

## Query parameters

- `type` string[]
- `innovationId` string, uuid

## Response `200`

Success

- object[]
  - `id` string, uuid, required
  - `title` string, required
  - `startsAt` string, date-time, required
  - `expiresAt` string, date-time, nullable
  - `params` object, nullable
    - `content` string, required
    - `link` object
      - `label` string, required
      - `url` string, required

## Changes

- **2024-11-07** `173650e3e033`: 1 breaking, 2 warning, 6 info
  - the response property `items/params` became nullable for the status `200`
  - removed the optional property `items/createdAt` from the response with the `200` status
  - removed the optional property `items/userRoles` from the response with the `200` status
  - added the optional property `items/expiresAt` to the response with the `200` status
  - …5 more
- **2024-09-03** `a688d85b9942`: 1 warning, 2 info
  - deleted the `query` request parameter `filters`
  - added the new optional `query` request parameter `innovationId`
  - added the new optional `query` request parameter `type`
- **2024-08-21** `d7950e8073e5`: 1 warning
  - removed the optional property `items/template` from the response with the `200` status
- **2024-08-20** `ccff4e78f11a`: 3 warning, 1 info
  - added the new `DEPRECATED` enum value to the `items/template` response property for the response status `200`
  - added the new `FILTERED` enum value to the `items/template` response property for the response status `200`
  - added the new `GENERIC` enum value to the `items/template` response property for the response status `200`
  - removed the `0` enum value from the `items/template` response property for the response status `200`
- **2024-08-19** `7b6d475f7a1f`: 1 breaking
  - added the new required `query` request parameter `filters`

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

---

[API](https://skmtc.dev/nhs-england/apis/users-api-nhs-innovation-service.md) - [All operations](https://skmtc.dev/nhs-england/apis/users-api-nhs-innovation-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nhs-england/apis/users-api-nhs-innovation-service/revisions/4c818edd79bf?raw)