---
title: "Queries all leaderboards for the given benchmark."
method: GET
path: "/benchmark/{benchmarkId}/leaderboards"
tags: ["Benchmark"]
---

# Queries all leaderboards for the given benchmark.

`GET /benchmark/{benchmarkId}/leaderboards`

## Path parameters

- `benchmarkId` string, required

## Query parameters

- `page` integer
- `page_size` integer
- `sort` string[]
- `id` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `name` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `logic` 'and' | 'or'

## Response `200`

OK

- QueryLeaderboardsByBenchmarkEndpointPagedResultOfOutput
  - `total` integer, required
  - `page` integer, required
  - `pageSize` integer, required
  - `items` QueryLeaderboardsByBenchmarkEndpointOutput[], required
    - `id` string, required — The unique identifier of the leaderboard.
    - `name` string, required — The name of the leaderboard.
    - `instruction` string, required — The instruction shown on the leaderboard.
    - `showPrompt` boolean, required — Whether the prompt text is shown.
    - `showPromptAsset` boolean, required — Whether the prompt asset is shown.
    - `isInversed` boolean, required — Whether the leaderboard's scoring is inversed.
    - `responseBudget` integer, required — The response budget for the leaderboard.
    - `minResponses` integer, required — The minimum number of responses for the leaderboard.
    - `audienceId` string, required — The id of the audience assigned to the leaderboard.
    - `jobDefinitionId` string, nullable — The id of the job definition assigned to the leaderboard, if any.
    - `featureFlags` FeatureFlag[], required — The feature flags enabled for the leaderboard.
      - `key` string, required
      - `value` string, required
    - `weight` number, double, required — Multiplier applied to every match result from this leaderboard when it contributes to the parent benchmark's overall / combined scoreboards.
    - `scoreShift` number, double, required — Additive offset applied to displayed scores on this leaderboard's per-leaderboard scoreboard.
    - `scoreScale` number, double, required — Multiplicative factor applied to displayed scores (relative to the Bradley-Terry center) on this leaderboard's per-leaderboard scoreboard.
    - `isHidden` boolean, required — Whether the leaderboard is hidden in listings and reads for non-admins.
    - `isExcludedFromOverall` boolean, required — Whether the leaderboard is excluded from its benchmark's overall / combined scoreboard, making it an owner-only private experiment.
    - `includedTags` string[], required — Prompt tag values the leaderboard restricts its matchups to. Empty means no restriction.
    - `excludedTags` string[], required — Prompt tag values the leaderboard never creates matchups for. Takes precedence over includedTags.
  - `totalPages` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

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