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

# List Tournament Cycles

`GET /api/v3/tournaments/cycles`

## Request

- Base URL: `https://dev-api.genji.pk`
- URL: `https://dev-api.genji.pk/api/v3/tournaments/cycles`
- Auth: none declared

## 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.dev/genji/apis/genji-shimada-api-2.md) - [All operations](https://skmtc.dev/genji/apis/genji-shimada-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/genji/apis/genji-shimada-api-2/revisions/a31661684eee?raw)