---
title: "List live notices"
method: GET
path: "/api/v1/announcements"
tags: ["Service notices"]
---

# List live notices

`GET /api/v1/announcements`

## Request

- Base URL: `https://hproxy.com`
- URL: `https://hproxy.com/api/v1/announcements`
- Auth: API key in header `X-API-Key`

Every published notice addressed to an audience your account belongs to, newest first, at most 50. Accepts **any** valid key (no scope needed). Poll it once an hour at most: it is not a queue, and nothing is lost by polling less. Branch on `kind`.

## Query parameters

- `kind` string
- `audience` string
- `publishedAt, expiresAt` string
- `linkHref, linkLabel` string
- `unread` boolean

## Response `200`

Success

- object

## Other responses

- `400`: Invalid input. The body names the field and the accepted set.
- `401`: Missing or invalid API key.
- `429`: Rate limited. Retry after the delay in the response.

---

[API](https://skmtc.dev/hproxy/apis/hproxy-api.md) · [All operations](https://skmtc.dev/hproxy/apis/hproxy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hproxy/apis/hproxy-api/revisions/9f6898fe76e2?raw)