---
title: "Get model details"
method: GET
path: "/v1/models/{id_or_name}"
tags: ["Models"]
---

# Get model details

`GET /v1/models/{id_or_name}`

## Request

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

Get model details by UUID or full logical model name. Model names containing slashes are supported as path segments, for example /v1/models/openai/gpt-5.6-luna. Name lookup returns enabled catalog models; UUID lookup can return a disabled catalog record with enabled set to false. Protocol-ingress-only models are never returned.

## Path parameters

- `id_or_name` string, required

## Response `200`

Model details

- ModelDetail: Detailed model response. Pricing is returned only in the optional model_card object.
  - `id` string, uuid, required: Internal model resource ID. Use name in inference requests.
  - `name` string, required
  - `display_name` string, required
  - `vendor` string, required
  - `description` string, required
  - `type` string, required
  - `capability_tags` string[], nullable, required
  - `skills` string[], required: String capability tags derived from capability_tags; empty when tags are absent or invalid.
  - `unified_schema` object, nullable, required
  - `execution_mode` string, required
  - `supported_modes` string[], nullable, required
  - `run_count` integer, required
  - `sort_order` integer, required
  - `published_at` string, date-time, nullable, required
  - `vendor_slug` string, required
  - `model_slug` string, required
  - `enabled` boolean, required
  - `featured` boolean, required
  - `created_at` string, date-time, required
  - `model_card` ModelCard: Model pricing and presentation data.
    - `base_price` union, required
      - string
      - number
    - `prompt_token_price` union, required
      - string
      - number
    - `completion_token_price` union, required
      - string
      - number
    - `cache_read_multiplier` union, required
      - string
      - number
    - `cache_write_multiplier` union, required
      - string
      - number
    - `cache_write_1h_multiplier` union, required
      - string
      - number
    - `reasoning_price` union, required
      - string
      - number
    - `price_formula` string, required
    - `markup_ratio` union, required
      - string
      - number
    - `readme` string, required
    - `cover_url` string, required
  - `examples` ModelExample[], required
    - `id` string, required
    - `is_default` boolean, required
    - `created_at` string, date-time, required
    - `input_snapshot` unknown
    - `output_snapshot` unknown

## Other responses

- `400`: Missing model ID or name
- `401`: Missing or invalid API key
- `402`: API key spending limit exceeded
- `403`: API key scope does not authorize this endpoint
- `404`: Model not found or not publicly discoverable

---

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