---
title: "Gets a leaderboard by its id."
method: GET
path: "/leaderboard/{leaderboardId}"
tags: ["Leaderboard"]
---

# Gets a leaderboard by its id.

`GET /leaderboard/{leaderboardId}`

## Path parameters

- `leaderboardId` string, required

## Response `200`

OK

- GetLeaderboardByIdEndpointOutput
  - `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.
  - `priority` integer, nullable — Priority override applied to every run's job. Null when no override is set; runs then fall back to the default leaderboard priority.
  - `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.

## 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)