API reference · Fine-tuning
A job's checkpoints, oldest first
/v1/fine-tunes/{fine_tune_id}/checkpoints- TypeScript
client.fineTuning.listCheckpoints()- Python
client.fine_tuning.list_checkpoints()- CLI
hayonix fine-tunes checkpoints
Weights saved during the run (as many as the checkpoints setting asks for, the final one included), each with its artefacts. Any checkpoint can be downloaded or used to continue training in a new job.
Project API key (Authorization: Bearer sk_…), or a console session. Requires the fine_tune_job:read permission (a key's scope, or a role that includes it).
Examples
The samples read API_KEY and API_BASE_URL from the environment (see Setup). Values are examples.
curl -sS "$API_BASE_URL/fine-tunes/ftj_01jc5zq4m8k3v6x9t2w7r0b1e4/checkpoints" \
-H "Authorization: Bearer $API_KEY"Request
| Header | Required | Description |
|---|---|---|
Authorization | yes | Bearer and your API key. The key implies its project. |
X-Project-Id | session only | The project to act in, for console sessions. Requests with an API key leave it out. |
Path parameters
fine_tune_idstringrequiredID of the fine-tuning job
ID with prefix ftj_
Query parameters
limitinteger1–200, default 50
1–200
cursorstring`next_cursor` of the previous page
up to 200 characters
Response
200 a page of results — A page of checkpoints
The items of this page.
ShowHide 9 fields of
dataidstringrequiredUnique ID (`ftc_…`)
ID with prefix ftc_
objectstringrequiredAlways `fine_tune_checkpoint`: the type of this object
One of
fine_tune_checkpointfine_tune_idstringrequiredID of the fine-tuning job
ID with prefix ftj_
stepintegerrequiredOptimizer step the checkpoint was saved at
epochnumber | nullrequiredEpoch at that step, fractional; null when not reported
finalbooleanrequiredThe checkpoint saved at the end of training (the result model)
What the checkpoint holds: the adapter, weights, and any serving formats
ShowHide 4 fields of
artifactsnamestringrequiredIts name
One of
adapterweightsmergedadapter_ggufmerged_ggufformatstringrequiredFile format of the artefact
bytesintegerrequiredSize in bytes
filesarray of objectrequiredThe files that make up the artefact
ShowHide 3 fields of
filespathstringrequiredPath of the file inside the artefact
bytesintegerrequiredSize in bytes
sha256stringrequiredSHA-256 of the content, hex
bytesintegerrequiredSize in bytes
created_atstring (date-time)requiredWhen it was created (ISO 8601, UTC)
next_cursorstring | nullrequiredPass as `cursor` for the next page; null on the last page.
Example response
{
"data": [
{
"id": "ftc_01jc5zq4m8k3v6x9t2w7r0b1e4",
"object": "fine_tune_checkpoint",
"fine_tune_id": "ftj_01jc5zq4m8k3v6x9t2w7r0b1e4",
"step": 1,
"epoch": 1.5,
"final": true,
"artifacts": [
{
"name": "adapter",
"format": "peft_lora_safetensors",
"bytes": 1,
"files": [
{
"path": null,
"bytes": null,
"sha256": null
}
]
}
],
"bytes": 1,
"created_at": "2026-01-01T00:00:00.000Z"
}
],
"next_cursor": "string"
}Errors
Errors use the standard envelope. What this operation can answer:
| Status | Type | When |
|---|---|---|
400 | invalid_request_error | A parameter or body field is missing or not allowed; param names it. |
401 | authentication_error | The key or session is missing, revoked or expired. |
403 | permission_error | The credential lacks the permission this needs, or the organization is suspended. |
404 | not_found_error | No such resource in this project (an ID from another project is answered the same way). |
429 | rate_limit_error rate_limited | Too many requests; retry after retry-after seconds. |