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

# Get Announcements

`GET /announcements/`

取得校內每個處室的所有公告資訊。
資料來源：各處室網站

## Query parameters

- `department` string — 部門名稱。請透過 `/announcements/lists/departments` 取得完整列表。
- `title` string — 公告標題關鍵字
- `language` 'zh-tw' | 'en'
- `fuzzy` boolean — 是否進行模糊搜尋，若不啟用則必須完全符合（不建議）

## Response `200`

Successful Response

- AnnouncementDetail[]
  - `title` string, required — 佈告欄標題
  - `link` string, uri, required — 佈告欄連結
  - `language` string, required — 佈告欄語言
  - `department` string, required — 發布部門
  - `articles` AnnouncementArticle[], required — 公告列表
    - `title` string, nullable, required — 公告標題
    - `link` string, uri, nullable, required — 公告連結
    - `date` string, nullable — 公告日期 (YYYY-MM-DD)

## Other responses

- `422` — Validation Error

---

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