---
title: "Get Leaderboard"
method: GET
path: "/leaderboard/{arena}/{category}"
tags: ["Leaderboard"]
---

# Get Leaderboard

`GET /leaderboard/{arena}/{category}`

## Request

- Base URL: `https://www.designarena.ai/api/v1`
- URL: `https://www.designarena.ai/api/v1/leaderboard/{arena}/{category}`
- Auth: HTTP bearer

Returns the current leaderboard rankings for a specific arena and category.

Results are sorted by ELO rating (highest first) and include win/loss statistics,
average generation time, and OpenRouter model ID mappings where available.

## Path parameters

- `arena` 'models' | 'builders' | 'agents', required
- `category` string, required

## Response `200`

Successful response with leaderboard data

- LeaderboardResponse
  - `success` boolean, required
  - `data` LeaderboardEntry[], required
    - `displayName` string, required: Human-readable model name
    - `provider` string, required: Model provider/company
    - `openRouterId` string, nullable, required: The model's ID on OpenRouter (e.g., `anthropic/claude-opus-4.6`). Use this to match leaderboard entries to OpenRouter's model catalog. Returns `null` when the model is not available on OpenRouter — this includes proprietary builder tools (e.g., v0, Devin), image/video/audio generators, and deprecated models.
    - `winRate` number, float, required: Win rate percentage (0-100)
    - `elo` integer, required: ELO rating (higher is better, base 1200)
    - `avgGenerationTimeMs` integer, nullable, required: Average generation time in milliseconds
  - `meta` LeaderboardMeta, required
    - `arena` string, required: The arena display name
    - `category` string, required: The category display name
    - `lastUpdated` string, date-time, nullable, required: When the leaderboard was last calculated
  - `timestamp` string, date-time, required: When this response was generated

## Other responses

- `400`: Invalid arena or category
- `500`: Internal server error

---

[API](https://skmtc.dev/design-arena/apis/design-arena-public-api.md) - [All operations](https://skmtc.dev/design-arena/apis/design-arena-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/design-arena/apis/design-arena-public-api/revisions/03316070e7a6?raw)