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

# List All Models

`GET /models`

## Request

- Base URL: `https://www.designarena.ai/api/v1`
- URL: `https://www.designarena.ai/api/v1/models`
- Auth: HTTP bearer

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