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

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 5,
  "offset": 0,
  "limit": 20,
  "events": [
    {
      "id": 1001,
      "event_type": "inference.success",
      "level": "SUCCESS",
      "message": "Inference completed for input",
      "payload": {
        "duration_ms": 1250
      },
      "input_id": "inp_abc123def456",
      "index": 0,
      "created_at": "2026-04-14T10:05:00Z"
    },
    {
      "id": 1002,
      "event_type": "inference.failed",
      "level": "FAILED",
      "message": "Input file format not supported",
      "payload": {
        "error_code": "UNSUPPORTED_FORMAT"
      },
      "input_id": "inp_ghi789jkl012",
      "index": 1,
      "created_at": "2026-04-14T10:05:30Z"
    }
  ]
}

​
Overview

This endpoint returns a paginated list of events emitted during job execution. Events provide observability into what happened during processing, including informational messages, warnings, errors, and terminal outcomes.

​
Request

​
id
string
required
The unique job identifier
​
level
string
Filter events by level: INFO, WARN, ERROR, SUCCESS, or FAILED
​
event_type
string
Filter events by type (e.g., inference.success, inference.failed)
​
input_id
string
Filter events 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 events matching the filter criteria
​
offset
integer
Current pagination offset
​
limit
integer
Maximum number of items returned
​
events
array
Array of event objects, each containing:
  • id — Unique event identifier
  • event_type — Type of event (e.g., inference.success)
  • level — Event level: INFO, WARN, ERROR, SUCCESS, or FAILED
  • message — Optional human-readable message
  • payload — Event-specific data
  • input_id — Associated input ID (if applicable)
  • index — Event index within the input (if applicable)
  • created_at — Event timestamp
curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/events?level=ERROR&limit=20" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 5,
  "offset": 0,
  "limit": 20,
  "events": [
    {
      "id": 1001,
      "event_type": "inference.success",
      "level": "SUCCESS",
      "message": "Inference completed for input",
      "payload": {
        "duration_ms": 1250
      },
      "input_id": "inp_abc123def456",
      "index": 0,
      "created_at": "2026-04-14T10:05:00Z"
    },
    {
      "id": 1002,
      "event_type": "inference.failed",
      "level": "FAILED",
      "message": "Input file format not supported",
      "payload": {
        "error_code": "UNSUPPORTED_FORMAT"
      },
      "input_id": "inp_ghi789jkl012",
      "index": 1,
      "created_at": "2026-04-14T10:05:30Z"
    }
  ]
}