---
title: "Gets a Model API"
method: GET
path: "/v1/model_apis/{model_api_name}"
---

# Gets a Model API

`GET /v1/model_apis/{model_api_name}`

Fetches a Model API by name, with workspace overlay when added.

## Response `200`

- ModelAPIV1 — A Model API catalog row, optionally enriched with workspace-specific state.
  - `name` string, required — Identifier of the Model API. Stable, URL-safe slug used as the public identifier.
  - `display_name` string, required — Human-readable name of the Model API.
  - `description` string, required — Description of the Model API.
  - `model_family` string, nullable — Family the underlying model belongs to.
  - `release_date` string, date, required — Date the Model API was made available.
  - `invoke_url` string, required — Base URL for invoking the Model API. OpenAI-shaped routes (e.g. /v1/chat/completions) live underneath this host.
  - `context_length` integer, required — The model's context window length, in tokens.
  - `cost_per_million_input_tokens` union, required — Cost per million input tokens, in dollars.
    - number
    - string
  - `cost_per_million_output_tokens` union, required — Cost per million output tokens, in dollars.
    - number
    - string
  - `rate_limits` RateLimitV1[], required — Rate limits in effect for the workspace. Workspace-specific overrides are returned when the workspace has added this Model API and configured them; otherwise the catalog default rate limits are returned.
    - `type` 'REQUEST' | 'TOKEN', required
    - `unit` 'SECOND' | 'MINUTE', required
    - `threshold` integer, required — The threshold for the rate limit
  - `org_details` ModelAPIOrgDetailsV1 — Workspace-specific state for a Model API.
    - `added_at` string, date-time, required — When the workspace first added this Model API.
    - `last_used_at` string, date-time, nullable — When the workspace last invoked this Model API. Null if the workspace has never invoked it.

---

[API](https://skmtc.net/baseten/apis/baseten-inference-api.md) · [All operations](https://skmtc.net/baseten/apis/baseten-inference-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baseten/baseten-inference-api/versions/a55a2f64c3c5/schema)
