---
title: "[Internal] Get the active announcement campaign"
method: GET
path: "/api/campaigns/active"
tags: ["Campaigns"]
---

# \[Internal\] Get the active announcement campaign

`GET /api/campaigns/active`

## Request

- Base URL: `https://api.typless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.typless.com/api/campaigns/active`
- Auth: none declared

Serve the active campaign, or 204 when none is running.
No `get_authorization_context` dependency: campaigns are global

## Query parameters

- `locale` string, nullable

## Response `200`

Successful Response

- ActiveCampaignResponse
  - `id` string, required
  - `title` string, required
  - `body` string, required
  - `cta_label` string, required
  - `cta_href` string, required
  - `image_url` string, nullable, required
  - `icon` string, required
  - `locale` string, required

## Other responses

- `204`: No campaign is currently active.
- `422`: Validation Error

---

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