---
title: "Get Ranking"
method: GET
path: "/api/v1/rankings/{ranking_id}"
tags: ["Rankings"]
---

# Get Ranking

`GET /api/v1/rankings/{ranking_id}`

## Request

- Base URL: `https://app.aimrank.io` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aimrank.io/api/v1/rankings/{ranking_id}`
- Auth: none declared

Get ranking details with entities.

## Path parameters

- `ranking_id` string, required

## Response `200`

Successful Response

- RankingDetailResponse
  - `id` string, required
  - `slug` string, nullable
  - `name` string, required
  - `description` string, nullable, required
  - `is_public` boolean, required
  - `visibility` string
  - `tenant_id` string, nullable
  - `category` string, nullable, required
  - `owner_id` string, required
  - `entity_count` integer, required
  - `vote_count` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `user_role` string, nullable
  - `media_type` string, nullable
  - `comparison_prompt` string
  - `vote_type` string
  - `ends_at` string, date-time, nullable
  - `goal` string, nullable
  - `min_raters_per_pair` integer
  - `qualification_required` boolean
  - `qualification_pass_threshold` number
  - `judge_mode` string
  - `default_judge_model` string, nullable
  - `entities` EntitySummary[], required
    - `id` string, required
    - `name` string, required
    - `description` string, nullable
    - `image_url` string, nullable
    - `media_url` string, nullable
    - `attributes` object, nullable
    - `mu` number, required
    - `phi` number, required
    - `match_count` integer
    - `win_count` integer
    - `rank` integer, required
  - `settings` object, nullable, required
  - `judge_vote_count` integer
  - `judge_models` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aimrank/apis/aimrank-api.md) · [All operations](https://skmtc.dev/aimrank/apis/aimrank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aimrank/apis/aimrank-api/revisions/3574d0aff459?raw)