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

{
  "id": "job_2abc3def4ghi5jkl6mno7pqr",
  "org_id": "org_1abc2def3ghi4jkl",
  "name": "image-classification-run",
  "pipeline_type": "batch",
  "pipeline_key": "image-classifier",
  "pipeline_version": "1.2.0",
  "status": "COMPLETED",
  "parameters": {
    "classifier": {
      "parallelism": 2,
      "config": {
        "model": "resnet50",
        "threshold": 0.8
      }
    }
  },
  "retry_count": 0,
  "preemption_count": 0,
  "queue_position": null,
  "queue_depth": null,
  "created_at": "2026-04-14T10:00:00Z",
  "updated_at": "2026-04-14T10:15:00Z",
  "started_at": "2026-04-14T10:02:00Z",
  "completed_at": "2026-04-14T10:15:00Z",
  "failed_at": null,
  "cancelled_at": null,
  "error": 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 the full details of a specific job, including its current status, parameters, and timestamps.

​
Request

​
id
string
required
The unique job identifier

​
Response

​
id
string
Unique job identifier
​
org_id
string
Organization identifier
​
name
string
Job name
​
pipeline_type
string
Pipeline type (batch or training)
​
pipeline_key
string
Pipeline key
​
pipeline_version
string
Pipeline version used
​
status
string
Current job status: PENDING, ADMITTED, RUNNING, COMPLETED, FAILED, PREEMPTED, or CANCELLED
​
parameters
object
Job parameters
​
retry_count
integer
Number of times the job has been retried
​
preemption_count
integer
Number of times the job has been preempted
​
queue_position
integer
Current position in queue (null if not queued)
​
queue_depth
integer
Total queue depth (null if not queued)
​
created_at
string
Creation timestamp
​
updated_at
string
Last update timestamp
​
started_at
string
Start timestamp (null if not yet started)
​
completed_at
string
Completion timestamp (null if not completed)
​
failed_at
string
Failure timestamp (null if not failed)
​
cancelled_at
string
Cancellation timestamp (null if not cancelled)
​
error
object
Error details (null if no error)
curl https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "id": "job_2abc3def4ghi5jkl6mno7pqr",
  "org_id": "org_1abc2def3ghi4jkl",
  "name": "image-classification-run",
  "pipeline_type": "batch",
  "pipeline_key": "image-classifier",
  "pipeline_version": "1.2.0",
  "status": "COMPLETED",
  "parameters": {
    "classifier": {
      "parallelism": 2,
      "config": {
        "model": "resnet50",
        "threshold": 0.8
      }
    }
  },
  "retry_count": 0,
  "preemption_count": 0,
  "queue_position": null,
  "queue_depth": null,
  "created_at": "2026-04-14T10:00:00Z",
  "updated_at": "2026-04-14T10:15:00Z",
  "started_at": "2026-04-14T10:02:00Z",
  "completed_at": "2026-04-14T10:15:00Z",
  "failed_at": null,
  "cancelled_at": null,
  "error": null
}