---
title: "List benchmark definitions"
method: GET
path: "/v1/benchmarks"
tags: ["benchmarks"]
---

# List benchmark definitions

`GET /v1/benchmarks`

## Request

- Base URL: `https://modelglass-api.vercel.app`
- URL: `https://modelglass-api.vercel.app/v1/benchmarks`
- Auth: HTTP bearer

## Response `200`

All benchmark definitions.

- object
  - `ok` true, required
  - `data` Benchmark[], required
    - `id` string, required
    - `name` string, required
    - `version` string
    - `summary` string, required
    - `measures` string[], required
    - `category` string
    - `score_range` object, required
      - `direction` 'higher_is_better' | 'lower_is_better', required
      - `min` number
      - `max` number
      - `unbounded` boolean
      - `unit` string
      - `description` string, required
    - `scale_anchor` string: What a score on an Elo-shaped scale is pinned to.
    - `caveat` string: How to read or compare scores on this benchmark.
    - `limitations` string[], required
    - `url` string, uri, required
    - `superseded_by` string: The benchmark id that replaced this one.
    - `notes` string: Public commentary for a reader using this data (e.g. a sale price or regional caveat). May be absent.
  - `meta` ResponseMeta, required
    - `artifact_version` integer, required
    - `built_at` string, date-time, required
    - `count` integer: Item count when `data` is a collection.

## Other responses

- `401`: Missing, unknown, or revoked API key (UNAUTHORIZED / NOT_FOUND).
- `429`: Over the plan's daily rate limit (RATE_LIMITED).
- `500`: Unexpected server error (INTERNAL).

---

[API](https://skmtc.dev/modelglass/apis/modelglass-read-api.md) · [All operations](https://skmtc.dev/modelglass/apis/modelglass-read-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelglass/apis/modelglass-read-api/revisions/5948ffa60462?raw)