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

# List Models

`GET /v1/models`

## Query parameters

- `organization` string, nullable
- `family` string, nullable
- `modality` string, nullable
- `open_weight` boolean, nullable
- `provider` string, nullable
- `min_context` integer, nullable
- `max_input_price` number, nullable
- `max_output_price` number, nullable
- `released_after` string, date, nullable
- `released_before` string, date, nullable
- `sort` string, nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- ModelsListResponse
  - `models` ModelSummary[], required
    - `id` string, required
    - `name` string, required
    - `description` string, required
    - `organization` OrganizationRef, required
      - `id` string, required
      - `name` string, required
    - `family` FamilyRef
      - `id` string, required
      - `name` string, required
    - `license` LicenseRef, required
      - `id` string, required
      - `name` string, required
      - `allow_commercial` boolean, required
      - `open_source` boolean, required
    - `open_weight` boolean, required
    - `model_type` string, required
    - `modalities` string[], required
    - `context_window` integer, nullable
    - `param_count` integer, nullable
    - `training_tokens` integer, nullable
    - `knowledge_cutoff` string, date, nullable
    - `release_date` string, date, nullable
    - `providers` ProviderPricing[], required
      - `provider_id` string, required
      - `provider_name` string, required
      - `input_price_per_m` number, nullable
      - `output_price_per_m` number, nullable
      - `throughput_tps` number, nullable
      - `latency_s` number, nullable
      - `status` string, required
    - `top_scores` object, required
    - `inference` ModelInference, required — Discovery metadata for invoking a model via the LLM Stats gateway. Always present on model responses. When `available` is False, optional fields are omitted and consumers should not attempt gateway calls.
      - `available` boolean, required
      - `endpoint` string, nullable
      - `gateway_model_id` string, nullable
      - `openai_compatible` boolean
      - `supports_streaming` boolean
      - `supports_tools` boolean
      - `supports_vision` boolean
      - `docs_url` string
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `source` string, required
    - `url` string, required
  - `next_cursor` string, nullable
  - `total` integer, required

## Other responses

- `401` — Unauthorized
- `422` — Validation Error

---

[API](https://skmtc.dev/llm-stats/apis/llm-stats-api.md) · [All operations](https://skmtc.dev/llm-stats/apis/llm-stats-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/llm-stats/llm-stats-api/revisions/83ad19251fbd/schema)