---
title: "Get unread pop-ups"
method: GET
path: "/api/popups"
tags: ["popups"]
---

# Get unread pop-ups

`GET /api/popups`

Get all unread, non-expired pop-ups for the authenticated user. These pop-ups are shown when the user opens the app.

## Response `200`

Successful Response

- PopupsResponse — Response model for list of unread pop-ups.
  - `popups` PopupItem[], required — List of unread pop-ups
    - `id` string, uuid, required — Pop-up unique ID
    - `title` string, required — Pop-up title
    - `body` string, required — Pop-up body text (may contain links)
    - `popup_type` string, required — Pop-up type: info, warning, promo, update
    - `link_url` string, nullable — Optional CTA link URL
    - `link_label` string, nullable — Optional CTA link label
    - `priority` integer — Display priority (higher = shown first)
    - `popup_metadata` object, nullable — Optional extra metadata
    - `created_at` string, required — Creation timestamp ISO format
  - `total` integer, required — Total number of unread pop-ups

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)