> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List All Training Checkpoints - PIN API

> List all training checkpoints across jobs in the PIN control plane, a read-only companion to the models endpoint for training runs.

Return every training checkpoint captured across jobs. Checkpoints are the intermediate artifacts written during a training run; the models endpoint exposes the same records with additional lifecycle actions such as merge and export.

## Endpoint

```http theme={null}
GET /v1/checkpoints
```

## Authentication

`Authorization: Bearer <api_key or JWT>`.

## Query parameters

<ParamField query="job_id" type="string">
  Filter to checkpoints from a single job.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of items to return.
</ParamField>

## Response

<ResponseField name="code" type="integer">
  `0` on success.
</ResponseField>

<ResponseField name="data" type="object">
  Envelope containing an `items` array of checkpoint records with fields such as `id`, `job_id`, `step`, `metric` snapshots, `artifact_paths`, and `created_at`.
</ResponseField>

## Example

```bash theme={null}
curl https://ariapin.example.com/v1/checkpoints \
  -H "Authorization: Bearer $ARIAPIN_API_KEY"
```

```json theme={null}
{
  "code": 0,
  "data": {
    "items": [
      {
        "id": "ckpt_0198c...",
        "job_id": "job_0198a...",
        "step": 500,
        "created_at": "2025-09-01T12:00:00Z"
      }
    ]
  },
  "message": ""
}
```

<Note>
  Checkpoints and models share the same underlying storage. Use [List Models](/api-reference/pin/models/list) when you need per-model lifecycle actions such as merge, reload, or export.
</Note>


## Related topics

- [List All Model Export Jobs - PIN API](/api-reference/pin/exports/list.md)
- [List PIN Models](/api-reference/pin/models/list.md)
- [Aria Compute PIN API: Post-Training & Evaluation](/api-reference/pin/introduction.md)
- [Retrieve full training job detail with checkpoints and metrics](/api-reference/pin/jobs/get.md)
- [List training jobs with status, type, and project filters](/api-reference/pin/jobs/list.md)