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

# List models

`GET /v1/models`

## Request

- Base URL: `https://console.nace.ai`
- URL: `https://console.nace.ai/v1/models`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nace/apis/drex-api/docs/v1/models/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the models available to the requesting API key in this environment. Availability can differ between environments and API keys. Requires a valid API key. Does not check the balance, so it works while the account is at zero, and does not count toward rate limits.

## Response `200`

The model list.

- ModelsResponse
  - `models` Model[], required
    - `name` string, required: Value to send as `model` in an evaluate request. A pinned version id, an alias such as `drex-latest`, or a retired id that a newer version now answers.
    - `description` string, required
    - `release_date` string, date, required: Calendar date, `YYYY-MM-DD`. For an alias, the release date of the version it points to. For a retired id, its own release date.
    - `alias_for` string, nullable, required: For an alias or a retired id, the pinned version that serves and bills its requests; the description of a retired id starts with `Retired on`. `null` for a pinned version.
  - `request_id` string, required: Identifier of this request, `req_` plus 32 hex characters. Also sent in the `x-request-id` header, and on `/v1/systemone` and `/v1/models` in `x-typesafe-request-id` too. Quote it in support requests.

## Other responses

- `401`: The `Authorization` header is missing, is not `Bearer nace_sk_...` with 43 URL-safe characters, or names a key that does not exist or was revoked.
- `529`: Not caused by the request. The API is paused, a shared capacity pool is full, the rate limiter is unreachable, or the model service did not answer. The response never includes upstream status or detail. Wait `retry-after-ms` and retry the same request.

---

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