{
  "openapi": "3.1.0",
  "info": {
    "title": "BenchLM Data API",
    "version": "1.0.0",
    "summary": "Current BenchLM rankings, models, benchmarks, prices, benchmark results, history and answer endpoints.",
    "description": "REST API for BenchLM Data. Every data read counts as one monthly read on your plan, except usage, feedback, result coverage and history coverage. The same data is served over MCP at https://data.benchlm.ai/mcp (core tools; every tool at /mcp/full). History endpoints (/v1/history/*) cover the last 30 UTC calendar days on Free; earlier dates need Data Pro or Data Research. Current benchmark results and their coverage are under /v1/benchmarks/results/*. The query reference with examples is at https://benchlm.ai/data/access#query-reference. A limit above an endpoint's maximum is lowered to that maximum, and the answer then carries limitApplied with the limit requested, the limit applied and a note.",
    "termsOfService": "https://benchlm.ai/terms#data-access",
    "contact": {
      "name": "BenchLM Data",
      "url": "https://benchlm.ai/data/access"
    }
  },
  "externalDocs": {
    "description": "Query reference with examples",
    "url": "https://benchlm.ai/data/access#query-reference"
  },
  "servers": [
    {
      "url": "https://data.benchlm.ai",
      "description": "BenchLM Data"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Answers"
    },
    {
      "name": "Rankings"
    },
    {
      "name": "Catalog"
    },
    {
      "name": "Pricing"
    },
    {
      "name": "Results"
    },
    {
      "name": "History"
    },
    {
      "name": "Account"
    }
  ],
  "paths": {
    "/v1/rankings/current": {
      "get": {
        "summary": "List current rankings",
        "description": "Final BenchAlign scores, published ranks, evidence labels and interval bounds for one surface. Pages hold up to 100 rows.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "surface",
            "in": "query",
            "required": false,
            "description": "Ranking surface, matched without case. multimodalGrounded is a preliminary board.",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "agentic",
                "coding",
                "knowledge",
                "reasoning",
                "multimodalGrounded"
              ],
              "default": "overall"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Same as surface. Give one of the two, or the same value in both.",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "agentic",
                "coding",
                "knowledge",
                "reasoning",
                "multimodalGrounded"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of ranking rows with pagination.nextOffset.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RankingsPage"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Rankings"
        ]
      }
    },
    "/v1/rankings/methodology": {
      "get": {
        "summary": "Get the scoring basket",
        "description": "The protocols in the BenchAlign scoring basket and their share of category reference weight.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Basket category ID, matched without case.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The basket.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Rankings"
        ]
      }
    },
    "/v1/models": {
      "get": {
        "summary": "List models",
        "description": "Model names, creators, canonical IDs, release dates, source type, license, lab origin, context window, tags and use-case coverage. Filter by tags and by one or several creators; match=any keeps models that meet at least one filter. modalities lists the input and output types the provider documents, null where BenchLM has not recorded them (unknown, not text-only); tags=image-input keeps models documented to take images. Open-weight rows carry selfHost and ollama where BenchLM holds them; tags=ollama lists models with a local Ollama tag, tags=hosted-api those an inference host sells by the token.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "required": false,
            "description": "Case-insensitive search of key, name, slug and creator.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "creator",
            "in": "query",
            "required": false,
            "description": "A lab name as the catalog spells it, or several separated by commas, such as Anthropic,OpenAI. Case is ignored.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "tags",
            "in": "query",
            "required": false,
            "description": "Keep models that hold these tags, separated by commas (1 to 8). Tags are derived from the catalog and the price ledger: weights (open-weight, proprietary), license (permissive-license, custom-license, non-commercial-license), self-hostable, free-api (current list price 0), lab headquarters by region (region-europe) or country (origin-us, origin-cn), reasoning, place in the lineup (superseded, coming-soon), a notice on the lab's own API (api-deprecated, api-retired), and the input and output types the provider documents (image-input, audio-input, video-input, document-input, audio-output; recorded for part of the catalog). GET /v1/models?taxonomy=true explains each tag. A model whose fact is missing never passes.",
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "example": "free-api,open-weight"
          },
          {
            "name": "excludeTags",
            "in": "query",
            "required": false,
            "description": "Leave out every model that holds any of these tags, separated by commas (1 to 8), whatever match says. excludeTags=api-retired,superseded keeps models the lab still serves on its own API and has not replaced; excludeTags=origin-cn drops models from labs headquartered in China. A model BenchLM holds no fact for in that tag group is left out too and counted as unknown. A tag cannot be in both tags and excludeTags.",
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "example": "api-retired,superseded"
          },
          {
            "name": "match",
            "in": "query",
            "required": false,
            "description": "all keeps a model that meets every creator, openWeights and tags filter. any keeps a model that meets at least one of them, each tag counting on its own (excludeTags always applies): tags=free-api&creator=Anthropic,OpenAI&match=any returns the free models plus every Anthropic and OpenAI model.",
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ],
              "default": "all"
            }
          },
          {
            "name": "taxonomy",
            "in": "query",
            "required": false,
            "description": "Add tagTaxonomy: every model tag with its group, meaning and model count.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "useCase",
            "in": "query",
            "required": false,
            "description": "Use-case area ID, such as legal or software-development.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of models.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Catalog"
        ]
      }
    },
    "/v1/models/{identifier}": {
      "get": {
        "summary": "Get one model",
        "description": "One model by catalog key, public slug, typed name or router-style id, with its license, lab origin, tags, succession and provider lifecycle notices. An open-weight model also carries selfHost (total and active parameters in billions, and the GPU sets its weights fit on at each quantization, one marked recommended) and ollama (the Ollama library tag, pull command, download size in GB and the memory it needs) where BenchLM holds them; null means no entry, not that the model cannot be run. When the identifier was a name or router id rather than a key or slug, resolvedIdentifiers lists what it matched. An unknown identifier returns 404 model_not_found with the closest keys in the message and in error.suggestions.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "A model key or public slug, a typed name such as Sonnet 5.5, or a router-style id. An exact key is best. The route takes one path segment, so URL-encode a slash: google%2Fgemini-4-carbon.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The model.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "404": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Catalog"
        ]
      }
    },
    "/v1/models/{identifier}/rankings/current": {
      "get": {
        "summary": "Get one model's current rankings",
        "description": "The model's score and rank on every surface; an unranked surface is null. The identifier may be a key, slug, typed name or router-style id; resolvedIdentifiers lists what a name or router id matched. An unknown identifier returns 404 current_ranking_not_found with the closest keys in error.suggestions; a catalog model with no current ranking returns the same code and names the model.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "description": "A model key or public slug, a typed name such as Sonnet 5.5, or a router-style id. An exact key is best. The route takes one path segment, so URL-encode a slash: google%2Fgemini-4-carbon.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Rankings across surfaces.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "404": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Rankings"
        ]
      }
    },
    "/v1/benchmarks": {
      "get": {
        "summary": "List benchmarks",
        "description": "Benchmark names, IDs, categories, tags and classification references.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "required": false,
            "description": "Search names, categories, tags and aliases.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Category ID.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "tag",
            "in": "query",
            "required": false,
            "description": "Exact tag ID.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "relationship",
            "in": "query",
            "required": false,
            "description": "Classification relationship.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "useCase",
            "in": "query",
            "required": false,
            "description": "Use-case area ID.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "taxonomy",
            "in": "query",
            "required": false,
            "description": "Include the taxonomy of filter IDs (about 34 KB).",
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of benchmarks.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Catalog"
        ]
      }
    },
    "/v1/benchmarks/results/coverage": {
      "get": {
        "summary": "Check benchmark result coverage",
        "description": "Licensed source boards with retained and current result counts, native metrics and the complete source notices and license of each board. Does not count as a read. Use it to find exact boardId values for the result endpoints. Boards and notices each come in pages of at most 50: follow pagination.nextCursor (cursor) for more boards, and sourceNoticePagination.nextCursor (noticeCursor) with the same cursor and filters for more notices. Totals cover every matching board; notices cover the returned board page. BenchLM's own recorded boards take direction and unit from the BenchLM catalog (basis benchlm-catalog); other boards keep what their source states.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Boards per page, 1 to 50.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Cursor from pagination.nextCursor, for the next page of boards. Opaque; pass it back unchanged with the same filters. Up to 2048 characters.",
            "schema": {
              "type": "string",
              "maxLength": 2048
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Keep boards in this category.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "sourceId",
            "in": "query",
            "required": false,
            "description": "Keep boards from this source.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "query",
            "in": "query",
            "required": false,
            "description": "Words to find in board ids, names, benchmark keys and source ids. Case-insensitive; every word must match. Up to 8 words and 200 characters. A cursor is bound to the exact query text it was issued with.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "benchmarkKey",
            "in": "query",
            "required": false,
            "description": "Boards for one benchmark: its key (hlab) or catalog id (agentic:hlab) from the benchmark list. Matches the board's own benchmarkKey, ignoring case; Arena boards have none.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "noticeLimit",
            "in": "query",
            "required": false,
            "description": "Notices per page, 1 to 50.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 50
            }
          },
          {
            "name": "noticeCursor",
            "in": "query",
            "required": false,
            "description": "Cursor from sourceNoticePagination.nextCursor, for the next page of notices. Opaque; pass it back unchanged with the same filters. Up to 2048 characters.",
            "schema": {
              "type": "string",
              "maxLength": 2048
            }
          },
          {
            "$ref": "#/components/parameters/SharedNoticeTerms"
          },
          {
            "$ref": "#/components/parameters/ResultCompact"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of boards with counts and source notices. With query or benchmarkKey the response adds match (the words, the key and the fields searched); when no board matches it is still a 200, with empty boards, zero totals and a matchNote explaining the search. Each benchlm-recorded board adds runByCounts, its current rows by who ran the test (developer, benchmark, independent, other-lab, upstream, unknown), summing to its currentCount. A benchlm-lab board holds results a model's developer reported itself, never the benchmark's own board and never counted in a rank; its runByCounts are all developer. With compact=true the page lists boards and counts only, with no source notices; every result page carries the notices for its own rows.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "413": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          },
          "503": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Results"
        ]
      }
    },
    "/v1/benchmarks/results/current": {
      "get": {
        "summary": "List current benchmark results",
        "description": "Results from the latest retained licensed artifact for each exact source board. Duplicate source occurrences stay separate, published ranks describe their exact snapshot, native units and evaluation effort stay as supplied, and unreviewed model joins are null. BenchLM's own recorded boards take direction and unit from the BenchLM catalog (basis benchlm-catalog); other boards keep what their source states. Rows come with their source notices and the license terms of each board; keep the notices with any copy of the rows. Available on Free, Pro and Research. Counts as one read. Pages hold up to 100 rows; follow pagination.nextCursor with the cursor parameter.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "boardId",
            "in": "query",
            "required": false,
            "description": "Exact source board ID, from result coverage.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Keep boards in this category.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "sourceModelId",
            "in": "query",
            "required": false,
            "description": "Exact model ID as the source board names it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "modelKey",
            "in": "query",
            "required": false,
            "description": "Exact BenchLM model key. Matches rows with a reviewed join to that model.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "runBy",
            "in": "query",
            "required": false,
            "description": "Keep rows whose runBy.kind is one of these, comma-separated: developer, benchmark, independent, other-lab, upstream, unknown (runBy=independent,benchmark). Needs modelKey or a benchlm-recorded or benchlm-lab boardId, and offset instead of cursor; rows on other board families carry no runBy and are left out. Reads at most 500 matching current rows before filtering; more is a 400 that asks for category or boardId. The response adds runByFilter, the sorted kinds.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200,
              "pattern": "^(?:developer|benchmark|independent|other-lab|upstream|unknown)(?:,(?:developer|benchmark|independent|other-lab|upstream|unknown)){0,5}$"
            }
          },
          {
            "name": "query",
            "in": "query",
            "required": false,
            "description": "Case-insensitive search of source model IDs and model names, up to 200 characters. One or two characters with no boardId, category, sourceModelId or modelKey match recorded-history rows only when their modelKey or sourceModelId equals it exactly.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "$ref": "#/components/parameters/ResultOffset"
          },
          {
            "$ref": "#/components/parameters/ResultCursor"
          },
          {
            "$ref": "#/components/parameters/SharedNoticeTerms"
          },
          {
            "$ref": "#/components/parameters/ResultCompact"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of current benchmark results with their source notices. Rows on benchlm-recorded boards add runBy ({kind, name, url}: who ran the test, filled from the model page ledger) and usedInRankings (true when the value counts toward the model's BenchLM rank, null when the label is unknown), and the page adds runByNote. kind is developer, benchmark, independent, other-lab, upstream or unknown; a row gets a known kind only when its model key and score match the current ledger value. Rows on benchlm-lab boards are results the model's developer reported itself: each adds labReport ({benchmark, lab, metric, unit, higherIsBetter, setup, sourceUrl, publishedAt, comparableToBoard}), runBy kind developer with the lab and its source, and usedInRankings false. With compact=true each row carries notice, the index of its entry in sourceNotices, whose terms key names its license, attribution and upstream terms in sourceTerms.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "413": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          },
          "503": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Results"
        ]
      }
    },
    "/v1/pricing": {
      "get": {
        "summary": "List model API prices",
        "description": "Current and launch API list prices with dates and the quoted source page. Prices are USD per unit, normally per 1M tokens.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "required": false,
            "description": "Search key, name, slug, creator and provider.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "creator",
            "in": "query",
            "required": false,
            "description": "Creator name, matched without case.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "provider",
            "in": "query",
            "required": false,
            "description": "Selling provider.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "modelKey",
            "in": "query",
            "required": false,
            "description": "Exact model key.",
            "schema": {
              "type": "string",
              "maxLength": 160
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of price summaries.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Pricing"
        ]
      }
    },
    "/v1/pricing/hosts": {
      "get": {
        "summary": "List inference host prices",
        "description": "The per-token list price each tracked inference host or router shows on its own site for a model, in USD per 1M tokens, with the host's model ID, context window, status, the day the list was read (checkedAt) and its source page. Give modelKey for one model across hosts, cheapest blended price first, or host for one host's list. These rows are single readings of each price list: they are not part of the verified price ledger (/v1/pricing) and have no history. matchType variant marks a host flavor of the model (quantized, turbo, fast). freshness gives oldestReadOn, newestReadOn, ageDays, stale and a note for the rows returned; stale means the oldest was read more than 10 days ago.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "modelKey",
            "in": "query",
            "required": false,
            "description": "Exact model key. Rows for that model across hosts.",
            "schema": {
              "type": "string",
              "maxLength": 160
            }
          },
          {
            "name": "host",
            "in": "query",
            "required": false,
            "description": "Host slug.",
            "schema": {
              "type": "string",
              "enum": [
                "baseten",
                "cerebras",
                "deepinfra",
                "fireworks",
                "groq",
                "nebius",
                "novita",
                "openrouter",
                "sambanova",
                "together"
              ]
            }
          },
          {
            "name": "query",
            "in": "query",
            "required": false,
            "description": "Search model keys, names and host model IDs.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "matchedOnly",
            "in": "query",
            "required": false,
            "description": "true keeps rows joined to a BenchLM model. false adds models BenchLM does not list, with modelKey null.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 250.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 250,
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of host price rows.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HostPrices"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Pricing"
        ]
      }
    },
    "/v1/pricing/media": {
      "get": {
        "summary": "List image, video, speech and music prices",
        "description": "The published price of each variant of a media model, in the unit it is billed in: priceUsd buys unitScale of unit (0.10 per 1 second, or 15 per 1,000,000 characters), in USD as the provider lists it, with tier, resolution and duration where the price depends on them, the day the page was read (checkedAt) and its source. Rows are grouped by modality and unit, current rows before historical ones, cheapest first. Compare rows only inside the same modality and unit; nothing is converted into tokens. historical true marks a price kept after the provider shut the model down or a dated offer ended; endsOn is the last day a time-limited price applies. These are single readings of each price page, not the verified token price ledger, and have no history.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "modality",
            "in": "query",
            "required": false,
            "description": "Keep one modality.",
            "schema": {
              "type": "string",
              "enum": [
                "image",
                "video",
                "tts",
                "stt",
                "realtime-audio",
                "music"
              ]
            }
          },
          {
            "name": "provider",
            "in": "query",
            "required": false,
            "description": "Provider name or slug, matched without case.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "query",
            "in": "query",
            "required": false,
            "description": "Search product names and API model IDs.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of media price rows.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MediaPrices"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Pricing"
        ]
      }
    },
    "/v1/history/pricing": {
      "get": {
        "summary": "Read model price history",
        "description": "Dated price entries from the verified ledger: launch, change (a new standard price) or confirmed (same price, later source). A first-observed date means on or before. Omit modelKey for all models, for example event=change. Free covers the last 30 UTC calendar days; earlier dates need Data Pro (the latest three UTC calendar months) or Data Research (all retained history), and are refused with 403 data_pro_required on Free or data_archive_required on Pro. Counts as one read. Pages hold up to 500 entries; follow pagination.nextOffset with offset. An unpriced modelKey is 404 pricing_not_found.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "modelKey",
            "in": "query",
            "required": false,
            "description": "Exact model key. Omit for all models.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "provider",
            "in": "query",
            "required": false,
            "description": "Selling provider, matched without case.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "event",
            "in": "query",
            "required": false,
            "description": "Keep one kind of entry.",
            "schema": {
              "type": "string",
              "enum": [
                "launch",
                "change",
                "confirmed"
              ]
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Start of the window, a UTC date (YYYY-MM-DD) or an ISO 8601 UTC instant ending in Z. Not after through. No window cap.",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 24
            }
          },
          {
            "name": "through",
            "in": "query",
            "required": false,
            "description": "End of the window, a UTC date (YYYY-MM-DD) or an ISO 8601 UTC instant ending in Z. Not before since.",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 24
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Entries per page, 1 to 500.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Entries to skip, 0 to 10000.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of dated price entries.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "403": {
            "$ref": "#/components/responses/Error"
          },
          "404": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          },
          "503": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "History"
        ]
      }
    },
    "/v1/plans": {
      "get": {
        "summary": "List free API tiers and subscription plans",
        "description": "One list of two kinds of row, each copied from the provider's own page with the day it was read (retrievedAt). type free-tier: whether a provider has a free API tier, a signup credit or only a paid entry tier, with published rate limits. type subscription: monthly plans for apps and coding tools, with price, included usage in the provider's words, caps and the catalog models the plan names. A null value means the provider does not publish it. modelKey and maxPriceUsdMonthly return subscription rows only. freshness gives oldestReadOn, newestReadOn, ageDays, stale and a note for the rows returned; stale means the oldest was read more than 10 days ago.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Keep one kind of row.",
            "schema": {
              "type": "string",
              "enum": [
                "free-tier",
                "subscription"
              ]
            }
          },
          {
            "name": "provider",
            "in": "query",
            "required": false,
            "description": "Provider name or slug, matched without case.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "modelKey",
            "in": "query",
            "required": false,
            "description": "Exact model key. Plans whose provider names that model.",
            "schema": {
              "type": "string",
              "maxLength": 160
            }
          },
          {
            "name": "maxPriceUsdMonthly",
            "in": "query",
            "required": false,
            "description": "Highest monthly price in USD. A plan with no published price is left out.",
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 100000
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of free tier and subscription plan rows.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Pricing"
        ]
      }
    },
    "/v1/recommend": {
      "get": {
        "summary": "Recommend models",
        "description": "Answers \"which model should I use\". Orders picks by one ranking surface after filters. rankingBasis states which surface, why, and its limitation; BenchLM has no per-use-case quality score. With useCase, each pick's useCaseCoverage names the benchmarks tagged with that use case that have a published score for the model, with benchlm.ai links (up to 5 per pick; compact=false lists all). scores=true (with useCase) adds to each named benchmark the score BenchLM serves for that model, in the unit of that benchmark, with the source notice of each board in scoreNotices; a score known to be under a commercial license is null. GET /v1/benchmarks/results/current?modelKey= returns every score served for a model. Models a filter cannot evaluate are listed in notEvaluated. A model whose lab has shut down its own API is left out by default: retiredSkipped names the first of them in board order that the other filters did not rule out (5, or 10 with compact false), with the retirement date and the named replacement, and retiredSkippedCount counts them all, and includeRetired=true ranks them. A model whose replacement is among the same answer's candidates is also left out by default: supersededSkipped names the first of them in board order (5, or 10 with compact false) with replacedBy, supersededSkippedCount counts them all, and includeSuperseded=true ranks them. An older model stays when its replacement fails a filter. Compact by default. With monthlyInputTokens and monthlyOutputTokens, each pick carries monthlyCost (or null with monthlyCostUnavailableReason), and the answer adds monthlyTokens and monthlyCostBasis.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "useCase",
            "in": "query",
            "required": false,
            "description": "Use-case area ID.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "surface",
            "in": "query",
            "required": false,
            "description": "Ranking surface, matched without case. multimodalGrounded is a preliminary board.",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "agentic",
                "coding",
                "knowledge",
                "reasoning",
                "multimodalGrounded"
              ],
              "default": "overall"
            }
          },
          {
            "name": "maxInputPrice",
            "in": "query",
            "required": false,
            "description": "Maximum input price, USD per 1M tokens.",
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 100000
            }
          },
          {
            "name": "maxOutputPrice",
            "in": "query",
            "required": false,
            "description": "Maximum output price, USD per 1M tokens.",
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 100000
            }
          },
          {
            "name": "maxBlendedPrice",
            "in": "query",
            "required": false,
            "description": "Maximum blended price, (3 * input + output) / 4, USD per 1M tokens.",
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 100000
            }
          },
          {
            "name": "openWeights",
            "in": "query",
            "required": false,
            "description": "Only open-weight (true) or only proprietary (false) models.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "minContextWindow",
            "in": "query",
            "required": false,
            "description": "Minimum context window in tokens.",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "creator",
            "in": "query",
            "required": false,
            "description": "A lab name as the catalog spells it, or several separated by commas, such as Anthropic,OpenAI. Case is ignored.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "tags",
            "in": "query",
            "required": false,
            "description": "Keep models that hold these tags, separated by commas (1 to 8). Tags are derived from the catalog and the price ledger: weights (open-weight, proprietary), license (permissive-license, custom-license, non-commercial-license), self-hostable, free-api (current list price 0), lab headquarters by region (region-europe) or country (origin-us, origin-cn), reasoning, place in the lineup (superseded, coming-soon), a notice on the lab's own API (api-deprecated, api-retired), and the input and output types the provider documents (image-input, audio-input, video-input, document-input, audio-output; recorded for part of the catalog). GET /v1/models?taxonomy=true explains each tag. A model whose fact is missing never passes.",
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "example": "free-api,open-weight"
          },
          {
            "name": "excludeTags",
            "in": "query",
            "required": false,
            "description": "Leave out every model that holds any of these tags, separated by commas (1 to 8), whatever match says. excludeTags=api-retired,superseded keeps models the lab still serves on its own API and has not replaced; excludeTags=origin-cn drops models from labs headquartered in China. A model BenchLM holds no fact for in that tag group is left out too and counted as unknown. A tag cannot be in both tags and excludeTags.",
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "example": "api-retired,superseded"
          },
          {
            "name": "match",
            "in": "query",
            "required": false,
            "description": "all keeps a model that meets every creator, openWeights and tags filter. any keeps a model that meets at least one of them, each tag counting on its own (excludeTags always applies): tags=free-api&creator=Anthropic,OpenAI&match=any returns the free models plus every Anthropic and OpenAI model.",
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ],
              "default": "all"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 10.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10,
              "default": 5
            }
          },
          {
            "name": "includeRetired",
            "in": "query",
            "required": false,
            "description": "Rank models whose lab has shut down its own API too (tag api-retired). They are left out by default and named in retiredSkipped.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "includeSuperseded",
            "in": "query",
            "required": false,
            "description": "Rank models whose replacement is also a candidate in this answer. They are left out by default and named in supersededSkipped.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "monthlyInputTokens",
            "in": "query",
            "required": false,
            "description": "Tokens your workload sends in a month. With it or monthlyOutputTokens above 0, each pick carries monthlyCost in USD at list price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000000000
            }
          },
          {
            "name": "monthlyOutputTokens",
            "in": "query",
            "required": false,
            "description": "Tokens your workload generates in a month. Left out counts as 0.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000000000
            }
          },
          {
            "name": "scores",
            "in": "query",
            "required": false,
            "description": "Add the served score to each benchmark named for the use case, with the source notices in scoreNotices. Needs useCase.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Picks with rankingBasis and notEvaluated.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Answers"
        ]
      }
    },
    "/v1/compare": {
      "get": {
        "summary": "Compare models",
        "description": "Rank, score, evidence, price, context window and use-case coverage for 2 to 5 models on every surface. States figures and names no winner. With monthlyInputTokens and monthlyOutputTokens, each model carries monthlyCost (or null with monthlyCostUnavailableReason), and the answer adds monthlyTokens and monthlyCostBasis.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "modelKeys",
            "in": "query",
            "required": true,
            "description": "Comma-separated model keys, slugs, typed names or router-style ids (2 to 5). An exact key is best. Names that were matched are listed in resolvedIdentifiers; unknown ones return 404 model_not_found with the closest keys.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "monthlyInputTokens",
            "in": "query",
            "required": false,
            "description": "Tokens your workload sends in a month. With it or monthlyOutputTokens above 0, each model carries monthlyCost in USD at list price.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000000000
            }
          },
          {
            "name": "monthlyOutputTokens",
            "in": "query",
            "required": false,
            "description": "Tokens your workload generates in a month. Left out counts as 0.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000000000000
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The models side by side.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "404": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Answers"
        ]
      }
    },
    "/v1/value": {
      "get": {
        "summary": "Rank models by score per dollar",
        "description": "Answers \"best value for the price\". efficientPick, read first, is the cheapest model in the filtered set that scores at least retention (default 0.9) times the leader's score; leader is the top score in that set; efficientPickBasis states the rule, the price basis and the surface. items are ranked by valueIndex, the surface score divided by the price used, rounded to 2 decimals; valueBasis states the definition and price formula. Each row carries onFrontier and cheaperModelsScoringHigher, computed over every ranked model that passes the filters, not only the rows returned; frontierBasis states the rule. Models without a usable price are in notEvaluated; free models (price 0) are in freeModels, never ranked by division and never the leader or the pick. A higher valueIndex is more score per dollar, not a better model. The same rules drive https://benchlm.ai/llm-price-performance. Compact by default.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "surface",
            "in": "query",
            "required": false,
            "description": "Ranking surface, matched without case. multimodalGrounded is a preliminary board.",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "agentic",
                "coding",
                "knowledge",
                "reasoning",
                "multimodalGrounded"
              ],
              "default": "overall"
            }
          },
          {
            "name": "priceBasis",
            "in": "query",
            "required": false,
            "description": "Price used: blended is (3 * input + output) / 4 USD per 1M tokens.",
            "schema": {
              "type": "string",
              "enum": [
                "blended",
                "input",
                "output"
              ],
              "default": "blended"
            }
          },
          {
            "name": "minScore",
            "in": "query",
            "required": false,
            "description": "Drop models scoring below this.",
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000
            }
          },
          {
            "name": "maxBlendedPrice",
            "in": "query",
            "required": false,
            "description": "Maximum blended price, USD per 1M tokens.",
            "schema": {
              "type": "number",
              "minimum": 0,
              "maximum": 100000
            }
          },
          {
            "name": "openWeights",
            "in": "query",
            "required": false,
            "description": "Only open-weight (true) or only proprietary (false) models.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "creator",
            "in": "query",
            "required": false,
            "description": "A lab name as the catalog spells it, or several separated by commas, such as Anthropic,OpenAI. Case is ignored.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "tags",
            "in": "query",
            "required": false,
            "description": "Keep models that hold these tags, separated by commas (1 to 8). Tags are derived from the catalog and the price ledger: weights (open-weight, proprietary), license (permissive-license, custom-license, non-commercial-license), self-hostable, free-api (current list price 0), lab headquarters by region (region-europe) or country (origin-us, origin-cn), reasoning, place in the lineup (superseded, coming-soon), a notice on the lab's own API (api-deprecated, api-retired), and the input and output types the provider documents (image-input, audio-input, video-input, document-input, audio-output; recorded for part of the catalog). GET /v1/models?taxonomy=true explains each tag. A model whose fact is missing never passes.",
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "example": "free-api,open-weight"
          },
          {
            "name": "excludeTags",
            "in": "query",
            "required": false,
            "description": "Leave out every model that holds any of these tags, separated by commas (1 to 8), whatever match says. excludeTags=api-retired,superseded keeps models the lab still serves on its own API and has not replaced; excludeTags=origin-cn drops models from labs headquartered in China. A model BenchLM holds no fact for in that tag group is left out too and counted as unknown. A tag cannot be in both tags and excludeTags.",
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "example": "api-retired,superseded"
          },
          {
            "name": "match",
            "in": "query",
            "required": false,
            "description": "all keeps a model that meets every creator, openWeights and tags filter. any keeps a model that meets at least one of them, each tag counting on its own (excludeTags always applies): tags=free-api&creator=Anthropic,OpenAI&match=any returns the free models plus every Anthropic and OpenAI model.",
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ],
              "default": "all"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 25.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 25,
              "default": 10
            }
          },
          {
            "name": "retention",
            "in": "query",
            "required": false,
            "description": "Share of the leader's score the efficient pick must keep, from 0.5 to 1. 0.9 means at least 90% of the top score in the filtered set; 1 returns the cheapest model tied for the top score.",
            "schema": {
              "type": "number",
              "minimum": 0.5,
              "maximum": 1,
              "default": 0.9
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Value board.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValueBoard"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Answers"
        ]
      }
    },
    "/v1/feed/models": {
      "get": {
        "summary": "Read the model feed",
        "description": "One paged feed for routers and dashboards: identity, open-weight flag, license, lab country, tags, context window, overall and per-surface ranks, and current prices. Filter on the server by creator, openWeights and tags; tags=free-api&creator=Anthropic,OpenAI&match=any returns the free models plus those two labs in one request. The catalog serves no modalities or lifecycle status. Follow pagination.nextOffset. Compact by default.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per page, 1 to 250.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 250,
              "default": 100
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Rows to skip.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10000,
              "default": 0
            }
          },
          {
            "name": "creator",
            "in": "query",
            "required": false,
            "description": "A lab name as the catalog spells it, or several separated by commas, such as Anthropic,OpenAI. Case is ignored.",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "tags",
            "in": "query",
            "required": false,
            "description": "Keep models that hold these tags, separated by commas (1 to 8). Tags are derived from the catalog and the price ledger: weights (open-weight, proprietary), license (permissive-license, custom-license, non-commercial-license), self-hostable, free-api (current list price 0), lab headquarters by region (region-europe) or country (origin-us, origin-cn), reasoning, place in the lineup (superseded, coming-soon), a notice on the lab's own API (api-deprecated, api-retired), and the input and output types the provider documents (image-input, audio-input, video-input, document-input, audio-output; recorded for part of the catalog). GET /v1/models?taxonomy=true explains each tag. A model whose fact is missing never passes.",
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "example": "free-api,open-weight"
          },
          {
            "name": "excludeTags",
            "in": "query",
            "required": false,
            "description": "Leave out every model that holds any of these tags, separated by commas (1 to 8), whatever match says. excludeTags=api-retired,superseded keeps models the lab still serves on its own API and has not replaced; excludeTags=origin-cn drops models from labs headquartered in China. A model BenchLM holds no fact for in that tag group is left out too and counted as unknown. A tag cannot be in both tags and excludeTags.",
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "example": "api-retired,superseded"
          },
          {
            "name": "match",
            "in": "query",
            "required": false,
            "description": "all keeps a model that meets every creator, openWeights and tags filter. any keeps a model that meets at least one of them, each tag counting on its own (excludeTags always applies): tags=free-api&creator=Anthropic,OpenAI&match=any returns the free models plus every Anthropic and OpenAI model.",
            "schema": {
              "type": "string",
              "enum": [
                "all",
                "any"
              ],
              "default": "all"
            }
          },
          {
            "name": "openWeights",
            "in": "query",
            "required": false,
            "description": "Only open-weight (true) or only proprietary (false) models.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "rankedOnly",
            "in": "query",
            "required": false,
            "description": "Only models with a published board position.",
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A page of models.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelFeed"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Answers"
        ]
      }
    },
    "/v1/changes": {
      "get": {
        "summary": "What changed since a date",
        "description": "Models that entered or left a ranking surface, the largest rank moves, standard-price changes and rescoring events since a date, in one call. Model rows carry the current BenchLM model name and page url; a key the catalog does not know has null for both. When a rescoring falls inside the window, moves across it are listed under acrossRescoring and are not model changes; rankMoves then covers only the span after the latest rescoring. Models whose state at one end of the window was missing, unreadable or withheld are counted under membershipUnknown, not as entered or left. Free covers the last 30 UTC days, Data Pro the latest three UTC calendar months, Research all retained history. Counts as one read.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "since",
            "in": "query",
            "required": true,
            "description": "Start of the window, as a UTC date (YYYY-MM-DD) or an ISO 8601 instant. Must be inside the plan history window.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "surface",
            "in": "query",
            "required": false,
            "description": "Ranking surface, matched without case. multimodalGrounded is a preliminary board.",
            "schema": {
              "type": "string",
              "enum": [
                "overall",
                "agentic",
                "coding",
                "knowledge",
                "reasoning",
                "multimodalGrounded"
              ],
              "default": "overall"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Rows per list, 1 to 50.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 20
            }
          },
          {
            "name": "compact",
            "in": "query",
            "required": false,
            "description": "Replace the repeated BenchLM policy and methodology text with policyUrl, the attribution line and the methodology version. Data fields stay. Answer and feed endpoints default to true.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Changes since the requested date.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Changes"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          },
          "403": {
            "$ref": "#/components/responses/Error"
          },
          "503": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    },
    "/v1/history/benchmark_results": {
      "get": {
        "summary": "Read source-reported benchmark runs",
        "description": "Licensed results for one exact boardId and sourceModelId, ordered by run date. Explicit since and through use the source-reported run date at its supplied precision. Undated records and a single retained snapshot do not establish run history, and these scores are not historical leaderboard ranks; Arena boards publish snapshots without run dates, so read them from /v1/history/benchmark_result_snapshots. Free covers the last 30 UTC calendar days; earlier dates need Data Pro (the latest three UTC calendar months) or Data Research (all retained history), and are refused with 403 data_pro_required on Free or data_archive_required on Pro. Research queries with no dates include eligible undated records. Rows come with their source notices and the license terms of each board; keep the notices with any copy of the rows. Counts as one read. Pages hold up to 500 rows; follow pagination.nextCursor with the cursor parameter.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "boardId",
            "in": "query",
            "required": true,
            "description": "Exact source board ID, from result coverage.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "sourceModelId",
            "in": "query",
            "required": true,
            "description": "Exact model ID as the source board names it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Start of the window, a UTC date (YYYY-MM-DD) or an ISO 8601 UTC instant ending in Z. Windows are at most 90 days.",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 24
            }
          },
          {
            "name": "through",
            "in": "query",
            "required": false,
            "description": "End of the window, a UTC date (YYYY-MM-DD) or an ISO 8601 UTC instant ending in Z. Windows are at most 90 days.",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 24
            }
          },
          {
            "$ref": "#/components/parameters/HistoryLimit"
          },
          {
            "$ref": "#/components/parameters/ResultOffset"
          },
          {
            "$ref": "#/components/parameters/ResultCursor"
          },
          {
            "$ref": "#/components/parameters/SharedNoticeTerms"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of source-reported runs with their source notices.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "403": {
            "$ref": "#/components/responses/Error"
          },
          "413": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          },
          "503": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "History"
        ]
      }
    },
    "/v1/history/benchmark_result_snapshots": {
      "get": {
        "summary": "Read published benchmark snapshots",
        "description": "Retained publisher snapshots, ordered by snapshot date. Give boardId with sourceModelId to follow one exact source profile, or modelKey alone to follow one model across every board by its reviewed joins (each row names its boardId; unreviewed profiles, including native Arena rows, need boardId and sourceModelId). Scores, ranks and confidence intervals belong to their exact board and snapshot; an unknown scoring method is null. Explicit since and through use publisher snapshot dates; artifact retrieval times and undated snapshots do not establish publication history. Free covers the last 30 UTC calendar days; earlier dates need Data Pro (the latest three UTC calendar months) or Data Research (all retained history), and are refused with 403 data_pro_required on Free or data_archive_required on Pro. Research queries with no dates include eligible undated snapshots. Rows come with their source notices and the license terms of each board; keep the notices with any copy of the rows. Counts as one read. Pages hold up to 500 rows (100 with modelKey); follow pagination.nextCursor with the cursor parameter.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "boardId",
            "in": "query",
            "required": false,
            "description": "Exact source board ID, from result coverage. Required with sourceModelId unless modelKey is given.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "sourceModelId",
            "in": "query",
            "required": false,
            "description": "Exact model ID as the source board names it. Required with boardId unless modelKey is given.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "artifactId",
            "in": "query",
            "required": false,
            "description": "Keep snapshots from this retained artifact. Not with modelKey.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "modelKey",
            "in": "query",
            "required": false,
            "description": "Exact BenchLM model key. Use it alone, without boardId, sourceModelId or artifactId; limit is then at most 100.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Start of the window, a UTC date (YYYY-MM-DD) or an ISO 8601 UTC instant ending in Z. Windows are at most 90 days.",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 24
            }
          },
          {
            "name": "through",
            "in": "query",
            "required": false,
            "description": "End of the window, a UTC date (YYYY-MM-DD) or an ISO 8601 UTC instant ending in Z. Windows are at most 90 days.",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 24
            }
          },
          {
            "$ref": "#/components/parameters/HistoryLimit"
          },
          {
            "$ref": "#/components/parameters/ResultOffset"
          },
          {
            "$ref": "#/components/parameters/ResultCursor"
          },
          {
            "$ref": "#/components/parameters/SharedNoticeTerms"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of publisher snapshots with their source notices.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "403": {
            "$ref": "#/components/responses/Error"
          },
          "413": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          },
          "503": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "History"
        ]
      }
    },
    "/v1/history/coverage": {
      "get": {
        "summary": "Check historical coverage",
        "description": "Which history methods are available, their recorded windows, the plan's history window and limits. Also served at /v1/coverage. Does not count as a read. Set measurementScopes=true to list the exact modelKey, category and benchmarkKey tuples with retained approved measurement states, including missing-only states; Pro lists its latest three UTC calendar months, Research all retained states, and Free reports paid availability without listing tuples. Scope pages hold up to 50 identities; follow measurementScopes.nextCursor with the same filters and limit. Tuples do not promise numerical values or source-board results. limit, cursor, modelKey, category and benchmarkKey need measurementScopes=true.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "measurementScopes",
            "in": "query",
            "required": false,
            "description": "List retained measurement tuples.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Tuples per page, 1 to 50.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 25
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Cursor from measurementScopes.nextCursor. Opaque; pass it back unchanged with the same filters. Up to 2048 characters.",
            "schema": {
              "type": "string",
              "maxLength": 2048
            }
          },
          {
            "name": "modelKey",
            "in": "query",
            "required": false,
            "description": "Keep tuples for this model.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Keep tuples in this category.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "name": "benchmarkKey",
            "in": "query",
            "required": false,
            "description": "Keep tuples for this benchmark.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Historical coverage and the account history window.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "413": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          },
          "503": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "History"
        ]
      }
    },
    "/v1/history/rank_history": {
      "get": {
        "summary": "Read recorded ranking history",
        "description": "An exact model's saved BenchAlign rank, score, evidence label and scoring version over time. Dates refer to committed records, and earlier missing ranks stay missing. artifact=rebuilt covers overall ranks from August 22, 2025 to July 15, 2026, before the site saved a ranking. Points where most scores moved at once carry rescoring=true and are listed in rescoringEvents: treat moves across them as a rescoring, not model changes. freshness says when recorded history ends. Free covers the last 30 UTC calendar days; earlier dates need Data Pro (the latest three UTC calendar months) or Data Research (all retained history), and are refused with 403 data_pro_required on Free or data_archive_required on Pro. Counts as one read. Pages hold up to 500 rows; follow nextCursor with cursor.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "modelKey",
            "in": "query",
            "required": true,
            "description": "Exact model key.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "name": "surface",
            "in": "query",
            "required": false,
            "description": "Ranking surface ID, such as overall, agentic, coding, knowledge or reasoning.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$",
              "default": "overall"
            }
          },
          {
            "name": "artifact",
            "in": "query",
            "required": false,
            "description": "v5 is the BenchAlign rank as stored. rebuilt is the overall rank before July 15, 2026, recomputed from that day's committed site code and data (rows carry orderRecomputed=true).",
            "schema": {
              "type": "string",
              "enum": [
                "v5",
                "rebuilt"
              ],
              "default": "v5"
            }
          },
          {
            "name": "methodologyVersion",
            "in": "query",
            "required": false,
            "description": "Keep only rows saved under this scoring version.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "$ref": "#/components/parameters/HistorySince"
          },
          {
            "$ref": "#/components/parameters/HistoryThrough"
          },
          {
            "name": "granularity",
            "in": "query",
            "required": false,
            "description": "snapshot returns every saved state; daily the last saved state of each UTC day; weekly the last of each ISO week (Monday start). Daily or weekly fits a long window in one page.",
            "schema": {
              "type": "string",
              "enum": [
                "snapshot",
                "daily",
                "weekly"
              ],
              "default": "snapshot"
            }
          },
          {
            "$ref": "#/components/parameters/HistoryLimit"
          },
          {
            "$ref": "#/components/parameters/HistoryCursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of saved ranks for the model.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "403": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          },
          "503": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "History"
        ]
      }
    },
    "/v1/history/benchmark_history": {
      "get": {
        "summary": "Read benchmark score history",
        "description": "An exact model's recorded scores on one benchmark, keeping protocols and versions separate. These scores are not historical leaderboard positions. Recorded measurements can end before today: freshness gives the last recorded date, and rows missing after it are not evidence of no change. Free covers the last 30 UTC calendar days; earlier dates need Data Pro (the latest three UTC calendar months) or Data Research (all retained history), and are refused with 403 data_pro_required on Free or data_archive_required on Pro. Counts as one read. Pages hold up to 500 rows; follow nextCursor with cursor.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "modelKey",
            "in": "query",
            "required": true,
            "description": "Exact model key.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": true,
            "description": "Benchmark category.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "name": "benchmarkKey",
            "in": "query",
            "required": true,
            "description": "Exact benchmark key.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "name": "benchmarkVersion",
            "in": "query",
            "required": false,
            "description": "Keep one recorded benchmark version.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "$ref": "#/components/parameters/HistorySince"
          },
          {
            "$ref": "#/components/parameters/HistoryThrough"
          },
          {
            "name": "granularity",
            "in": "query",
            "required": false,
            "description": "snapshot returns every saved state; daily the last saved state of each UTC day; weekly the last of each ISO week (Monday start). Daily or weekly fits a long window in one page.",
            "schema": {
              "type": "string",
              "enum": [
                "snapshot",
                "daily",
                "weekly"
              ],
              "default": "snapshot"
            }
          },
          {
            "$ref": "#/components/parameters/HistoryLimit"
          },
          {
            "$ref": "#/components/parameters/HistoryCursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of recorded benchmark scores.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "403": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          },
          "503": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "History"
        ]
      }
    },
    "/v1/history/benchmark_events": {
      "get": {
        "summary": "Read benchmark catalog changes",
        "description": "First recorded definitions, first numeric results, removals and reintroductions of one benchmark, where retained. Catalog dates do not establish publication dates. Recorded events can end before today: freshness gives the last recorded date. Free covers the last 30 UTC calendar days; earlier dates need Data Pro (the latest three UTC calendar months) or Data Research (all retained history), and are refused with 403 data_pro_required on Free or data_archive_required on Pro. Counts as one read. Pages hold up to 500 rows; follow nextCursor with cursor.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": true,
            "description": "Benchmark category.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "name": "benchmarkKey",
            "in": "query",
            "required": true,
            "description": "Exact benchmark key.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "$ref": "#/components/parameters/HistorySince"
          },
          {
            "$ref": "#/components/parameters/HistoryThrough"
          },
          {
            "$ref": "#/components/parameters/HistoryLimit"
          },
          {
            "$ref": "#/components/parameters/HistoryCursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of benchmark catalog events.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "403": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          },
          "503": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "History"
        ]
      }
    },
    "/v1/history/ranking_snapshot": {
      "get": {
        "summary": "Read a saved ranking snapshot",
        "description": "Saved ranks as of a UTC date, in their original scoring version and never recomputed with today's formula. Results identify incomplete approved coverage. A snapshot that rescored most models at once carries rescoring=true. Free and Pro reject future dates. Give at alone: since, through and granularity are not accepted. Free covers the last 30 UTC calendar days; earlier dates need Data Pro (the latest three UTC calendar months) or Data Research (all retained history), and are refused with 403 data_pro_required on Free or data_archive_required on Pro. Counts as one read. Pages hold up to 500 rows; follow nextCursor with cursor.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "at",
            "in": "query",
            "required": true,
            "description": "The moment to read, a UTC date (YYYY-MM-DD) or an ISO 8601 UTC instant ending in Z.",
            "schema": {
              "type": "string",
              "minLength": 10,
              "maxLength": 24
            }
          },
          {
            "name": "modelKey",
            "in": "query",
            "required": false,
            "description": "Keep one model. Omit for every model on the surface.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "name": "surface",
            "in": "query",
            "required": false,
            "description": "Ranking surface ID, such as overall, agentic, coding, knowledge or reasoning.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$",
              "default": "overall"
            }
          },
          {
            "name": "artifact",
            "in": "query",
            "required": false,
            "description": "v5 is the BenchAlign rank as stored. rebuilt is the overall rank before July 15, 2026, recomputed from that day's committed site code and data (rows carry orderRecomputed=true).",
            "schema": {
              "type": "string",
              "enum": [
                "v5",
                "rebuilt"
              ],
              "default": "v5"
            }
          },
          {
            "name": "methodologyVersion",
            "in": "query",
            "required": false,
            "description": "Keep only rows saved under this scoring version.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$"
            }
          },
          {
            "$ref": "#/components/parameters/HistoryLimit"
          },
          {
            "$ref": "#/components/parameters/HistoryCursor"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of saved ranks as of the requested date.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "403": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          },
          "503": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "History"
        ]
      }
    },
    "/v1/usage": {
      "get": {
        "summary": "Check usage",
        "description": "Plan, monthly reads, remaining allowance, request rate and history access. Does not consume a read.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Usage report.",
            "headers": {
              "X-Data-Plan": {
                "$ref": "#/components/headers/XDataPlan"
              },
              "X-Data-Monthly-Remaining": {
                "$ref": "#/components/headers/XDataMonthlyRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Account"
        ]
      }
    },
    "/v1/feedback": {
      "post": {
        "tags": [
          "Account"
        ],
        "summary": "Report missing or wrong data",
        "description": "Tell BenchLM what the data could not answer. Does not consume a read; up to 20 per account per UTC day. Send no personal information.",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "missing"
                ],
                "properties": {
                  "missing": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "missing-model",
                      "missing-benchmark",
                      "missing-use-case",
                      "wrong-data",
                      "stale-data",
                      "other"
                    ],
                    "default": "other"
                  },
                  "tool": {
                    "type": "string",
                    "maxLength": 80
                  },
                  "modelKey": {
                    "type": "string",
                    "maxLength": 160
                  },
                  "benchmark": {
                    "type": "string",
                    "maxLength": 160
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Recorded.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "401": {
            "$ref": "#/components/responses/Error"
          },
          "429": {
            "$ref": "#/components/responses/Error"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "A BenchLM Data API key from https://data.benchlm.ai/account, sent as Authorization: Bearer <key>."
      }
    },
    "headers": {
      "XDataPlan": {
        "description": "Plan of the calling account.",
        "schema": {
          "type": "string"
        }
      },
      "XDataMonthlyRemaining": {
        "description": "Monthly reads remaining.",
        "schema": {
          "type": "integer"
        }
      }
    },
    "parameters": {
      "SharedNoticeTerms": {
        "name": "sharedNoticeTerms",
        "in": "query",
        "required": false,
        "description": "Send each distinct set of source notice terms once per page (sourceTerms, referenced by termsId) instead of repeating it on every notice. Changes the response shape only; queries and cursors ignore it.",
        "schema": {
          "type": "boolean",
          "default": false
        }
      },
      "ResultCompact": {
        "name": "compact",
        "in": "query",
        "required": false,
        "description": "Short answer: each result row points to its source notice by index and each distinct license and attribution is stated once; coverage lists boards and counts without notices. Leaves out hashes, snapshot ids and field notes. Not with sharedNoticeTerms, and not with noticeLimit or noticeCursor on coverage. Queries and cursors ignore it.",
        "schema": {
          "type": "boolean",
          "default": false
        }
      },
      "ResultOffset": {
        "name": "offset",
        "in": "query",
        "required": false,
        "description": "Rows to skip, 0 to 10000. Use cursor or offset, not both.",
        "schema": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10000,
          "default": 0
        }
      },
      "ResultCursor": {
        "name": "cursor",
        "in": "query",
        "required": false,
        "description": "Cursor from pagination.nextCursor. Opaque; pass it back unchanged with the same filters. Up to 2048 characters.",
        "schema": {
          "type": "string",
          "maxLength": 2048
        }
      },
      "HistoryLimit": {
        "name": "limit",
        "in": "query",
        "required": false,
        "description": "Rows per page, 1 to 500.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 500,
          "default": 100
        }
      },
      "HistoryCursor": {
        "name": "cursor",
        "in": "query",
        "required": false,
        "description": "Cursor from the previous page's nextCursor. Opaque; pass it back unchanged with the same filters. Up to 2048 characters.",
        "schema": {
          "type": "string",
          "maxLength": 2048
        }
      },
      "HistorySince": {
        "name": "since",
        "in": "query",
        "required": false,
        "description": "Start of the window, a UTC date (YYYY-MM-DD) or an ISO 8601 UTC instant ending in Z. Windows are at most 366 days; without since the window is the 90 days before through.",
        "schema": {
          "type": "string",
          "minLength": 10,
          "maxLength": 24
        }
      },
      "HistoryThrough": {
        "name": "through",
        "in": "query",
        "required": false,
        "description": "End of the window, a UTC date (YYYY-MM-DD) or an ISO 8601 UTC instant ending in Z. Windows are at most 366 days; without since the window is the 90 days before through.",
        "schema": {
          "type": "string",
          "minLength": 10,
          "maxLength": 24
        }
      }
    },
    "responses": {
      "Error": {
        "description": "Error. 400 invalid_query, 401 missing or invalid key, 403 data_pro_required or data_archive_required (dates outside the plan history window), 404 unknown model, 413 source notices too large for one page (lower limit or noticeLimit), 429 monthly or request-rate limit (see Retry-After), 503 data temporarily unavailable.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "string",
                "examples": [
                  "invalid_query"
                ]
              },
              "message": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "offset": {
            "type": "integer"
          },
          "limit": {
            "type": "integer"
          },
          "total": {
            "type": "integer"
          },
          "nextOffset": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      },
      "RankingsPage": {
        "type": "object",
        "properties": {
          "dataAsOf": {
            "type": "string"
          },
          "surface": {
            "type": "string"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "regionalItems": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "pagination": {
            "$ref": "#/components/schemas/Pagination"
          },
          "limitApplied": {
            "$ref": "#/components/schemas/LimitApplied"
          }
        }
      },
      "ValueBoard": {
        "type": "object",
        "properties": {
          "rankingBasis": {
            "type": "object"
          },
          "valueBasis": {
            "type": "object",
            "properties": {
              "definition": {
                "type": "string"
              },
              "unit": {
                "type": "string"
              },
              "priceBasis": {
                "type": "string"
              },
              "priceFormula": {
                "type": "string"
              }
            }
          },
          "leader": {
            "type": [
              "object",
              "null"
            ],
            "description": "The top score among the ranked models that pass the filters (the better surface rank on a tie). Null when no model is ranked.",
            "properties": {
              "modelKey": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "creator": {
                "type": "string"
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "score": {
                "type": "number"
              },
              "surfaceRank": {
                "type": "integer"
              },
              "price": {
                "type": "object",
                "properties": {
                  "used": {
                    "type": "number",
                    "description": "The price on the chosen basis, USD per 1M tokens."
                  },
                  "basis": {
                    "type": "string",
                    "enum": [
                      "blended",
                      "input",
                      "output"
                    ]
                  },
                  "unit": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "efficientPick": {
            "type": [
              "object",
              "null"
            ],
            "description": "The cheapest ranked model that passes the filters and scores at least retention times the leader's score; on a price tie, the higher score, then the better surface rank. It is always on the frontier. Null when no model is ranked.",
            "properties": {
              "modelKey": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "creator": {
                "type": "string"
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "score": {
                "type": "number"
              },
              "surfaceRank": {
                "type": "integer"
              },
              "price": {
                "type": "object",
                "properties": {
                  "used": {
                    "type": "number",
                    "description": "The price on the chosen basis, USD per 1M tokens."
                  },
                  "basis": {
                    "type": "string",
                    "enum": [
                      "blended",
                      "input",
                      "output"
                    ]
                  },
                  "unit": {
                    "type": "string"
                  }
                }
              },
              "valueIndex": {
                "type": "number"
              },
              "scoreShareOfLeader": {
                "type": "number",
                "description": "score / leader score, rounded to 3 decimals."
              },
              "retention": {
                "type": "number",
                "description": "The share of the leader's score the pick had to keep."
              },
              "priceShareOfLeader": {
                "type": "number",
                "description": "price used / the leader's price used, rounded to 3 decimals. Omitted when the leader's price is 0 or missing."
              }
            }
          },
          "efficientPickBasis": {
            "type": "string",
            "description": "One sentence naming the efficient pick's rule, retention, price basis and surface."
          },
          "frontierBasis": {
            "type": "string",
            "description": "One sentence stating the frontier rule on the price basis used."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "modelKey": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "creator": {
                  "type": "string"
                },
                "boardRank": {
                  "type": "integer"
                },
                "surfaceRank": {
                  "type": "integer"
                },
                "score": {
                  "type": "number"
                },
                "evidenceStatus": {
                  "type": "string"
                },
                "valueIndex": {
                  "type": "number"
                },
                "price": {
                  "type": "object"
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "onFrontier": {
                  "type": "boolean",
                  "description": "True when no other ranked model that passes the filters dominates this one: has the same or a lower price used with the same or a higher score, at least one of them strictly better. Two models with identical price and score are both on the frontier. False when the score is not above 0."
                },
                "cheaperModelsScoringHigher": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "How many ranked models that pass the filters dominate this one under the onFrontier rule: same or lower price used and same or higher score, at least one strictly better. 0 exactly when onFrontier is true; null when the score is not above 0. Counted over the whole filtered set, not only the rows returned."
                }
              }
            }
          },
          "freeModels": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "notEvaluated": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "notEvaluatedCount": {
            "type": "integer"
          },
          "limitApplied": {
            "$ref": "#/components/schemas/LimitApplied"
          }
        }
      },
      "ModelFeed": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "modelKey": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "creator": {
                  "type": "string"
                },
                "openWeight": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "license": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "country": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "ISO 3166-1 alpha-2 code of the lab's headquarters, null when not recorded."
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Tag IDs derived from the catalog and the price ledger, such as open-weight, self-hostable, free-api, region-europe, origin-us, superseded or api-retired. GET /v1/models?taxonomy=true lists every tag."
                },
                "supersededBy": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Keys of the lab's newer models that BenchLM records as successors of this one. Empty when none."
                },
                "lifecycleNotices": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LifecycleNotice"
                  },
                  "description": "Deprecation and retirement notices providers have published for this model, the lab's own API first. Empty means none in the sources BenchLM tracks, not a promise of availability."
                },
                "contextWindow": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contextTokens": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "overall": {
                  "type": [
                    "object",
                    "null"
                  ]
                },
                "surfaceRanks": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "integer"
                  }
                },
                "price": {
                  "type": [
                    "object",
                    "null"
                  ]
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                }
              }
            }
          },
          "pagination": {
            "$ref": "#/components/schemas/Pagination"
          },
          "limitApplied": {
            "$ref": "#/components/schemas/LimitApplied"
          }
        }
      },
      "Changes": {
        "type": "object",
        "properties": {
          "changeCount": {
            "type": "integer"
          },
          "counts": {
            "type": "object"
          },
          "window": {
            "type": "object",
            "properties": {
              "since": {
                "type": "string"
              },
              "through": {
                "type": "string"
              },
              "baselineAt": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "endAt": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "baselineAfterSince": {
                "type": "boolean"
              }
            }
          },
          "entered": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              }
            }
          },
          "left": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              }
            }
          },
          "membershipUnknown": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer"
              },
              "reasons": {
                "type": "object"
              },
              "meaning": {
                "type": "string"
              }
            }
          },
          "rankMoves": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              }
            }
          },
          "acrossRescoring": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              }
            }
          },
          "rescoringEvents": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "rescoringCheck": {
            "type": [
              "object",
              "null"
            ]
          },
          "priceChanges": {
            "type": "object",
            "properties": {
              "total": {
                "type": "integer"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              }
            }
          },
          "freshness": {
            "type": "object"
          },
          "emptyReasonLegend": {
            "type": "object"
          },
          "notes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "limitApplied": {
            "$ref": "#/components/schemas/LimitApplied"
          }
        }
      },
      "LifecycleNotice": {
        "type": "object",
        "properties": {
          "route": {
            "type": "string",
            "description": "Whose platform the notice covers: first_party is the lab's own API; azure_foundry, vertex and bedrock are partner platforms."
          },
          "routeLabel": {
            "type": "string"
          },
          "stage": {
            "type": "string",
            "enum": [
              "deprecated",
              "retired"
            ]
          },
          "providerTerm": {
            "type": [
              "string",
              "null"
            ],
            "description": "The provider's own wording for the state."
          },
          "effectiveDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "When the model stops answering on that route."
          },
          "dateSemantics": {
            "type": "string",
            "enum": [
              "exact",
              "approximate",
              "earliest_possible",
              "unknown"
            ],
            "description": "How firm effectiveDate is. earliest_possible is a floor the provider gave, not a schedule."
          },
          "announcedDate": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "replacement": {
            "type": [
              "object",
              "null"
            ],
            "description": "The model the provider names as the replacement. modelKey is BenchLM's key for it, null when the catalog does not list it. Equivalence is the provider's claim.",
            "properties": {
              "modelId": {
                "type": "string"
              },
              "modelKey": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          }
        }
      },
      "HostPrices": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "type": "string"
          },
          "hostPricesAsOf": {
            "type": [
              "string",
              "null"
            ],
            "description": "The latest day a host price list was read."
          },
          "unit": {
            "type": "string"
          },
          "basis": {
            "type": "string",
            "description": "What a row is and is not, stated once."
          },
          "filters": {
            "type": "object"
          },
          "hosts": {
            "type": "array",
            "description": "The hosts behind this page's rows. compact=false adds each host's source label, billing notes and size-tier prices.",
            "items": {
              "type": "object",
              "properties": {
                "slug": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "kind": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "checkedAt": {
                  "type": "string"
                }
              }
            }
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "host": {
                  "type": "string"
                },
                "hostName": {
                  "type": "string"
                },
                "hostModelId": {
                  "type": "string",
                  "description": "The model ID the host's API takes."
                },
                "name": {
                  "type": "string",
                  "description": "The host's display name for the row."
                },
                "modelKey": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "BenchLM model key, null when BenchLM does not list the model."
                },
                "modelUrl": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "matchType": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "enum": [
                    "exact",
                    "alias",
                    "variant",
                    null
                  ],
                  "description": "exact and alias: the same checkpoint as the BenchLM model. variant: a host flavor of it."
                },
                "input": {
                  "type": "number"
                },
                "output": {
                  "type": "number"
                },
                "cachedInput": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "blended": {
                  "type": "number",
                  "description": "(3 * input + output) / 4."
                },
                "unit": {
                  "type": "string"
                },
                "contextTokens": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "ga",
                    "preview",
                    "free-variant"
                  ]
                },
                "note": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "checkedAt": {
                  "type": "string"
                },
                "sourceUrl": {
                  "type": "string"
                }
              }
            }
          },
          "pagination": {
            "$ref": "#/components/schemas/Pagination"
          },
          "limitApplied": {
            "$ref": "#/components/schemas/LimitApplied"
          }
        }
      },
      "MediaPrices": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "type": "string"
          },
          "mediaPricesAsOf": {
            "type": [
              "string",
              "null"
            ],
            "description": "The latest day any row's price page was read."
          },
          "currency": {
            "type": "string"
          },
          "basis": {
            "type": "string",
            "description": "How to read and compare the rows."
          },
          "filters": {
            "type": "object"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "provider": {
                  "type": "string"
                },
                "providerSlug": {
                  "type": "string"
                },
                "product": {
                  "type": "string"
                },
                "apiModelId": {
                  "type": "string",
                  "description": "The model ID the provider's API takes. Media models are not catalog models."
                },
                "modality": {
                  "type": "string",
                  "enum": [
                    "image",
                    "video",
                    "tts",
                    "stt",
                    "realtime-audio",
                    "music"
                  ]
                },
                "unit": {
                  "type": "string",
                  "enum": [
                    "image",
                    "second",
                    "minute",
                    "character",
                    "song",
                    "request",
                    "credit"
                  ]
                },
                "unitScale": {
                  "type": "integer",
                  "description": "priceUsd buys this many of unit."
                },
                "priceUsd": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "null when the provider publishes no price for the variant; the note says why."
                },
                "tier": {
                  "type": "string"
                },
                "resolution": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "duration": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "historical": {
                  "type": "boolean",
                  "description": "true when the provider has shut the model down, or a dated offer has ended, and the price is kept as a record."
                },
                "endsOn": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The last day a time-limited price such as a launch promotion applies; null for a standing price. From the next UTC day the row is served as historical."
                },
                "note": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "checkedAt": {
                  "type": "string",
                  "description": "The day the price page was read."
                },
                "sourceUrl": {
                  "type": "string"
                },
                "sourceLabel": {
                  "type": "string",
                  "description": "Left out when compact is true."
                },
                "url": {
                  "type": "string",
                  "description": "The BenchLM page that shows the row."
                }
              }
            }
          },
          "pagination": {
            "$ref": "#/components/schemas/Pagination"
          },
          "limitApplied": {
            "$ref": "#/components/schemas/LimitApplied"
          }
        }
      },
      "LimitApplied": {
        "type": "object",
        "description": "Present only when the limit asked for was above the endpoint's maximum and the maximum was used.",
        "required": [
          "requested",
          "applied",
          "note"
        ],
        "properties": {
          "requested": {
            "type": "integer"
          },
          "applied": {
            "type": "integer"
          },
          "note": {
            "type": "string"
          }
        }
      }
    }
  }
}
