Skip to main content
GET
/
fine_tuning
/
checkpoints
curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/checkpoints?model=newton&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "ckp_...",
      "name": "newton/c:2.5.1-8b-base",
      "base_model": "newton/c:2.5.1-8b-base",
      "step": 1000,
      "metrics": {
        "loss": 0.123
      },
      "created_at": 1765201323
    }
  ],
  "has_more": false
}
Requires version 1.1.5 or later of the Archetype platform.

​
Overview

Lists checkpoints available to warm-start a new fine-tuning job. This returns the organization’s checkpoints, optionally filtered to a model family. The results are cursor-paginated and are sorted newest first. To list only checkpoints for a specific job, use the List Job Checkpoints endpoint.
This endpoint is used by the Fine-Tuning dashboard to build the list of checkpoints from which to start a job.

​
Request

​
model
string
Filters checkpoints to include only those of the specified model, e.g. newton. Omit to list all of the org’s checkpoints.
​
after
string
Forward cursor: return checkpoints older than the one with this ID. Mutually exclusive with before.
​
before
string
Backward cursor: return checkpoints newer than the one with this ID. Mutually exclusive with after.
​
limit
integer
The maximum number of options to return (1–100).

​
Response

Returns a page of checkpoint options.
​
object
string
The object type of a list response. Always list.
​
data
array
The selectable checkpoint options.
​
has_more
boolean
Whether or not more options exist beyond this page.
curl "https://api.u1.archetypeai.app/v0.6/fine_tuning/checkpoints?model=newton&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "ckp_...",
      "name": "newton/c:2.5.1-8b-base",
      "base_model": "newton/c:2.5.1-8b-base",
      "step": 1000,
      "metrics": {
        "loss": 0.123
      },
      "created_at": 1765201323
    }
  ],
  "has_more": false
}