# Retrieve training metrics for fine-tuned models.

**GET** `/v1/finetuning/finetuned-models/{finetuned_model_id}/training-step-metrics`

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

Returns a list of metrics measured during the training of a fine-tuned model.
The metrics are ordered by step number, with the most recent step first.
The list can be paginated using `page_size` and `page_token` parameters.

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

Tags: `/finetuning`

## Authorization

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

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `finetuned_model_id` | `string` | Yes | The parent fine-tuned model ID. |

## 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. |

## 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
{
  "step_metrics": [
    {
      "created_at": "2024-01-17T20:24:26.952802658Z",
      "metrics": {
        "accuracy": 0.4557601809501648,
        "cross_entropy": 4.264331340789795,
        "generation_accuracy": 0.4557601809501648,
        "generation_cross_entropy": 4.264331340789795,
        "step": 0
      }
    },
    {
      "created_at": "2024-01-17T20:25:19.331940174Z",
      "metrics": {
        "accuracy": 0.7393720149993896,
        "cross_entropy": 0.7702581286430359,
        "generation_accuracy": 0.7393720149993896,
        "generation_cross_entropy": 0.7702581286430359,
        "step": 9
      },
      "step_number": 9
    }
  ]
}
```

### 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.