---
title: "List Arenas & Categories"
method: GET
path: "/arenas"
tags: ["Discovery"]
---

# List Arenas & Categories

`GET /arenas`

## Request

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

Returns all available arena types and their categories. Use this to discover
valid arena/category combinations before calling the leaderboard endpoint.

## Response `200`

List of arenas and their categories

- ArenasResponse
  - `success` boolean, required
  - `data` ArenaInfo[], required
    - `id` string, required: Arena display name
    - `name` string, required: Human-readable arena name
    - `description` string, required: What this arena evaluates
    - `categories` object[], required
      - `id` string
      - `name` string
    - `leaderboardUrl` object[], required
      - `category` string
      - `url` string: Relative URL for the leaderboard endpoint
  - `timestamp` string, date-time, required

## Other responses

- `401`: Missing API key

---

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