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

# List Models

`GET /v1/models`

List all models, both machine learning and language models, available in the runtime.

## Query parameters

- `format` 'json' | 'csv'
- `status` boolean
- `metadata_fields` string

## Response `200`

List of models in JSON format

- ModelListResponse — Response wrapper for the `/v1/models` endpoint (OpenAI-compatible format).
  - `data` ModelInfo[], required — The list of models
    - `datasets` string[], nullable — The datasets associated with this model, if any
    - `id` string, required — The name/identifier of the model
    - `metadata` ModelMetadata — Model metadata fields that can be optionally requested.
      - `supports_responses_api` boolean, required — Whether this model supports the Responses API
    - `object` string, required — The type of the object (always `model`)
    - `owned_by` string, required — The source from which the model was loaded (e.g., `openai`, `spiceai`)
    - `status` 'Initializing' | 'Ready' | 'Disabled' | 'Error' | 'Refreshing' | 'ShuttingDown' — Represents the status of a component (e.g. dataset, model, etc).
  - `object` string, required — The type of the response (always `list`)

## Other responses

- `500` — Internal server error occurred while processing models

## Changes

- **2026-02-06** `c4d7063e0abe` — 1 breaking, 1 info
  - added `#/components/schemas/ModelMetadata` to the `data/items/metadata` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/Metadata` from the `data/items/metadata` response property `oneOf` list for the response status `200`
- **2025-08-25** `15f188240c57` — 2 info
  - added the new optional `query` request parameter `metadata_fields`
  - added the optional property `data/items/metadata` to the response with the `200` status
- **2025-03-18** `dd94571fef79` — 1 breaking, 4 warning, 1 info
  - added `#/components/schemas/ComponentStatus` to the `data/items/status` response property `oneOf` list for the response status `200` (media type: application/json)
  - deleted the `query` request parameter `metadata_fields`
  - removed the optional property `data/items/error` from the response with the `200` status (media type: application/json)
  - removed the optional property `data/items/error_message` from the response with the `200` status (media type: application/json)
  - …2 more

[Change history](https://skmtc.dev/spiceai/apis/runtime/changes/v1/models/get.md)

---

[API](https://skmtc.dev/spiceai/apis/runtime.md) · [All operations](https://skmtc.dev/spiceai/apis/runtime/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spiceai/runtime/revisions/c4d7063e0abe/schema)