curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/progress?limit=20" \
-H "Authorization: Bearer $ATAI_API_KEY"
import requests
import os
api_key = os.environ.get("ATAI_API_KEY")
job_id = "job_2abc3def4ghi5jkl6mno7pqr"
response = requests.get(
f"https://api.u1.archetypeai.app/v0.5/batch/jobs/{job_id}/progress",
headers={"Authorization": f"Bearer {api_key}"},
params={"limit": 20}
)
data = response.json()
print(f"Total progress entries: {data['total']}")
for entry in data["entries"]:
print(f" Step {entry['step']}: {entry.get('message', '')} — {entry['metrics']}")
const jobId = 'job_2abc3def4ghi5jkl6mno7pqr';
const params = new URLSearchParams({ limit: '20' });
const response = await fetch(`https://api.u1.archetypeai.app/v0.5/batch/jobs/${jobId}/progress?${params}`, {
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
});
const data = await response.json();
console.log(`Total progress entries: ${data.total}`);
data.entries.forEach(entry => {
console.log(` Step ${entry.step}: ${entry.message || ''}`);
});
{
"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"
}
]
}
{
"code": "NOT_FOUND",
"message": "Job not found",
"error_uid": "err_abc123"
}
{
"detail": "Invalid access with key: api_key_not_found"
}
Progress
List Job Progress
Retrieve paginated progress entries for a specific job
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"
import requests
import os
api_key = os.environ.get("ATAI_API_KEY")
job_id = "job_2abc3def4ghi5jkl6mno7pqr"
response = requests.get(
f"https://api.u1.archetypeai.app/v0.5/batch/jobs/{job_id}/progress",
headers={"Authorization": f"Bearer {api_key}"},
params={"limit": 20}
)
data = response.json()
print(f"Total progress entries: {data['total']}")
for entry in data["entries"]:
print(f" Step {entry['step']}: {entry.get('message', '')} — {entry['metrics']}")
const jobId = 'job_2abc3def4ghi5jkl6mno7pqr';
const params = new URLSearchParams({ limit: '20' });
const response = await fetch(`https://api.u1.archetypeai.app/v0.5/batch/jobs/${jobId}/progress?${params}`, {
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
});
const data = await response.json();
console.log(`Total progress entries: ${data.total}`);
data.entries.forEach(entry => {
console.log(` Step ${entry.step}: ${entry.message || ''}`);
});
{
"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"
}
]
}
{
"code": "NOT_FOUND",
"message": "Job not found",
"error_uid": "err_abc123"
}
{
"detail": "Invalid access with key: api_key_not_found"
}
Requires version 1.1.0 or later of the Archetype platform.
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
string
required
The unique job identifier
string
Filter progress entries by kind
string
Filter progress entries associated with a specific input
integer
Number of items to skip for pagination (default: 0)
integer
Maximum number of items to return per page
Response
string
The job identifier
integer
Total number of progress entries matching the filter criteria
integer
Current pagination offset
integer
Maximum number of items returned
array
Array of progress entry objects, each containing:
id— Unique progress entry identifierkind— Type of progress entrystep— Step number within the processing sequencemessage— Optional human-readable progress messagemetrics— Metrics data (e.g., percentage complete, items processed)payload— Additional progress-specific datainput_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"
import requests
import os
api_key = os.environ.get("ATAI_API_KEY")
job_id = "job_2abc3def4ghi5jkl6mno7pqr"
response = requests.get(
f"https://api.u1.archetypeai.app/v0.5/batch/jobs/{job_id}/progress",
headers={"Authorization": f"Bearer {api_key}"},
params={"limit": 20}
)
data = response.json()
print(f"Total progress entries: {data['total']}")
for entry in data["entries"]:
print(f" Step {entry['step']}: {entry.get('message', '')} — {entry['metrics']}")
const jobId = 'job_2abc3def4ghi5jkl6mno7pqr';
const params = new URLSearchParams({ limit: '20' });
const response = await fetch(`https://api.u1.archetypeai.app/v0.5/batch/jobs/${jobId}/progress?${params}`, {
headers: {
'Authorization': `Bearer ${process.env.ATAI_API_KEY}`
}
});
const data = await response.json();
console.log(`Total progress entries: ${data.total}`);
data.entries.forEach(entry => {
console.log(` Step ${entry.step}: ${entry.message || ''}`);
});
{
"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"
}
]
}
{
"code": "NOT_FOUND",
"message": "Job not found",
"error_uid": "err_abc123"
}
{
"detail": "Invalid access with key: api_key_not_found"
}
Was this page helpful?