> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List training jobs with status, type, and project filters

> Retrieve a list of your training jobs filtered by status, type, or project. Returns up to 100 jobs with the latest progress snapshot.

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

```http theme={null}
GET /v1/jobs
```

## Authentication

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

```http theme={null}
Authorization: Bearer <token>
```

## Query parameters

<ParamField query="status" type="string" optional>
  Filter by job status. Allowed values: `queued`, `running`, `paused`, `stopped`, `succeeded`, `failed`, `cancelled`, `intervening`.
</ParamField>

<ParamField query="type" type="string" optional>
  Filter by training type. Allowed values: `sft`, `opd`, `pretrain`, `distill`, `qat`, `grpo`, `dpo`, `kto`, `orpo`, `simpo`, `ppo`.
</ParamField>

<ParamField query="project" type="string" optional>
  Filter by project or base model name prefix.
</ParamField>

## Request example

<CodeGroup>
  ```bash curl theme={null}
  curl -s "https://api.ariacompute.com/v1/jobs?status=running&type=sft" \
    -H "Authorization: Bearer $PIN_API_TOKEN"
  ```
</CodeGroup>

## Response

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

<ResponseField name="code" type="integer" required>
  `0` on success, nonzero on error.
</ResponseField>

<ResponseField name="data" type="object" required>
  <Expandable title="properties">
    <ResponseField name="items" type="array" required>
      List of job objects.

      <Expandable title="job object">
        <ResponseField name="job_id" type="string">
          Unique job identifier (e.g., `jb_...`).
        </ResponseField>

        <ResponseField name="type" type="string">
          Training type: `sft`, `opd`, `pretrain`, `distill`, `qat`, `grpo`, `dpo`, `kto`, `orpo`, `simpo`, `ppo`.
        </ResponseField>

        <ResponseField name="base_model" type="string">
          Base model name from the catalog.
        </ResponseField>

        <ResponseField name="teacher_model" type="string">
          Frozen teacher model for OPD or distill.
        </ResponseField>

        <ResponseField name="lora" type="object">
          LoRA/QLoRA/DoRA configuration.
        </ResponseField>

        <ResponseField name="hyperparams" type="object">
          Training hyperparameters.
        </ResponseField>

        <ResponseField name="auto_intervention" type="object">
          Auto-intervention configuration if enabled.
        </ResponseField>

        <ResponseField name="dataset_id" type="string">
          Linked dataset identifier.
        </ResponseField>

        <ResponseField name="status" type="string">
          Current job status.
        </ResponseField>

        <ResponseField name="dispatch_status" type="string">
          Controller dispatch state.
        </ResponseField>

        <ResponseField name="agent_id" type="string">
          ID of the agent executing the job.
        </ResponseField>

        <ResponseField name="gpu_index" type="integer">
          GPU index assigned to the job.
        </ResponseField>

        <ResponseField name="mlflow_run_id" type="string">
          MLflow run identifier.
        </ResponseField>

        <ResponseField name="mlflow_url" type="string">
          Direct URL to the MLflow run.
        </ResponseField>

        <ResponseField name="error" type="string">
          Last error message if any.
        </ResponseField>

        <ResponseField name="progress" type="object">
          Latest step metrics.

          <Expandable title="properties">
            <ResponseField name="step" type="integer">
              Training step.
            </ResponseField>

            <ResponseField name="loss" type="number">
              Latest loss value.
            </ResponseField>

            <ResponseField name="reward" type="number">
              Latest reward value (RL jobs).
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="created_at" type="string">
          ISO 8601 creation timestamp.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable message (empty on success).
</ResponseField>

### Example response

```json theme={null}
{
  "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.


## Related topics

- [List Replayable Router Requests API](/api-reference/router/replay/list.md)
- [Pause, resume, start, or stop a training job](/api-reference/pin/jobs/lifecycle.md)
- [Report Training Metrics and Status - Node Agent](/api-reference/pin/node-agent/metrics.md)
- [List All Training Checkpoints - PIN API](/api-reference/pin/checkpoints/list.md)
- [Aria Compute PIN API: Post-Training & Evaluation](/api-reference/pin/introduction.md)