---
title: "List All Models"
method: GET
path: "/models"
tags: ["Models"]
---

# List All Models

`GET /models`

Returns every model with its identity info, rankings nested by
arena and category, and tournament placement distribution. One call
to get all ELO scores, win rates, generation times, and 1st/2nd/3rd/4th
place finishes across all arenas.

## Response `200`

All models with nested rankings

- ModelsResponse
  - `success` boolean, required
  - `data` ModelEntry[], required
    - `id` string, required — Internal model identifier (stable)
    - `displayName` string, required — Human-readable model name
    - `provider` string, required — Model provider/company
    - `openRouterId` string, nullable, required — OpenRouter model ID, or null if not on OpenRouter
    - `rankings` object, required — Nested rankings keyed by arena, then category
    - `rankingDistribution` RankingDistribution, required — How many times this model finished in each placement across all completed tournaments. Tournaments flagged as removed or bad are excluded.
      - `first` integer, required — Number of tournaments where this model ranked 1st
      - `second` integer, required — Number of tournaments where this model ranked 2nd
      - `third` integer, required — Number of tournaments where this model ranked 3rd
      - `fourth` integer, required — Number of tournaments where this model ranked 4th
      - `total` integer, required — Total tournaments (sum of all placements)
  - `meta` object, required
    - `lastUpdated` string, date-time, nullable — Most recent leaderboard calculation time across all arenas
  - `timestamp` string, date-time, required

## Other responses

- `401` — Missing API key
- `500` — Internal server error

---

[API](https://skmtc.net/design-arena/apis/design-arena-public-api.md) · [All operations](https://skmtc.net/design-arena/apis/design-arena-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/design-arena/design-arena-public-api/versions/03316070e7a6/schema)