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

# List models

`GET /v1/models`

## Request

- Base URL: `https://api.sandbase.ai`
- URL: `https://api.sandbase.ai/v1/models`
- Auth: HTTP bearer

List enabled logical models in the OpenAI-compatible model-list shape. Use the detail endpoint for capabilities, schemas, and pricing.

## Query parameters

- `q` string
- `vendor` string
- `type` string
- `order` 'sort_order' | 'most-popular' | 'newest' | 'name'

## Response `200`

Model list

- ModelListResponse
  - `object` 'list', required
  - `data` OpenAIModelListItem[], required
    - `id` string, required: Logical model name used in inference requests.
    - `object` 'model', required
    - `created` integer, required: Unix creation timestamp.
    - `owned_by` string, required: Representative enabled provider or sandbase.

## Other responses

- `401`: Missing or invalid API key
- `402`: API key spending limit exceeded
- `403`: API key scope does not authorize this endpoint
- `500`: Model catalog lookup failed

---

[API](https://skmtc.dev/sandbase/apis/sandbase-api.md) · [All operations](https://skmtc.dev/sandbase/apis/sandbase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sandbase/apis/sandbase-api/revisions/d40df2467ba2?raw)