---
title: "List all announcements (admin)"
method: GET
path: "/announcements/admin"
tags: ["announcements"]
---

# List all announcements (admin)

`GET /announcements/admin`

## Request

- Base URL: `https://api.focusbear.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.focusbear.io/announcements/admin`
- Auth: HTTP bearer

Paginated list of every announcement (including expired) for the admin dashboard, with optional filters

## Query parameters

- `order` 'ASC' | 'DESC'
- `page` number
- `take` number
- `type` 'release' | 'event' | 'survey' | 'maintenance'
- `priority` 'low' | 'medium' | 'high' | 'critical'
- `operating_system` 'all' | 'ios' | 'android' | 'mac' | 'windows' | 'web' | 'unknown'
- `include_expired` boolean
- `search` string

## Response `200`

Successfully retrieved announcements

- ListAnnouncementsResponseDto
  - `data` AnnouncementEntity[], required: Announcements for the requested page
    - `id` string, required
    - `type` 'release' | 'event' | 'survey' | 'maintenance', required
    - `heading` string, required
    - `details` string, required
    - `details_url` string
    - `expiry_date` string, required
    - `priority` 'low' | 'medium' | 'high' | 'critical', required
    - `operating_system` 'all' | 'ios' | 'android' | 'mac' | 'windows' | 'web' | 'unknown', required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `meta` PaginationMetaDto, required
    - `page` number, required
    - `take` number, required
    - `order` 'ASC' | 'DESC', required
    - `itemCount` number, required
    - `pageCount` number, required
    - `hasPreviousPage` boolean, required
    - `hasNextPage` boolean, required

## Other responses

- `401`: Unauthorized - invalid or missing authentication token

---

[API](https://skmtc.dev/focusbear/apis/focusbear-api.md) - [All operations](https://skmtc.dev/focusbear/apis/focusbear-api/llms.txt) - [OpenAPI document](https://skmtc.dev/focusbear/apis/focusbear-api/revisions/3a83a3b9a811?raw)