---
title: "Get Binairo Leaderboard"
method: GET
path: "/binairo/leaderboard"
tags: ["Binairo"]
---

# Get Binairo Leaderboard

`GET /binairo/leaderboard`

Get the leaderboard for a specific board size, sorted by fastest time.

## Query parameters

- `board_size` integer

## Response `200`

Successful Response

- RoutersBinairoLeaderboardResponse
  - `entries` LeaderboardEntry[], required
    - `display_name` string, required
    - `board_size` integer, required
    - `time_seconds` number, required
    - `rank` integer, required
    - `is_current_user` boolean
  - `current_user_entry` LeaderboardEntry — A leaderboard row as it leaves the API. ``display_name`` is the caller's own name on their own row and an anonymous ``Joueur #<rank>`` placeholder on everybody else's: players never consented to having their name shown to the other teachers on the board. No user identifier is exposed either, so a client cannot re-identify a row.
    - `display_name` string, required
    - `board_size` integer, required
    - `time_seconds` number, required
    - `rank` integer, required
    - `is_current_user` boolean

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-09** `a5af9b3b34f7` — 4 breaking
  - removed the required property `current_user_entry/anyOf[subschema #1: LeaderboardEntry]/submitted_at` from the response with the `200` status
  - removed the required property `current_user_entry/anyOf[subschema #1: LeaderboardEntry]/user_id` from the response with the `200` status
  - removed the required property `entries/items/submitted_at` from the response with the `200` status
  - removed the required property `entries/items/user_id` from the response with the `200` status

[Change history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/binairo/leaderboard/get.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/a5af9b3b34f7?raw)