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

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 3,
  "offset": 0,
  "limit": 20,
  "entries": [
    {
      "id": 501,
      "kind": "inference",
      "step": 1,
      "message": "Processing input 1 of 10",
      "metrics": {
        "percent_complete": 10,
        "items_processed": 1,
        "items_total": 10
      },
      "payload": {},
      "input_id": "inp_abc123def456",
      "index": 0,
      "created_at": "2026-04-14T10:03:00Z"
    },
    {
      "id": 502,
      "kind": "inference",
      "step": 2,
      "message": "Processing input 5 of 10",
      "metrics": {
        "percent_complete": 50,
        "items_processed": 5,
        "items_total": 10
      },
      "payload": {},
      "input_id": null,
      "index": null,
      "created_at": "2026-04-14T10:06:00Z"
    }
  ]
}

​
Overview

This endpoint returns a paginated list of progress entries reported during job execution. Progress entries provide real-time metrics and status updates as the job processes inputs.

​
Request

​
id
string
required
The unique job identifier
​
kind
string
Filter progress entries by kind
​
input_id
string
Filter progress entries associated with a specific input
​
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 progress entries matching the filter criteria
​
offset
integer
Current pagination offset
​
limit
integer
Maximum number of items returned
​
entries
array
Array of progress entry objects, each containing:
  • id — Unique progress entry identifier
  • kind — Type of progress entry
  • step — Step number within the processing sequence
  • message — Optional human-readable progress message
  • metrics — Metrics data (e.g., percentage complete, items processed)
  • payload — Additional progress-specific data
  • input_id — Associated input ID (if applicable)
  • index — Index within the input (if applicable)
  • created_at — Progress entry timestamp
curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/progress?limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 3,
  "offset": 0,
  "limit": 20,
  "entries": [
    {
      "id": 501,
      "kind": "inference",
      "step": 1,
      "message": "Processing input 1 of 10",
      "metrics": {
        "percent_complete": 10,
        "items_processed": 1,
        "items_total": 10
      },
      "payload": {},
      "input_id": "inp_abc123def456",
      "index": 0,
      "created_at": "2026-04-14T10:03:00Z"
    },
    {
      "id": 502,
      "kind": "inference",
      "step": 2,
      "message": "Processing input 5 of 10",
      "metrics": {
        "percent_complete": 50,
        "items_processed": 5,
        "items_total": 10
      },
      "payload": {},
      "input_id": null,
      "index": null,
      "created_at": "2026-04-14T10:06:00Z"
    }
  ]
}