---
title: "Get a single model"
method: GET
path: "/v1/models/{modelId}"
tags: ["Models"]
---

# Get a single model

`GET /v1/models/{modelId}`

## Request

- Base URL: `https://api.auxen.ai`
- URL: `https://api.auxen.ai/v1/models/{modelId}`
- Auth: HTTP bearer

## Path parameters

- `modelId` string, required

## Response `200`

OK

- object
  - `success` true, required
  - `data` object, required
    - `model` Model
      - `id` string
      - `name` string
      - `tier` 'fast' | 'balanced' | 'powerful' | 'maximum'
      - `family` string
      - `status` 'active' | 'legacy': Legacy models are listed only with include_legacy=true and can be deployed until 2027-04-02; after that, deploys return MODEL_DEPRECATED with replacement_model.
      - `is_default_for_tier` boolean
      - `is_recommended` boolean
      - `context_length` integer
      - `license` string
      - `hf_repo` string
      - `release_date` string, date, nullable
      - `replacement_model` string, nullable
      - `rate_per_hour` string
      - `minimum_session_minutes` integer: Warm-up is free. Once a deployment is ready, each session (ready → pause or delete) is billed for at least this many minutes.
      - `size_group` 'small' | 'medium' | 'large' | 'xl'
      - `parameter_count` string
      - `speed_rating` 'fast' | 'balanced' | 'powerful' | 'maximum'
      - `best_for` string
      - `description` string
      - `plans` object: Pay-as-you-go pricing for this model at Standard throughput. The legacy `subscription` field is retained for grandfathered accounts.
        - `pay_as_you_go` object
          - `hourly_cost` number
        - `on_demand` object, nullable: Back-compat alias for `pay_as_you_go`.
          - `hourly_cost` number
        - `subscription` object: Legacy field. Subscription billing is grandfathered; not available for new deployments.
          - `plan` 'shared' | 'dedicated' | 'business' | 'enterprise'
          - `monthly_cost` number
  - `meta` Meta, required
    - `requestId` string
    - `timestamp` string, date-time

## Other responses

- `404`: Resource not found.

---

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