---
title: "Get a model by its identifier."
method: GET
path: "/v1/models/{model_id}"
tags: ["Models"]
---

# Get a model by its identifier.

`GET /v1/models/{model_id}`

Get a model by its identifier. Returns OpenAI, Anthropic, or Google response format based on SDK detection headers.

## Path parameters

- `model_id` string, required — The ID of the model to get.

## Headers

- `anthropic-version` string, nullable
- `x-goog-api-key` string, nullable
- `x-goog-user-project` string, nullable
- `x-goog-api-client` string, nullable

## Response `200`

Returns OpenAI format by default. Send `anthropic-version` header for Anthropic format, or any Google SDK header (`x-goog-api-key`, `x-goog-user-project`, `x-goog-api-client`) for Google format.

- union
  - Model — A model resource representing an AI model registered in OGX.
    - `identifier` string, required — Unique identifier for this resource in ogx
    - `provider_resource_id` string, nullable — Unique identifier for this resource in the provider
    - `provider_id` string, required — ID of the provider that owns this resource
    - `type` 'model'
    - `metadata` object — Any additional metadata for this model
    - `created` integer — The Unix timestamp in seconds when the model was created.
    - `owned_by` string — The owner of the model.
    - `model_type` 'llm' | 'embedding' | 'rerank' — Enumeration of supported model types in OGX.
    - `model_validation` boolean, nullable — Enable model availability check during registration. When false (default), validation is deferred to runtime and model is preserved during provider refresh.
    - `id` string, required — The model identifier (OpenAI-compatible alias for identifier).
    - `object` 'model', required — The object type, always 'model'.
  - AnthropicModelInfo — Anthropic model info response object. :id: Unique model identifier
    - `id` string, required — Unique model identifier.
    - `type` 'model' — Object type, always 'model'.
    - `display_name` string, required — A human-readable name for the model.
    - `created_at` string, required — RFC 3339 datetime string representing when the model was released.
    - `max_input_tokens` integer, nullable — Maximum input context window size in tokens.
    - `max_tokens` integer, nullable — Maximum value for the max_tokens parameter when using this model.
  - GoogleModelInfo — Google model info response object. :name: Model resource name, e.g. 'models/gemini-pro' :display_name: A human-readable name for the model :description: A description of the model
    - `name` string, required — Model resource name, e.g. 'models/gemini-pro'.
    - `display_name` string, required — A human-readable name for the model.
    - `description` string — A description of the model.

## Other responses

- `400` — The request was invalid or malformed
- `429` — The client has sent too many requests in a given amount of time
- `500` — The server encountered an unexpected error
- `default` — An error occurred

---

[API](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis.md) · [All operations](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ogx-ai/ogx-specification-stable-experimental-apis/versions/f3f783962256/schema)