---
title: "List Model Aliases"
method: GET
path: "/models/aliases"
tags: ["models"]
---

# List Model Aliases

`GET /models/aliases`

List all model aliases for the organization that owns the API key.

## Query parameters

- `offset` integer — The offset of the first alias to return
- `limit` integer — The maximum number of aliases to return

## Response `200`

Successful Response

- PaginatedResponseListModelAliasesResponseItem
  - `meta` Meta, required
    - `total_count` integer, required — Total number of items in the collection
  - `data` ListModelAliasesResponseItem[], required — List of items returned in the response
    - `id` string, uuid, required — The ID of the model alias
    - `name` string, required — The name of the model alias
    - `fallback_models` string[], required — Ordered list of model names to try as fallbacks
    - `description` string, nullable — Optional description of the model alias
    - `options` ModelAliasOptions
      - `first_token_timeout_ms` integer, nullable — First-token failover guard. If a streaming call to an alias member produces no output within this many milliseconds, the gateway abandons it and fails over to the next fallback model — rescuing provider queueing stalls that never surface as errors. Disarmed after the first token, so long responses are never cut. Recommended: 5000-15000. Omit or null to disable.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required (out of credits)
- `404` — Not Found
- `422` — Request Validation Error

## Changes

- **2026-07-26** `d3ccdaa15678` — 1 info
  - added the optional property `data/items/options` to the response with the `200` status

[Change history](https://skmtc.dev/opper/apis/opper-api-v2/changes/models/aliases/get.md)

---

[API](https://skmtc.dev/opper/apis/opper-api-v2.md) · [All operations](https://skmtc.dev/opper/apis/opper-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opper/opper-api-v2/revisions/d3ccdaa15678/schema)