# Lists fine-tuned models.

**GET** `/v1/finetuning/finetuned-models`

> **Deprecated** — this operation is still served but should not be adopted in new integrations.

Returns a list of fine-tuned models that the user has access to.

Base URL: `https://api.cohere.com`

Tags: `/finetuning`

## Authorization

| Option | Scheme | Type | Sent as | Scopes |
| --- | --- | --- | --- | --- |
| Option 1 | `bearerAuth` | `http` | `Authorization: Bearer <token>` | — |

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page_size` | `integer` (int32) | No | Maximum number of results to be returned by the server. If 0, defaults to 50. |
| `page_token` | `string` | No | Request a specific page of the list results. |
| `order_by` | `string` | No | Comma separated list of fields. For example: "created_at,name". The default sorting order is ascending. To specify descending order for a field, append " desc" to the field name. For example: "created_at desc,name". Supported sorting fields: - created_at (default) |

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `X-Client-Name` | `string` | No | The name of the project that is making the request. |

## Responses

| Status | Description | Media type |
| --- | --- | --- |
| `200` | A successful response. | `application/json` |
| `400` | Bad Request | `application/json` |
| `401` | Unauthorized | `application/json` |
| `403` | Forbidden | `application/json` |
| `404` | Not Found | `application/json` |
| `500` | Internal Server Error | `application/json` |
| `503` | Status Service Unavailable | `application/json` |

### Example response: 200 — A successful response.

```json
{
  "finetuned_models": [
    {
      "completed_at": "2024-01-17T20:31:05.047066Z",
      "created_at": "2024-01-17T20:11:42.907112Z",
      "creator_id": "7a317d97-4d05-427d-9396-f31b9fb92c55",
      "id": "fee37446-7fc7-42f9-a026-c6ba2fcc422d",
      "name": "chat-ft",
      "organization_id": "6bdca3d5-3eae-4de0-ac34-786d8063b7ee",
      "settings": {
        "base_model": {
          "base_type": "BASE_TYPE_CHAT",
          "name": "medium",
          "strategy": "STRATEGY_TFEW",
          "version": "14.2.0"
        },
        "dataset_id": "my-dataset-d701tr",
        "hyperparameters": {
          "early_stopping_patience": 6,
          "early_stopping_threshold": 0.01,
          "learning_rate": 0.01,
          "train_batch_size": 16,
          "train_epochs": 1
        }
      },
      "status": "STATUS_READY",
      "updated_at": "2024-01-17T20:31:06.464015Z"
    },
    {
      "completed_at": "2024-01-17T20:42:55.821051Z",
      "created_at": "2024-01-17T20:17:16.997608Z",
      "creator_id": "7a317d97-4d05-427d-9396-f31b9fb92c55",
      "id": "9d927c5e-7598-4772-98b7-cdf2014e8874",
      "name": "rerank-ft",
      "organization_id": "6bdca3d5-3eae-4de0-ac34-786d8063b7ee",
      "settings": {
        "base_model": {
          "base_type": "BASE_TYPE_RERANK",
          "name": "english",
          "strategy": "STRATEGY_VANILLA",
          "version": "2.0.0"
        },
        "dataset_id": "rerank-dataset-d820xf"
      },
      "status": "STATUS_READY",
      "updated_at": "2024-01-17T20:50:11.148769Z"
    }
  ]
}
```

### Example response: 400 — Bad Request

```json
{
  "message": "string"
}
```

### Example response: 401 — Unauthorized

```json
{
  "message": "string"
}
```

### Example response: 403 — Forbidden

```json
{
  "message": "string"
}
```

### Example response: 404 — Not Found

```json
{
  "message": "string"
}
```

### Example response: 500 — Internal Server Error

```json
{
  "message": "string"
}
```

### Example response: 503 — Status Service Unavailable

```json
{
  "message": "string"
}
```

## Related pages

- [/audio/transcriptions](./tags/audio-transcriptions.md)
- [/batches](./tags/batches.md)
- [/connectors](./tags/connectors.md)
- [/datasets](./tags/datasets.md)
- [/embed-jobs](./tags/embed-jobs.md)
- [/finetuning](./tags/finetuning.md)
- [/models](./tags/models.md)
- [API Reference](../../api.md)
- [Authorize with oAuth](./oauthauthorize-connector.md)
- [Cancel a batch](./cancelbatch.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.