---
title: "Lists Loops checkpoints"
method: GET
path: "/v1/loops/checkpoints"
---

# Lists Loops checkpoints

`GET /v1/loops/checkpoints`

Lists Loops checkpoints filtered by run id, base model, or bt:// URI. Provide exactly one filter.

## Query parameters

- `run_id` string, nullable
- `base_model` string, nullable
- `checkpoint_path` string, nullable

## Response `200`

- ListLoopsCheckpointsResponseV1 — Checkpoints matching the query filter.
  - `checkpoints` LoopsCheckpointV1[], required — Matching checkpoints.
    - `checkpoint_id` string, required — The ID of the checkpoint.
    - `created_at` string, date-time, required — The timestamp of the checkpoint in ISO 8601 format.
    - `checkpoint_type` string, required — The type of checkpoint.
    - `base_model` string, nullable, required — The base model of the checkpoint.
    - `lora_adapter_config` object, nullable, required — The adapter config of the checkpoint.
    - `size_bytes` integer, required — The size of the checkpoint in bytes.
    - `sync_status` string, nullable — Sync state of the checkpoint: SYNCING or COMPLETE.
    - `id` string, required — The checkpoint ID.
    - `run_id` string, required — The ID of the run that produced the checkpoint.
    - `target` 'sampler' | 'trainer', required — Whether a TrainerServerCheckpoint is loadable by the sampler or the trainer. SAMPLER checkpoints are consumed by the sampling server for inference; TRAINER checkpoints capture full trainer state for resuming training. Mirrored in the bt:// URI as ``bt://loops:<trainer_id>/(sampler_weights|weights)/<name>``.

---

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