---
title: "Get active announcements"
method: GET
path: "/announcements"
tags: ["announcements"]
---

# Get active announcements

`GET /announcements`

## 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`
- Auth: HTTP bearer

Retrieve active, unread announcements for the authenticated user filtered by operating system

## Query parameters

- `os_name` 'ios' | 'android' | 'mac' | 'windows' | 'web' | 'unknown', required

## Response `200`

Successfully retrieved announcements

- GetAnnouncementsResponseDto
  - `announcements` AnnouncementEntity[], required: List of active, unread announcements for the user
    - `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

## Other responses

- `400`: Invalid operating system parameter
- `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)