---
title: "List Tournament Cycles"
method: GET
path: "/api/v3/tournaments/cycles"
tags: ["Tournaments"]
---

# List Tournament Cycles

`GET /api/v3/tournaments/cycles`

## Query parameters

- `status` string, nullable — Filter by cycle status
- `category_id` integer, nullable — Filter by category ID
- `limit` integer — Max results
- `offset` integer — Result offset

## Response `200`

Request fulfilled, document follows

- TournamentCycleListResponse
  - `total` integer, required
  - `cycles` TournamentCycleWithWinnerResponse[], required
    - `id` integer, required
    - `category_id` integer, required
    - `map_id` integer, required
    - `map_code` string, required
    - `map_name` string, required
    - `map_difficulty` string, required
    - `status` 'pending' | 'active' | 'finalizing' | 'completed', required
    - `started_at` string, date-time, nullable
    - `ended_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `winner_name` string, nullable
    - `winner_user_id` integer, nullable

## Other responses

- `400` — Bad request syntax or unsupported method

---

[API](https://skmtc.net/genji/apis/genji-shimada-api.md) · [All operations](https://skmtc.net/genji/apis/genji-shimada-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genji/genji-shimada-api/revisions/8d8731ebc592/schema)