--- title: "List Jobs" method: GET path: "/v1/training/jobs" tags: ["training"] --- # List Jobs `GET /v1/training/jobs` ## Request - Base URL: `https://api.fastino.ai` - URL: `https://api.fastino.ai/v1/training/jobs` - Auth: one of: - API key in header `X-API-Key` - HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) List training jobs, config and interactive (Tinker training runs), newest first by `created_at`, with `type` to list one type. `status` filters both: interactive jobs on their own statuses (`creating`, `active`, `stopping`, `stopped`, `failed`), with `running` matching active ones and `errored` failed ones. ## Query parameters - `type` 'config' | 'interactive', nullable - `status` string, nullable - `project_id` string, nullable - `limit` integer - `offset` integer ## Response `200` Successful Response - TrainingJobsPage: ``GET /v1/training/jobs``: config and interactive jobs (Tinker training runs), newest first, told apart by ``type``. Interactive jobs are listed only for a team on the training runs API. - `count` integer, required: Jobs on this page. - `has_more` boolean, required: True when more jobs follow this page. - `success` boolean - `total` integer, required: Matching jobs in all. - `training_jobs` union[], required - union - TrainingJobResponse: Training job response model - `artifact_ready` boolean, nullable: Whether an artifact location is recorded, so there is something to serve. - `base_model` string, required: The catalog base model the adapter was trained on (for an `interactive_checkpoint` model, the base of the interactive job it came from). - `batch_size` integer, nullable, required: Training batch size. Null for an `interactive_checkpoint` model. - `completed_at` string, nullable - `created_at` string, required - `current_epoch` integer, nullable: Epoch currently in progress (1-indexed). Updated live during training. - `datasets` DatasetReference[], required - `name` string, required: Dataset name - `version` string, nullable: Version (latest if omitted) - `deployability_reason` string, nullable: Why the job is not deployable (e.g. 'job_incomplete', 'missing_artifact', 'provider_incompatible', 'adapter_inference_unavailable'). Null when deployable. - `deployment_status` string, nullable, required: Deprecated. Always returns None -- deployment_status no longer exists. Kept for backward compat with clients that read this field. - `error_message` string, nullable - `example` string, nullable: Sample text to pre-load into inference input - `experiment_id` string, nullable: Experiment associated with this training job, when available. Null means no associated experiment was recorded. - `hub_model_id` string, nullable: HuggingFace repo id (e.g. 'username/model-name') set only after a successful push_training_job_to_hub call. This is the sole source of truth for whether a checkpoint has been pushed to the Hub -- it does not mean the repo is reachable by anyone other than the pusher: see hub_model_private for that. trained_model_path is an internal storage key and must never be parsed to infer a Hub repo id. - `hub_model_private` boolean, nullable: Whether the pushed Hub repository is private, as recorded at push time. Null means the job was not pushed or its repository visibility was not recorded. - `id` string, required - `instance_type` string, nullable - `is_deployable` boolean, nullable: Whether this job passes server-side deployability validation for its own project. Authoritative -- the same check the deployment endpoints enforce. - `is_terminal_status` boolean, nullable: Whether this status is terminal for polling loops - `job_reference` string, nullable - `labels` string[], nullable: Merged labels from training datasets (entity types for NER, class labels for classification) - `learning_rate` number, nullable, required: Learning rate. Null for an `interactive_checkpoint` model. - `metrics` object, nullable: Training and evaluation metrics dictionary. Contains final_training_loss, final_validation_loss, best_validation_loss from training logs, and optional evaluation metrics (f1_score, precision_score, recall_score, accuracy) if an evaluation has been run. - `model_auto_selected` boolean, nullable - `model_kind` 'lora' | 'full', nullable: Normalized fine-tune kind: 'lora' for adapters (lora/qlora) or 'full' for merged weights. Null when the persisted training type is unrecognised -- clients must not claim a kind in that case. - `model_name` string, nullable - `model_selection_reason` string, nullable - `normalized_status` string, nullable: Canonical status alias for compatibility handling (requested, running, complete, deployed, failed, cancelled) - `notices` TrainingNotice[]: Advisories to show alongside this job, such as the dedicated-endpoint serving terms for full fine-tunes. - `code` string, required: Stable machine-readable notice code. - `message` string, required: Customer-facing notice text. - `nr_epochs` integer, nullable, required: Training epochs. Null for an `interactive_checkpoint` model. - `progress_percent` integer, nullable: Overall training completion percentage (0-100). Updated live during training. - `project_id` string, nullable: Project ID this training job is associated with - `provider_deployments` object, nullable: Provider-specific deployment metadata written by the training monitor, keyed by provider: {"modal": {...}}. - `provider_name` string, nullable: Training provider that handled this job (e.g. 'modal'). Jobs predating a provider removal carry an 'archived_' label. - `provider_ready` boolean, nullable: Whether a provider is already serving this artifact. False is not a deployment blocker: promotion provisions or re-warms a provider. - `resolved_recipe` object, nullable: Immutable snapshot of what this job actually trained with, taken at dispatch: LoRA rank/alpha/dropout, learning rate, warmup ratio, gradient accumulation, packing, precision, attention backend, reasoning parser, container image, runtime profile, max sequence length, and seed, for every seed-capable provider/model. Null for jobs dispatched before the snapshot existed, and for providers that resolve no catalog recipe -- except Modal encoder and Modal RL strategies, which have no dense-LoRA catalog recipe but still return a non-null (seed) snapshot, since seed has no other persisted column. Read this rather than re-deriving from the catalog: the catalog reports what a job dispatched *today* would get, which is a different question. - `root_job_id` string, nullable: ID of the original/root training job this version derives from - `seed` integer, nullable: Effective reproducibility seed for Modal decoder or GLiNER2 (encoder) training. Null for Fireworks, unknown, and other providers/architectures that cannot honor this contract, and also null for a legacy Modal decoder/encoder job created before seed provenance was recorded, because its seed is unknown, and for an `interactive_checkpoint` model, which this job did not train. A non-null value is always a genuinely recorded seed. Decoder contract: A pinned seed governs LoRA initialisation and the trainer's own RNG (dataloader shuffle order and dropout). It does not select the train/validation split: that partition uses a dedicated split seed so two runs that differ only in `seed` are scored on the same held-out rows. It does not make runs bit-identical: GPU reduction order stays non-deterministic, so metrics can differ between otherwise identical runs. Across six observed same-config decoder pairs, final validation loss agreed to within 6.8% relative and two pairs agreed exactly. Treat that as an observed envelope from production history, not a guaranteed bound. Encoder contract: A pinned seed governs dataset shuffle and auto-sizing downsample order, and the trainer's own weight-initialisation and dropout RNG. It does not select the train/validation split on a Brain-dispatched run: that partition is a fixed left-to-right split derived from validation_data_percentage (validation is the tail), independent of seed, so two runs that differ only in `seed` are scored on the same held-out rows. Runs are seeded but not bit-identical: GPU reduction order stays non-deterministic (cuBLAS GEMM split-k, and the embedding-backward scatter_add/index_add path, which is not forced deterministic), so metrics can still differ between identically-configured runs. Before encoder seed control existed, three identically-configured launches measured classification macro-F1 ranging 0.38–0.63 — treat pinning a seed as removing one real, measured source of that noise, not as a guaranteed bound on the rest. Every GLiNER2 job unconditionally pins cuDNN's own algorithm selection (the same flags GLiNER2's bundled Trainer sets) -- this is a fixed container default, not a per-request knob. The cuDNN pin currently costs nothing and changes nothing on this backbone: cuDNN governs convolution/pooling/RNN kernels, and this encoder's DeBERTa-v2 backbone has none, so pinning it has nothing to pin there; the throughput trade-off only materializes if a future backbone adds conv/pooling/RNN layers. torch deterministic algorithms are not enabled: they would roughly halve training throughput without making runs bit-identical. - `source` 'config_training' | 'interactive_checkpoint': How the model came to exist: `config_training` for a job Fastino trained from data and a config, `interactive_checkpoint` for a sampler checkpoint of an interactive job served as a model (`POST /v1/training/jobs/{job_id}/checkpoints/sampler_weights/{name}/deploy`). An `interactive_checkpoint` model ran no training of its own, so it lists no datasets and its training settings are null. - `started_at` string, nullable - `status` string, required - `task_type` string, nullable: Task type derived from training datasets: 'ner', 'classification', 'custom', or 'decoder' - `trained_model_path` string, nullable - `training_type` string, nullable: Raw training method as persisted: 'lora', 'qlora', or 'full'. - `type` 'config': A config training job (you give data and a config, Fastino runs the loop). ``/v1/trained-models`` also lists interactive jobs (``type: interactive``). - `updated_at` string, required - `user_id` string, required - `validation_data_percentage` number, nullable, required: Share of the data held out for validation (0-1). Null for an `interactive_checkpoint` model. - `version_number` string, nullable: Version number for this training job (e.g., '1', '2', '3') - InteractiveJobView: An ``interactive`` training job: a Tinker training run, its run id being the job id. - `base_model` string, required - `corrupted` boolean - `created_at` string, date-time, required: When the job was created; the job list is newest first across both types. - `error_message` string, nullable: Why creating the job failed, when `status` is `failed`; null otherwise. - `id` string, required: The job's id, the same value as `job_id`: the field a config job's id is in, so one field reads both. - `is_lora` boolean - `is_terminal_status` boolean, required: Whether `status` is final (`stopped` or `failed`), so a polling loop can stop. - `job_id` string, required: The job's id, the same value as `training_run_id`: the `job_id` that create-model returned and that every /v1/training/jobs/{job_id} route takes. - `last_checkpoint` CheckpointView: A checkpoint (the SDK's ``Checkpoint``). - `checkpoint_id` string, required - `checkpoint_type` 'training' | 'sampler', required - `expires_at` string, date-time, nullable - `public` boolean - `size_bytes` integer, nullable - `time` string, date-time, required - `tinker_path` string, required: The checkpoint's tinker:// path, which the SDK addresses it by. - `user_metadata` object, nullable - `last_request_time` string, date-time, required - `last_sampler_checkpoint` CheckpointView: A checkpoint (the SDK's ``Checkpoint``). - `checkpoint_id` string, required - `checkpoint_type` 'training' | 'sampler', required - `expires_at` string, date-time, nullable - `public` boolean - `size_bytes` integer, nullable - `time` string, date-time, required - `tinker_path` string, required: The checkpoint's tinker:// path, which the SDK addresses it by. - `user_metadata` object, nullable - `lora_rank` integer, nullable - `model_owner` string, required - `status` 'creating' | 'active' | 'stopping' | 'stopped' | 'failed', required: `creating`: its adapter is being created. `active`: it takes training and sampling calls. `stopping`: a stop was requested or its session ended, and calls already queued are finishing before its adapter is released; it takes no new training calls. `stopped`: its adapter is released and its checkpoints are kept. `failed`: creating it failed, see `error_message`. - `stop_reason` 'requested' | 'idle_timeout' | 'session_finished' | 'session_errored', nullable: Why a `stopping` or `stopped` job stopped; null in any other status, and for a copy of a checkpoint made through the SDK (which never trained). `requested`: a stop was requested (POST /v1/training/jobs/{job_id}/stop, the SDK's `unload_model`, or a cancel of the agent task that ran it). `idle_timeout`: its session went idle (no call for 30 minutes on a job created through this API, no SDK heartbeat for 5 minutes on an SDK session). `session_finished`: the SDK client that created it closed its session. `session_errored`: that session ended on an error or an interruption, or creating the job failed. - `training_run_id` string, required - `type` 'interactive' - `user_metadata` object, nullable ## Other responses - `422`: Validation Error ## Changes - **2026-10-15** `5efbc8b70225`: 4 breaking, 3 info - response property `training_jobs/items/oneOf[subschema #1: TrainingJobResponse]/batch_size` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `training_jobs/items/oneOf[subschema #1: TrainingJobResponse]/learning_rate` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `training_jobs/items/oneOf[subschema #1: TrainingJobResponse]/nr_epochs` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `training_jobs/items/oneOf[subschema #1: TrainingJobResponse]/validation_data_percentage` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - …3 more - **2026-10-15** `ef285860f952`: 5 info - added the optional property `training_jobs/items/oneOf[subschema #2: InteractiveJobView]/error_message` to the response with the `200` status - added the optional property `training_jobs/items/oneOf[subschema #2: InteractiveJobView]/stop_reason` to the response with the `200` status - added the required property `training_jobs/items/oneOf[subschema #2: InteractiveJobView]/is_terminal_status` to the response with the `200` status - added the required property `training_jobs/items/oneOf[subschema #2: InteractiveJobView]/job_id` to the response with the `200` status - …1 more - …earlier changes not shown [Operation history](https://skmtc.dev/fastino-ai/apis/pioneer-inference-api/changes/v1/training/jobs/get.md) --- [API](https://skmtc.dev/fastino-ai/apis/pioneer-inference-api.md) - [All operations](https://skmtc.dev/fastino-ai/apis/pioneer-inference-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fastino-ai/apis/pioneer-inference-api/revisions/81465e18c1d2?raw)