Skip to main content
GET
/
batch
/
jobs
curl https://api.u1.archetypeai.app/v0.5/batch/jobs \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "total": 42,
  "offset": 0,
  "limit": 10,
  "jobs": [
    {
      "id": "job_2abc3def4ghi5jkl6mno7pqr",
      "org_id": "org_1abc2def3ghi4jkl",
      "name": "tep-classification",
      "pipeline_type": "batch",
      "pipeline_key": "machine-state-classification",
      "pipeline_version": "1.1.1",
      "status": "RUNNING",
      "parameters": {},
      "retry_count": 0,
      "preemption_count": 0,
      "queue_position": null,
      "queue_depth": null,
      "input_progress": {
        "pending": 0,
        "processing": 1,
        "completed": 2,
        "failed": 0
      },
      "created_at": "2026-04-14T10:00:00Z",
      "updated_at": "2026-04-14T10:05:00Z",
      "started_at": "2026-04-14T10:02:00Z",
      "completed_at": null,
      "failed_at": null,
      "cancelled_at": null,
      "error": null
    }
  ]
}

​
Overview

This endpoint returns a paginated list of jobs. You can filter by pipeline type, status, or a free-text search query.

​
Request

​
pipeline_type
string
Filter jobs by pipeline type (e.g., batch, training)
​
status
string
Filter jobs by status (e.g., PENDING, RUNNING, COMPLETED, FAILED, CANCELLED)
​
q
string
Free-text search query to filter jobs
​
offset
integer
Number of items to skip for pagination (default: 0)
​
limit
integer
Maximum number of items to return per page

​
Response

​
total
integer
Total number of jobs matching the filter criteria
​
offset
integer
Current pagination offset
​
limit
integer
Maximum number of items returned
​
jobs
array
Array of job objects, each containing:
  • id — Unique job identifier
  • org_id — Organization identifier
  • name — Job name
  • pipeline_type — Pipeline type (batch or training)
  • pipeline_key — Pipeline key
  • pipeline_version — Pipeline version
  • status — Current job status
  • parameters — Job parameters
  • retry_count — Number of retries
  • preemption_count — Number of preemptions
  • queue_position — Current position in queue (if queued)
  • queue_depth — Total queue depth (if queued)
  • input_progress — Per-status counts of tracked inputs (pending, processing, completed, failed); populated on this list endpoint, null on write-path responses
  • created_at — Creation timestamp
  • updated_at — Last update timestamp
  • started_at — Start timestamp (if started)
  • completed_at — Completion timestamp (if completed)
  • failed_at — Failure timestamp (if failed)
  • cancelled_at — Cancellation timestamp (if cancelled)
  • error — Error details (if failed)
curl https://api.u1.archetypeai.app/v0.5/batch/jobs \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "total": 42,
  "offset": 0,
  "limit": 10,
  "jobs": [
    {
      "id": "job_2abc3def4ghi5jkl6mno7pqr",
      "org_id": "org_1abc2def3ghi4jkl",
      "name": "tep-classification",
      "pipeline_type": "batch",
      "pipeline_key": "machine-state-classification",
      "pipeline_version": "1.1.1",
      "status": "RUNNING",
      "parameters": {},
      "retry_count": 0,
      "preemption_count": 0,
      "queue_position": null,
      "queue_depth": null,
      "input_progress": {
        "pending": 0,
        "processing": 1,
        "completed": 2,
        "failed": 0
      },
      "created_at": "2026-04-14T10:00:00Z",
      "updated_at": "2026-04-14T10:05:00Z",
      "started_at": "2026-04-14T10:02:00Z",
      "completed_at": null,
      "failed_at": null,
      "cancelled_at": null,
      "error": null
    }
  ]
}