---
title: "Retrieve a broadcast message"
method: GET
path: "/api/v4/broadcast_messages/{id}"
tags: ["broadcast_messages"]
---

# Retrieve a broadcast message

`GET /api/v4/broadcast_messages/{id}`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/broadcast_messages/{id}`
- Auth: none declared

Retrieves a specified broadcast message.

## Path parameters

- `id` integer, required

## Response `200`

Retrieve a broadcast message

- APIEntitiesSystemBroadcastMessage: API_Entities_System_BroadcastMessage model
  - `id` integer, required
  - `message` string, required
  - `starts_at` string, date-time, required
  - `ends_at` string, date-time, required
  - `color` string, required
  - `font` string, required
  - `target_access_levels` unknown[], required
    - unknown
  - `target_path` string, required
  - `broadcast_type` string, required
  - `theme` string, required
  - `dismissable` boolean, required
  - `active` boolean, required

---

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