---
title: "List trainings"
method: GET
path: "/trainings"
---

# List trainings

`GET /trainings`

Get a paginated list of all trainings created by the user or organization associated with the provided API token.

This will include trainings created from the API and the website. It will return 100 records per page.

Example cURL request:

```console
curl -s \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  https://api.replicate.com/v1/trainings
```

The response will be a paginated JSON array of training objects, sorted with the most recent training first:

```json
{
  "next": null,
  "previous": null,
  "results": [
    {
      "completed_at": "2023-09-08T16:41:19.826523Z",
      "created_at": "2023-09-08T16:32:57.018467Z",
      "error": null,
      "id": "zz4ibbonubfz7carwiefibzgga",
      "input": {
        "input_images": "https://example.com/my-input-images.zip"
      },
      "metrics": {
        "predict_time": 502.713876
      },
      "output": {
        "version": "...",
        "weights": "..."
      },
      "started_at": "2023-09-08T16:32:57.112647Z",
      "source": "api",
      "status": "succeeded",
      "urls": {
        "web": "https://replicate.com/p/zz4ibbonubfz7carwiefibzgga",
        "get": "https://api.replicate.com/v1/trainings/zz4ibbonubfz7carwiefibzgga",
        "cancel": "https://api.replicate.com/v1/trainings/zz4ibbonubfz7carwiefibzgga/cancel"
      },
      "model": "stability-ai/sdxl",
      "version": "da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf",
    }
  ]
}
```

`id` will be the unique ID of the training.

`source` will indicate how the training was created. Possible values are `web` or `api`.

`status` will be the status of the training. Refer to [get a single training](#trainings.get) for possible values.

`urls` will be a convenience object that can be used to construct new API requests for the given training.

`version` will be the unique ID of model version used to create the training.

## Response `200`

Success

- object
  - `next` string, nullable — URL to the next page of results
  - `previous` string, nullable — URL to the previous page of results
  - `results` SchemasTrainingResponse[]
    - `completed_at` string, date-time — The time when the training completed
    - `created_at` string, date-time — The time when the training was created
    - `error` string, nullable — Error message if the training failed
    - `id` string — The unique ID of the training
    - `input` object — The input parameters used for the training
    - `logs` string — The logs from the training process
    - `metrics` object — Metrics about the training process
      - `predict_time` number — The amount of CPU or GPU time, in seconds, that the training used while running
      - `total_time` number — The total time, in seconds, that the training took to complete
    - `model` string — The name of the model in the format owner/name
    - `output` object — The output of the training process
      - `version` string — The version of the model created by the training
      - `weights` string — The weights of the trained model
    - `source` 'web' | 'api' — How the training was created
    - `started_at` string, date-time — The time when the training started
    - `status` 'starting' | 'processing' | 'succeeded' | 'failed' | 'canceled' — The current status of the training
    - `urls` object — URLs for interacting with the training
      - `cancel` string, uri — URL to cancel the training
      - `get` string, uri — URL to get the training details
    - `version` string — The ID of the model version used for training

---

[API](https://skmtc.net/replicate/apis/replicate-http-api.md) · [All operations](https://skmtc.net/replicate/apis/replicate-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/replicate/replicate-http-api/versions/7a537f433b0b/schema)