---
title: "Get Model Alias"
method: GET
path: "/models/aliases/{alias_id}"
tags: ["models"]
---

# Get Model Alias

`GET /models/aliases/{alias_id}`

Get a model alias by its ID.

## Path parameters

- `alias_id` string, uuid, required — The ID of the model alias to get

## Response `200`

Successful Response

- GetModelAliasResponse
  - `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 `options` to the response with the `200` status

[Change history](https://skmtc.dev/opper/apis/opper-api-v2/changes/models/aliases/:alias_id/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)