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

# Get a Model

`GET /v1/models/{model}`

Returns the details of a model, provided its name.

## Path parameters

- `model` string, required

## Headers

- `X-Client-Name` string

## Response `200`

OK

- GetModelResponse — Contains information about the model and which API endpoints it can be used with.
  - `name` string — Specify this name in the `model` parameter of API requests to use your chosen model.
  - `is_deprecated` boolean — Whether the model is deprecated or not.
  - `endpoints` CompatibleEndpoint[] — The API endpoints that the model is compatible with.
  - `finetuned` boolean — Whether the model has been fine-tuned or not.
  - `context_length` number — The maximum number of tokens that the model can process in a single request. Note that not all of these tokens are always available due to special tokens and preambles that Cohere has added by default.
  - `tokenizer_url` string — Public URL to the tokenizer's configuration file.
  - `default_endpoints` CompatibleEndpoint[] — The API endpoints that the model is default to.
  - `features` string[] — The features that the model supports.
  - `sampling_defaults` object — Default sampling parameters for this model when omitted from API requests.
    - `temperature` number, float
    - `k` integer
    - `p` number, float
    - `frequency_penalty` number, float
    - `presence_penalty` number, float
    - `max_tokens_per_doc` integer

## Other responses

- `400` — This error is returned when the request is not well formed. This could be because: - JSON is invalid - The request is missing required fields - The request contains an invalid combination of fields
- `401` — This error indicates that the operation attempted to be performed is not allowed. This could be because: - The api token is invalid - The user does not have the necessary permissions
- `403` — This error indicates that the operation attempted to be performed is not allowed. This could be because: - The api token is invalid - The user does not have the necessary permissions
- `404` — This error is returned when a resource is not found. This could be because: - The endpoint does not exist - The resource does not exist eg model id, dataset id
- `422` — This error is returned when the request is not well formed. This could be because: - JSON is invalid - The request is missing required fields - The request contains an invalid combination of fields
- `429` — Too many requests
- `498` — This error is returned when a request or response contains a deny-listed token.
- `499` — This error is returned when a request is cancelled by the user.
- `500` — This error is returned when an uncategorised internal server error occurs.
- `501` — This error is returned when the requested feature is not implemented.
- `503` — This error is returned when the service is unavailable. This could be due to: - Too many users trying to access the service at the same time
- `504` — This error is returned when a request to the server times out. This could be due to: - An internal services taking too long to respond

---

[API](https://skmtc.net/cohere-ai/apis/api-reference.md) · [All operations](https://skmtc.net/cohere-ai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cohere-ai/api-reference/revisions/dbed69eda210/schema)