---
title: "List Competitions"
method: GET
path: "/leaderboard/competitions"
tags: ["leaderboard"]
---

# List Competitions

`GET /leaderboard/competitions`

List all active competition datasets with their top scores.

Args:
    auth: Authenticated caller.
    include_samples: If True, fetch sample rows from S3 for preview.
        Defaults to False for fast loading.

Returns:
    Every competition dataset with its current winner, entry count and
    optionally a few sample rows for preview.

Raises:
    HTTPException: 500 when the competitions cannot be read.

## Query parameters

- `include_samples` boolean

## Response `200`

Successful Response

- CompetitionsResponse — Response listing all active competitions.
  - `success` boolean
  - `competitions` CompetitionInfo[], required
    - `dataset_id` string, required
    - `dataset_name` string, required
    - `dataset_type` string, required
    - `description` string, nullable — Description of the competition task
    - `sample_count` integer, nullable
    - `labels` string[], nullable
    - `sample_rows` object[], nullable — Preview of a few sample rows from the dataset
    - `winner` LeaderboardEntry — A single leaderboard entry.
      - `id` string, required
      - `dataset_id` string, required
      - `evaluation_id` string, required
      - `user_id` string, required
      - `display_name` string, required
      - `model_name` string, required
      - `model_id` string, nullable
      - `f1_score` number, required
      - `precision_score` number, nullable
      - `recall_score` number, nullable
      - `accuracy` number, nullable
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `rank` integer, nullable
    - `total_entries` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/versions/31dfe831e079/schema)