RL

List checkpoints

Changed on

Lists training and inference checkpoints owned by the caller, newest first. Filter by type, session, or base model, for example to recover a checkpoint ID for resume.

get/v1/rl/checkpoints

Request

  • Base URL
    https://api.together.ai
  • URL
    https://api.together.ai/v1/rl/checkpoints
  • Auth
    HTTP bearer

Query parameters

session_idstring

Only return checkpoints produced by this training session

base_modelstring

Only return checkpoints trained from this base model. Match is exact.

limitinteger

Maximum number of checkpoints to return (1-100)

afterstring

Cursor for pagination (ID of the last checkpoint from the previous page)

type'CHECKPOINT_TYPE_TRAINING' | 'CHECKPOINT_TYPE_INFERENCE'

Only return checkpoints of this type. CHECKPOINT_TYPE_TRAINING is the full training state (weights and optimizer state), for resuming a training session with its optimizer state; CHECKPOINT_TYPE_INFERENCE is a model ready for serving or download, also added to your models. When set, it must be CHECKPOINT_TYPE_TRAINING or CHECKPOINT_TYPE_INFERENCE; when omitted, checkpoints of both types are returned.

Response

List of checkpoints

Example response

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "session_id": "123e4567-e89b-12d3-a456-426614174000",
      "base_model": "Qwen/Qwen3.5-4B",
      "lora_rank": 32,
      "created_at": "2026-01-02T00:00:00Z",
      "inference_registration": {
        "model": {
          "id": "ml_abc123",
          "revision_id": "rv_def456"
        },
        "adapter": {
          "id": "ml_abc123",
          "revision_id": "rv_def456"
        }
      },
      "training_registration": {
        "id": "ml_abc123",
        "revision_id": "rv_def456"
      }
    }
  ],
  "meta": {
    "limit": 20,
    "has_more": true,
    "next_cursor": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Changes