---
title: "List checkpoints"
method: GET
path: "/v2/checkpoints"
tags: ["Checkpoints"]
---

# List checkpoints

`GET /v2/checkpoints`

Use query params to filter checkpoints. Supports filtering by `ids` (comma-separated UUIDs for single or multiple checkpoints)

## Query parameters

- `ids` string, nullable

## Response `200`

Returns checkpoints

- Checkpoint[]
  - `checksum` string, nullable
  - `gpu` string, required
  - `id` string, uuid, required
  - `info` unknown
  - `name` string, nullable
  - `platform` string, required
  - `status` 'initializing' | 'updated_info' | 'possibly_uploaded' | 'ready' | 'deprecated', required

## Other responses

- `400` — Invalid query parameters
- `500` — Failed to connect/fetch from database

---

[API](https://skmtc.dev/cedana/apis/cedana-api.md) · [All operations](https://skmtc.dev/cedana/apis/cedana-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cedana/cedana-api/revisions/f1a3fa319485/schema)