---
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/`

## Request

- Base URL: `https://api.monni.fyi` (the document declares no server; this is the origin it was published from)
- URL: `https://api.monni.fyi/dashboard/bot/settings/{guild_id}/moderation/cases/`
- Auth: HTTP bearer

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

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

---

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