---
title: "Retrieve announcements"
method: GET
path: "/api/v1/announcements"
tags: ["Announcements"]
---

# Retrieve announcements

`GET /api/v1/announcements`

Required role: **ADMIN**

## Response `200`

OK

- JsonFeedDto
  - `description` string — Provides more detail on what the feed is about
  - `home_page_url` string — URL of the resource that the feed describes
  - `items` ItemDto[], required
    - `_komga` KomgaExtensionDto — Additional fields for the item
      - `read` boolean, required — Whether the current item has been marked read by the current user
    - `author` ItemAuthorDto — Author of the item
      - `name` string — Author's name
      - `url` string — URL of a site owned by the author
    - `content_html` string — HTML of the item
    - `date_modified` string, date-time — Modification date in RFC 3339 format
    - `id` string, required — Unique for that item for that feed over time
    - `summary` string — A plain text sentence or two describing the item
    - `tags` string[], required — Tags describing the item
    - `title` string — Plain text title
    - `url` string — URL of the resource described by the item
  - `title` string, required — Name of the feed
  - `version` string, required — URL of the version of the format the feed uses

## Other responses

- `400` — Bad Request

---

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