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

# List Models

`GET /v1/models`

List all available models.

Returns models auto-discovered from configured providers, enriched with
pricing data from the model_pricing table when available. Models that only
exist in the pricing table are also included for backward compatibility.

## Query parameters

- `provider` string, nullable — Filter models by provider name

## Response `200`

Successful Response

- ModelListResponse — OpenAI-compatible model list response.
  - `data` ModelObject[], required
    - `context_window` integer, nullable
    - `created` integer, required
    - `id` string, required
    - `object` string
    - `owned_by` string, required
    - `pricing` ModelPricingInfo — Pricing information for a model.
      - `cache_read_price_per_million` number, nullable
      - `cache_write_1h_price_per_million` number, nullable
      - `cache_write_price_per_million` number, nullable
      - `input_price_per_million` number, required
      - `output_price_per_million` number, required
      - `pricing_tiers` union[]
        - union
          - PricingTier — Whole-request price cliff selected by total billable input tokens.
            - `cache_read_price_per_million` number, nullable
            - `cache_write_1h_price_per_million` number, nullable
            - `cache_write_price_per_million` number, nullable
            - `input_price_per_million` number, nullable
            - `min_input_tokens` integer, required
            - `output_price_per_million` number, nullable
          - object
    - `pricing_source` string
  - `object` string

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-17** `dbc01f217b03` — 1 breaking, 1 info
  - the `data/items/pricing/anyOf[subschema #1: ModelPricingInfo]/pricing_tiers/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - added `#/components/schemas/PricingTier, subschema #2` to the `data/items/pricing/anyOf[subschema #1: ModelPricingInfo]/pricing_tiers/items/` response property `anyOf` list for the response status `200`
- **2026-07-23** `eba5b612f28e` — 2 info
  - added the optional property `data/items/pricing/anyOf[subschema #1: ModelPricingInfo]/cache_write_1h_price_per_million` to the response with the `200` status
  - added the optional property `data/items/pricing/anyOf[subschema #1: ModelPricingInfo]/pricing_tiers` to the response with the `200` status
- **2026-07-22** `51ba68e0330c` — 2 info
  - added the optional property `data/items/pricing/anyOf[subschema #1: ModelPricingInfo]/cache_read_price_per_million` to the response with the `200` status
  - added the optional property `data/items/pricing/anyOf[subschema #1: ModelPricingInfo]/cache_write_price_per_million` to the response with the `200` status
- **2026-07-20** `d9a87177ce4a` — 1 info
  - the endpoint scheme security `XApiKeyAuth` was added to the API
- **2026-07-17** `db57bd46e3eb` — 2 info
  - added the optional property `data/items/context_window` to the response with the `200` status
  - added the optional property `data/items/pricing_source` to the response with the `200` status

[Full history](https://skmtc.dev/mozilla-ai/apis/otari/changes/v1/models/get.md)

---

[API](https://skmtc.dev/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.dev/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/eae05f7dd3cd/schema)