List training jobs with status, type, and project filters

The PIN API lets you list all training jobs in your account. Each entry includes the latest training progress, dispatch status, and hyperparameter summary so you can scan the state of your workload at a glance.

Method + Path

GET /v1/jobs

Authentication

Include your PIN API token or JWT in the Authorization header as a Bearer token.

Authorization: Bearer <token>

Query parameters

string

Filter by job status. Allowed values: queued, running, paused, stopped, succeeded, failed, cancelled, intervening.

string

Filter by training type. Allowed values: sft, opd, pretrain, distill, qat, grpo, dpo, kto, orpo, simpo, ppo.

string

Filter by project or base model name prefix.

Request example

curl -s "https://api.ariacompute.com/v1/jobs?status=running&type=sft" \
  -H "Authorization: Bearer $PIN_API_TOKEN"

Response

Returns a standard PIN success envelope with a list of jobs under data.items.

integer

required

0 on success, nonzero on error.

object

required

Show properties

array

required

List of job objects.

Show job object

string

Unique job identifier (e.g., jb_...).

string

Training type: sft, opd, pretrain, distill, qat, grpo, dpo, kto, orpo, simpo, ppo.

string

Base model name from the catalog.

string

Frozen teacher model for OPD or distill.

object

LoRA/QLoRA/DoRA configuration.

object

Training hyperparameters.

object

Auto-intervention configuration if enabled.

string

Linked dataset identifier.

string

Current job status.

string

Controller dispatch state.

string

ID of the agent executing the job.

integer

GPU index assigned to the job.

string

MLflow run identifier.

string

Direct URL to the MLflow run.

string

Last error message if any.

object

Latest step metrics.

Show properties

integer

Training step.

number

Latest loss value.

number

Latest reward value (RL jobs).

string

ISO 8601 creation timestamp.

string

Human-readable message (empty on success).

Example response

{
  "code": 0,
  "data": {
    "items": [
      {
        "job_id": "jb_abc123def456",
        "type": "sft",
        "base_model": "meta-llama/Llama-3-8B",
        "lora": {
          "method": "lora",
          "rank": 16,
          "alpha": 32,
          "lora_dropout": 0.05,
          "target_modules": ["q_proj", "v_proj"],
          "quantization": "4bit_nf4"
        },
        "hyperparams": {
          "epochs": 3,
          "lr": 0.00002,
          "max_length": 2048
        },
        "dataset_id": "ds_xyz789",
        "status": "running",
        "dispatch_status": "running",
        "agent_id": "ag_node01_001",
        "gpu_index": 0,
        "progress": {
          "step": 1240,
          "loss": 0.8234
        },
        "created_at": "2025-01-15T09:23:17Z"
      }
    ]
  },
  "message": ""
}

Errors

Code	HTTP	Meaning
401	401	Missing or invalid Bearer token.
500	500	Internal server error.

The endpoint returns at most 100 jobs, sorted by created_at descending.

PIN API

ROUTER API

AGENT API

List training jobs with status, type, and project filters

Method + Path

Authentication

Query parameters

Request example

Response

Example response

Errors

​Method + Path

​Authentication

​Query parameters

​Request example

​Response

​Example response

​Errors

Method + Path

Authentication

Query parameters

Request example

Response

Example response

Errors