Skip to main content
GET
/
v1
/
jobs
/
{job_id}
Fetch job status
curl --request GET \
  --url https://api.example.com/v1/jobs/{job_id} \
  --header 'Authorization: Bearer <token>'
{
  "created_at": "2026-04-21T14:15:00+00:00",
  "id": "dddd1111-eeee-2222-ffff-333344445555",
  "job_type": "humanization",
  "status": "pending",
  "variant_id": "11112222-3333-4444-5555-666677778888"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
job_id
string<uuid>
required

Response

Successful Response

A pipeline job's status envelope.

​
id
string
required

Opaque job identifier (UUID).

Example:

"dddd1111-eeee-2222-ffff-333344445555"

​
variant_id
string
required

Variant this job is running against.

Example:

"11112222-3333-4444-5555-666677778888"

​
job_type
string
required

One of: humanization, structure, stability, immunogenicity.

Example:

"humanization"

​
status
string
required

One of: pending, running, completed, failed.

Example:

"pending"

​
created_at
string
required

ISO-8601 timestamp when the job was submitted.

Example:

"2026-04-21T14:15:00+00:00"

​
started_at
string | null

ISO-8601 timestamp when execution started. null while pending.

Example:

"2026-04-21T14:15:02+00:00"

​
completed_at
string | null

ISO-8601 timestamp when execution finished. null until completed or failed.

Example:

null

​
error_message
string | null

Human-readable failure reason. Populated only when status=failed.

Example:

null