Skip to content
Hayonix

API reference · Fine-tuning

A job's checkpoints, oldest first

GET/v1/fine-tunes/{fine_tune_id}/checkpoints
API keyfine_tune_job:readProjectPaginated
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

Headers
HeaderRequiredDescription
AuthorizationyesBearer and your API key. The key implies its project.
X-Project-Idsession onlyThe project to act in, for console sessions. Requests with an API key leave it out.

Path parameters

  • fine_tune_idstringrequired

    ID of the fine-tuning job

    ID with prefix ftj_

Query parameters

  • limitinteger

    1–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.

    Show 9 fields of data
    • idstringrequired

      Unique ID (`ftc_…`)

      ID with prefix ftc_

    • objectstringrequired

      Always `fine_tune_checkpoint`: the type of this object

      One offine_tune_checkpoint

    • fine_tune_idstringrequired

      ID of the fine-tuning job

      ID with prefix ftj_

    • stepintegerrequired

      Optimizer step the checkpoint was saved at

    • epochnumber | nullrequired

      Epoch at that step, fractional; null when not reported

    • finalbooleanrequired

      The checkpoint saved at the end of training (the result model)

    • artifactsarray of FineTuneArtifactrequired

      What the checkpoint holds: the adapter, weights, and any serving formats

      Show 4 fields of artifacts
      • namestringrequired

        Its name

        One ofadapterweightsmergedadapter_ggufmerged_gguf

      • formatstringrequired

        File format of the artefact

      • bytesintegerrequired

        Size in bytes

      • filesarray of objectrequired

        The files that make up the artefact

        Show 3 fields of files
        • pathstringrequired

          Path of the file inside the artefact

        • bytesintegerrequired

          Size in bytes

        • sha256stringrequired

          SHA-256 of the content, hex

    • bytesintegerrequired

      Size in bytes

    • created_atstring (date-time)required

      When it was created (ISO 8601, UTC)

  • next_cursorstring | nullrequired

    Pass as `cursor` for the next page; null on the last page.

Example response
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:

Errors
StatusTypeWhen
400invalid_request_errorA parameter or body field is missing or not allowed; param names it.
401authentication_errorThe key or session is missing, revoked or expired.
403permission_errorThe credential lacks the permission this needs, or the organization is suspended.
404not_found_errorNo such resource in this project (an ID from another project is answered the same way).
429rate_limit_error rate_limitedToo many requests; retry after retry-after seconds.