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

# Get Binairo School Leaderboard

`GET /binairo/leaderboard/schools`

Get school leaderboard: average best time per establishment.

No role filter here, unlike the individual board: `school_id` is resolved
from `school_memberships`, which only teachers and admins ever have, so the
aggregation is staff-only by construction. The tab is hidden client-side for
everyone else.

## Query parameters

- `board_size` integer

## Response `200`

Successful Response

- SchoolLeaderboardResponse
  - `entries` SchoolLeaderboardEntry[], required
    - `school_id` string, required
    - `school_name` string, required
    - `avg_time_seconds` number, required
    - `player_count` integer, required
    - `rank` integer, required
    - `is_current_user_school` boolean
  - `current_school_entry` SchoolLeaderboardEntry
    - `school_id` string, required
    - `school_name` string, required
    - `avg_time_seconds` number, required
    - `player_count` integer, required
    - `rank` integer, required
    - `is_current_user_school` boolean

## Other responses

- `422` — Validation Error

---

[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/b73d9bd491c3?raw)