---
title: "List Cases"
method: GET
path: "/dashboard/bot/settings/{guild_id}/moderation/cases/"
tags: ["dashboard"]
---

# List Cases

`GET /dashboard/bot/settings/{guild_id}/moderation/cases/`

Filtered, keyset-paginated case list.

## Path parameters

- `guild_id` integer, required

## Query parameters

- `q` string, nullable
- `type` string, nullable
- `state` string, nullable
- `target` string, nullable
- `actor_kind` string, nullable
- `limit` integer
- `cursor` string, nullable

## Response `200`

Successful Response

- CaseList
  - `cases` CaseSummary[], required
    - `case_id` string, required
    - `type` string, required
    - `state` string, required
    - `target_id` string, required
    - `target_name` string, nullable
    - `actor_id` string, required
    - `actor_name` string, nullable
    - `actor_kind` string, required
    - `reason` string, nullable
    - `duration` integer, nullable
    - `created_at` string, date-time, required
    - `origin_guild` string, nullable
    - `origin_case` string, nullable
    - `warn_active` boolean
  - `total` integer, required
  - `next_cursor` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-16** `83ac8f547df8` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-09** `0f647fa78ebf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/monni/apis/fastapi/changes/dashboard/bot/settings/:guild_id/moderation/cases/get.md)

---

[API](https://skmtc.dev/monni/apis/fastapi.md) · [All operations](https://skmtc.dev/monni/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/monni/apis/fastapi/revisions/2ec565e413a7?raw)