---
title: "Queries all leaderboards accessible to the current user."
method: GET
path: "/leaderboards"
tags: ["Leaderboard"]
---

# Queries all leaderboards accessible to the current user.

`GET /leaderboards`

## 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
- `benchmark_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
- `created_at` 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

- QueryLeaderboardsEndpointPagedResultOfOutput
  - `total` integer, required
  - `page` integer, required
  - `pageSize` integer, required
  - `items` QueryLeaderboardsEndpointOutput[], required
    - `id` string, required — The unique identifier of the leaderboard.
    - `name` string, required — The name of the leaderboard.
    - `instruction` string, required — The instruction used when collecting responses.
    - `showPrompt` boolean, required — Whether the prompt is shown on the rapids.
    - `showPromptAsset` boolean, required — Whether the prompt asset is shown on the rapids.
    - `isInversed` boolean, required — Whether the leaderboard results are inversed.
    - `responseBudget` integer, required — The response budget per run.
    - `minResponses` integer, required — The minimum responses collected per comparison.
    - `audienceId` string, required — The id of the audience that evaluates the leaderboard.
    - `jobDefinitionId` string, nullable — The id of the associated job definition, if any.
    - `featureFlags` FeatureFlag[], required — Feature flags applied to orders created from this 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.
    - `voteAggregation` 'AllVotes' | 'MajorityVote', required
    - `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.
    - `lastUpdatedAt` string, date-time, nullable, required — When votes were last recorded for the leaderboard. Null when no run has ever delivered votes to it.
  - `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/revisions/d779de93a5ee/schema)