Skip to main content
GET
/
batch
/
jobs
/
{id}
/
inputs
/
progress
curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/inputs/progress?status=processing&status=pending&order=desc&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 1,
  "offset": 0,
  "limit": 20,
  "items": [
    {
      "input": {
        "id": "inp_abc123def456",
        "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
        "port_name": "worker.inference",
        "file_id": "file_abc123",
        "data": {
          "ref": "https://storage.example.com/files/tep_inference.csv",
          "filename": "tep_inference.csv",
          "file_type": "text/csv",
          "file_extension": ".csv",
          "num_bytes": 245760,
          "metadata": {}
        },
        "status": "processing",
        "error_message": null,
        "created_at": "2026-04-14T10:00:00Z",
        "completed_at": null
      },
      "latest_progress": {
        "id": 502,
        "kind": "inference",
        "step": 5,
        "metrics": {
          "percent_complete": 50,
          "items_processed": 5,
          "items_total": 10
        },
        "payload": {},
        "input_id": "inp_abc123def456",
        "index": 0,
        "message": "Processing input 5 of 10",
        "created_at": "2026-04-14T10:06:00Z"
      },
      "step": null
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.archetypeai.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

This endpoint returns tracked inputs for a job, each paired with its most recent job_progress row (if any). Use it to drive per-input progress UIs without N+1 fetches against the progress endpoint. Inputs attached to non-tracked ports (e.g. n-shot reference files) are always excluded.

​
Request

​
id
string
required
The unique job identifier
​
port_name
string
Scope results to a single input port (e.g. worker.inference)
​
status
array
Statuses to include. Repeat the param to specify several (?status=pending&status=processing). Accepts pending, processing, completed, failed. The reference status is always excluded.
​
order
string
Sort direction within each status bucket. asc (default) puts the oldest first; desc puts the most recently active inputs at the top.
​
offset
integer
Number of items to skip for pagination (default: 0)
​
limit
integer
Maximum number of items to return per page

​
Response

​
job_id
string
The job identifier
​
total
integer
Total number of tracked inputs matching the filter criteria
​
offset
integer
Current pagination offset
​
limit
integer
Maximum number of items returned
​
items
array
Array of InputWithLatestProgress objects, each containing:
  • input — The InputResponse (same shape as List Inputs)
  • latest_progress — The most recent job_progress row for this input, or null if none yet
  • step — 1-indexed completion rank across the whole job, ordered by completed_at. null for inputs still in pending or processing — assigned only when the input reaches completed or failed. Ties (same completed_at) are broken by input id. Distinct from latest_progress.step, which is the container-reported training/inference step inside a single input.
curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/inputs/progress?status=processing&status=pending&order=desc&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 1,
  "offset": 0,
  "limit": 20,
  "items": [
    {
      "input": {
        "id": "inp_abc123def456",
        "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
        "port_name": "worker.inference",
        "file_id": "file_abc123",
        "data": {
          "ref": "https://storage.example.com/files/tep_inference.csv",
          "filename": "tep_inference.csv",
          "file_type": "text/csv",
          "file_extension": ".csv",
          "num_bytes": 245760,
          "metadata": {}
        },
        "status": "processing",
        "error_message": null,
        "created_at": "2026-04-14T10:00:00Z",
        "completed_at": null
      },
      "latest_progress": {
        "id": 502,
        "kind": "inference",
        "step": 5,
        "metrics": {
          "percent_complete": 50,
          "items_processed": 5,
          "items_total": 10
        },
        "payload": {},
        "input_id": "inp_abc123def456",
        "index": 0,
        "message": "Processing input 5 of 10",
        "created_at": "2026-04-14T10:06:00Z"
      },
      "step": null
    }
  ]
}