---
title: "Get notices"
method: GET
path: "/v1/notices"
tags: ["notices"]
---

# Get notices

`GET /v1/notices`

Get a list of notices that match the filters, ordered by the last-repeated time.

## Query parameters

- `user-id` integer
- `users` 'all'
- `types` string[]
- `keys` string[]
- `after` string, date-time
- `timeout` string, duration

## Response `200`

Notices successfully retrieved.

- GetNoticesResponse
  - `type` string — Response type, "sync".
  - `status-code` integer — HTTP response status code.
  - `status` string — The description of the HTTP status code. See the [IANA list](https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml).
  - `result` Notice[]
    - `id` string — Server-generated unique ID for the notice.
    - `user-id` integer, nullable — The user ID associated with the notice (null for public notices).
    - `type` 'change-update' | 'custom' | 'warning' — The type of the notice (e.g., "custom").
    - `key` string — The key that differentiates notices of the same type.
    - `first-occurred` string, date-time — The first [time](#time) this notice occurred.
    - `last-occurred` string, date-time — The last [time](#time) this notice occurred.
    - `last-repeated` string, date-time — The last [time](#time) this notice was repeated.
    - `occurrences` integer — The number of times this notice has occurred.
    - `last-data` object — Additional data from the last occurrence.
    - `repeat-after` string, duration — [Duration](#duration) after last repeat before allowing another repeat.
    - `expire-after` string, duration — [Duration](#duration) after last occurrence before the notice expires.

## Changes

- **2025-01-13** `20135041d803` — 1 warning, 2 info
  - removed the optional property `allOf[subschema #2]/result/items/user_id` from the response with the `200` status
  - for the `query` request parameter `user-id`, the type/format was generalized from `integer`/`int32` to `integer`/``
  - added the optional property `allOf[subschema #2]/result/items/user-id` to the response with the `200` status
- **2025-01-02** `1cb37312be6c` — 1 info
  - endpoint added
- **2024-12-22** `b3903318c3bd` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/canonical/apis/pebble-api/changes/v1/notices/get.md)

---

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