---
title: "Get Leaderboard Entries"
method: GET
path: "/leaderboard/datasets/{dataset_id}/entries"
tags: ["leaderboard"]
---

# Get Leaderboard Entries

`GET /leaderboard/datasets/{dataset_id}/entries`

Get top leaderboard entries for a competition dataset.

Args:
    dataset_id: Competition dataset.
    auth: Authenticated caller.
    limit: Maximum entries to return.

Returns:
    Entries sorted by F1 score in descending order.

Raises:
    HTTPException: 404 when the dataset is not visible, 400 when it is not a
        competition, 500 when the entries cannot be read.

## Path parameters

- `dataset_id` string, required

## Query parameters

- `limit` integer — Number of entries to return

## Response `200`

Successful Response

- LeaderboardEntriesResponse — Response containing leaderboard entries.
  - `success` boolean
  - `dataset_id` string, required
  - `dataset_name` string, required
  - `entries` LeaderboardEntry[], required
    - `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, required

## 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/revisions/31dfe831e079/schema)