---
title: Models · API reference
url: https://docs.schemalabs.ai/api-reference/models
description: List the Schema models available to your organization, which one is the default, and any Enterprise fine-tune you own.
---

# Models

> List the Schema models available to your organization, which one is the default, and any Enterprise fine-tune you own.

Schema models: the bases you can run on and create endpoints on. The base flagged `default: true` is used when `base` is omitted; a retired base rejects runs, creations, and serves with `422 capability_unavailable` (upgrade endpoints still on one). Enterprise fine-tunes appear in this list for the owning organization only, and are served behind ordinary endpoints.

One rate for every Schema model: every base bills at the same rate, and switching an endpoint to a newer base (`upgrade`) never changes its rate.

## Operations

### List models

`GET /v2/models` (scope: `read`)

Returns the Schema models available to your organization.

**Returns**

A list of model objects, latest first.

**Response fields**

- `models` (array of objects): Model objects.
  - `id` (string): Base name (`schema-{n}`) or an Enterprise fine-tune id.
  - `name` (string): Display name.
  - `status` (string): `available`. Listed bases accept runs, creations, and serves; a base that has been retired answers with `422 capability_unavailable` and is moved on with `POST /v2/endpoints/:id/upgrade`.
  - `default` (boolean): The base used when a request omits `base`.

**Example request (cURL)**

```bash
curl 'https://api.schemalabs.ai/v2/models' \
  -H "Authorization: Bearer $SCHEMA_API_KEY"
```

**Example response (200)**

```json
{
  "models": [
    {
      "id": "schema-2",
      "name": "Schema-2",
      "status": "available",
      "default": true
    }
  ],
  "request_id": "req_a4c07b"
}
```