---
title: "List Models"
method: GET
path: "/v1/models"
tags: ["models"]
---

# List Models

`GET /v1/models`

## Request

- Base URL: `https://api.cohere.com`
- URL: `https://api.cohere.com/v1/models`
- Auth: HTTP bearer

Returns a list of models available for use.

## Query parameters

- `page_size` number, double
- `page_token` string
- `endpoint` 'chat' | 'embed' | 'classify' | 'summarize' | 'rerank' | 'rate' | 'generate': One of the Cohere API endpoints that the model can be used with.
- `default_only` boolean

## Response `200`

OK

- ListModelsResponse
  - `models` GetModelResponse[], required
    - `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, double: 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` GetModelResponseSamplingDefaults: Default sampling parameters for this model when omitted from API requests.
      - `temperature` number, double
      - `k` integer
      - `p` number, double
      - `frequency_penalty` number, double
      - `presence_penalty` number, double
      - `max_tokens_per_doc` integer
  - `next_page_token` string: A token to retrieve the next page of results. Provide in the page_token parameter of the next request.

## 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.dev/cohere-ai/apis/cohere-api.md) · [All operations](https://skmtc.dev/cohere-ai/apis/cohere-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cohere-ai/apis/cohere-api/revisions/8e538a293bd3?raw)