---
title: "Queries the runs related to a leaderboard."
method: GET
path: "/leaderboard/{leaderboardId}/runs"
tags: ["Leaderboard"]
---

# Queries the runs related to a leaderboard.

`GET /leaderboard/{leaderboardId}/runs`

## Request

- Base URL: `https://api.rapidata.ai`
- URL: `https://api.rapidata.ai/leaderboard/{leaderboardId}/runs`
- Auth: OpenID Connect (`https://auth.rapidata.ai/.well-known/openid-configuration`, scopes: `openid`, `profile`, `email`, `offline_access`, `api`)

## Path parameters

- `leaderboardId` 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
- `status` 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
- `owner_mail` 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

- QueryLeaderboardRunsEndpointPagedResultOfOutput
  - `total` integer, required
  - `page` integer, required
  - `pageSize` integer, required
  - `items` QueryLeaderboardRunsEndpointOutput[], required
    - `id` string, required: The unique identifier of the run.
    - `name` string, required: The name of the run.
    - `status` 'Queued' | 'Running' | 'Completed' | 'Failed' | 'Paused' | 'Cancelled', required
    - `createdAt` string, date-time, required: The timestamp when the run was created.
    - `ownerMail` string, required: The mail of the owner of the run.
    - `organizationId` string, required: The id of the organization that owns the entity.
    - `orderId` string, nullable, required: The id of the associated order, if any.
    - `jobId` string, nullable, required: The id of the associated job, if any.
    - `audienceId` string, required: The id of the audience associated with the run.
  - `totalPages` integer

## Other responses

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

## Changes

- **2026-09-15** `ebc7fbc31114`: 1 warning
  - added the new `Cancelled` enum value to the `items/items/status/allOf[#/components/schemas/RunStatus]/` response property for the response status `200`
- **2026-09-04** `9da534659e5f`: 1 info
  - the security scope `api` was added to the endpoint's security scheme `OpenIdConnect`
- **2026-08-13** `d779de93a5ee`: 1 warning
  - added the new `Paused` enum value to the `items/items/status/allOf[#/components/schemas/RunStatus]/` response property for the response status `200`

[Operation history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/leaderboard/:leaderboardId/runs/get.md)

---

[API](https://skmtc.dev/rapidata/apis/rapidata-api.md) - [All operations](https://skmtc.dev/rapidata/apis/rapidata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rapidata/apis/rapidata-api/revisions/004a977d7d9f?raw)