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

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 2,
  "offset": 0,
  "limit": 10,
  "outputs": [
    {
      "id": "out_abc123def456",
      "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
      "port_name": "worker.results",
      "input_id": "inp_abc123def456",
      "input_file_id": "file_abc123",
      "data": {
        "ref": "https://storage.example.com/outputs/result1.json?X-Amz-Signature=...",
        "filename": "result1.json",
        "file_type": "application/json",
        "file_extension": ".json",
        "num_bytes": 1024,
        "metadata": {}
      },
      "expires_at": "2026-04-14T11:00:00Z",
      "created_at": "2026-04-14T10:10:00Z"
    }
  ]
}

​
Overview

This endpoint returns a paginated list of output files produced by a job. You can filter by port name or input ID to find specific results.

​
Request

​
id
string
required
The unique job identifier
​
port_name
string
Filter outputs by port name
​
input_id
string
Filter outputs 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 outputs matching the filter criteria
​
offset
integer
Current pagination offset
​
limit
integer
Maximum number of items returned
​
outputs
array
Array of output objects, each containing:
  • id — Unique output identifier
  • job_id — Parent job identifier
  • port_name — Output port name
  • input_id — Associated input ID (if applicable)
  • input_file_id — file_id of the source input (if applicable)
  • data — Data reference (DataRef) with required ref (presigned download URL) and filename, plus optional file_type, file_extension, num_bytes, metadata, file_tags, file_attributes
  • expires_at — Expiration timestamp for the presigned download URL (re-fetch after this time)
  • created_at — Creation timestamp
curl "https://api.u1.archetypeai.app/v0.5/batch/jobs/job_2abc3def4ghi5jkl6mno7pqr/outputs?port_name=worker.results&limit=10" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
  "total": 2,
  "offset": 0,
  "limit": 10,
  "outputs": [
    {
      "id": "out_abc123def456",
      "job_id": "job_2abc3def4ghi5jkl6mno7pqr",
      "port_name": "worker.results",
      "input_id": "inp_abc123def456",
      "input_file_id": "file_abc123",
      "data": {
        "ref": "https://storage.example.com/outputs/result1.json?X-Amz-Signature=...",
        "filename": "result1.json",
        "file_type": "application/json",
        "file_extension": ".json",
        "num_bytes": 1024,
        "metadata": {}
      },
      "expires_at": "2026-04-14T11:00:00Z",
      "created_at": "2026-04-14T10:10:00Z"
    }
  ]
}
Output download URLs are presigned and expire at the time indicated by expires_at. Re-fetch the outputs list to get fresh URLs after expiration.