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

# List Models

`GET /v1/models`

## Query parameters

- `scope` 'user' | 'organization' — `user` (default) returns only the caller's models; `organization` returns every model in the caller's org.
- `name` string, nullable — Filter to the model with this exact name (org-scoped, unique per org). Returns a 0- or 1-element list; ignores `scope`.
- `short_id` string, nullable — Filter to the model with this exact short_id (org-scoped). Returns a 0- or 1-element list; ignores `scope`.

## Response `200`

Successful Response

- ListModelsResponse
  - `models` ModelResponse[], required
    - `id` union, required
      - string, uuid
      - string
    - `short_id` string, required — Short, human-friendly model handle, e.g. ``mdl-7bQ2xV9mKp4R``.
    - `name` string, required — Human-readable model name, unique per org. Server-generated at creation; editable via ``PATCH /v1/models/{model_id}``.
    - `user_id` string, required — Id of the user who created the model (the creator/owner).
    - `model_type` 'training' | 'custom_training' | 'reasoning' | 'sequence_reasoning', required — ``training`` for platform-trained models; ``custom_training`` for caller-owned Python trial artifacts; ``reasoning`` for reasoning models on flat tasks; ``sequence_reasoning`` for reasoning models on sequence tasks.
    - `created_at` string, nullable
    - `hyperparameters` object, nullable — The winning trial's hyperparameters (model-family specific).
    - `validation_metrics` object, nullable — Cross-validation scores the optimizer selected on, keyed by metric name (e.g. ``{"auc": 0.91}``).
    - `source_tables` string[] — Names of the source tables the model trained on, captured at finalize from its training plan (read relations). Empty for models recorded before this was captured.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/outerproduct/apis/outerproduct-api.md) · [All operations](https://skmtc.net/outerproduct/apis/outerproduct-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/outerproduct/outerproduct-api/revisions/6c6e81fb3282/schema)