Jobs

Get job results

GET
/jobs/{job_id}/results

Will return partial results while job is still processing. Only returns the latest version of each image (image_index, group_index).

For identity_preprocessing jobs, returns information about the processed identity rather than image results.

Authorization

token_auth
headerAuthorizationBearer <token>

Token-based authentication using access tokens.

Path Parameters

job_id*string

Query Parameters

tag_ids?array<string>|

Optional: only return slots (image_index, group_index) that have at least one of these tags assigned (OR semantics). Wire format is a repeated query param: ?tag_ids=a&tag_ids=b.

Defaultnull

Response Body

Successful Response

application/json
  1. response

Response containing job results with partial results while processing.

should_post_process*Should Post Process

Indicates if post-processing is required for the batch job.

post_processing_status*|

Current status of the post-processing step.

post_processing_error?|

Error message from post-processing if present.

Defaultnull
error_message*|

Error message if the batch job encountered an error.

total_images*Total Images

Total number of images to be processed in the batch job.

processed_images*Processed Images

Number of images that have been processed so far.

created_at*Created At

Creation datetime (UTC) in ISO 8601 format.

updated_at*Updated At

Last updated datetime (UTC) in ISO 8601 format.

job_id*Job Id

Unique identifier for the batch job.

job_type*|

Type of batch job (e.g., 'model_swap', 'flat_2_model').

status*Status

Current status of the batch job.

identity_code*|

Identity code associated with the batch job.

identity_name*|

Human-readable name of the identity associated with the batch job.

project_id*|

ID of the project associated with the batch job.

project_text*|

Human-readable name of the project.

project_key*|

Project key identifier (e.g., 'swift-wolf-555') used in S3 paths.

progress*Progress

Progress percentage of the batch job.

processing_options?|

Processing options used for this job.

Defaultnull
created_by*|

Username of the project's creator.

results*array<>

List of image results.

summary*

Summary statistics for the job results.

credits_used?|

Total credits used for this job (only available after completion).

Defaultnull
anchor_index?|

For flat_2_model jobs: instruction index whose output served as the anchor (group_index 0). null when the job did not use anchor generation.

Defaultnull
review_summary?|

Review summary statistics (only present when images are in review).

Defaultnull
preset_extraction_inputs?array<>|

For preset_extraction jobs: the source images whose contents produced the resulting preset(s)/category. None for other job types and for the text-extraction sub-case (which has no input image).

Defaultnull
detail_repair_references?array<>|

For detail_repair jobs: the reference shots that were used as ground truth (stored in processing_options.reference_keys). Each carries its UploadedImage uuid (and tags) so the client can both display them and resubmit them in Edit & Retry. None for other job types and when no references were sent.

Defaultnull
edit_chat_attachments?|

For edit_chat (Image Playground) and template_chat (Template Builder) jobs: the images a user attached on their turns, keyed by UploadedImage uuid. The transcript's user turns carry image_ids; the client resolves each to a thumbnail here. None for other job types and when no images were attached.

The name predates template_chat and is kept as-is: this is a documented response field on a public endpoint, so renaming it would break callers for a cosmetic gain.

Defaultnull
edit_chat_identities?|

For edit_chat (Image Playground) jobs: the saved identities a user tagged on their turns, keyed by identity_code. The transcript's user turns carry identity_codes; the client resolves each to a {name, thumbnail} chip here. None for other job types and when no identities were tagged.

Defaultnull
owner_user_id?|

Admin-only: id of the user this job belongs to. Null for every other caller, so a job id never discloses who owns it.

Defaultnull
quality_summary?|

Job-level output quality verdict: every output's latest verdict plus the set-consistency findings. Null until the job has been checked, and always null while the quality check is not enabled for the caller.

Defaultnull
is_hidden?Is Hidden

True when the user deleted this job (soft-delete). Only ever true for admins — regular users can never fetch a hidden job's results at all. Deleting overwrites both the job's and each image result's status to "hidden", so the client should treat a result with an output image as completed rather than relying on status when this flag is set.

Defaultfalse
curl -X GET "https://example.com/jobs/string/results"
{  "should_post_process": true,  "post_processing_status": "string",  "post_processing_error": null,  "error_message": "string",  "total_images": 0,  "processed_images": 0,  "created_at": "string",  "updated_at": "string",  "job_id": "string",  "job_type": "string",  "status": "string",  "identity_code": "string",  "identity_name": "string",  "project_id": 0,  "project_text": "string",  "project_key": "string",  "progress": 0,  "processing_options": null,  "created_by": "string",  "results": [    {      "id": 0,      "job_id": "string",      "image_index": 0,      "group_index": 0,      "version": 0,      "original_filename": "string",      "download_filename": null,      "inputs": [        {          "full_size": null,          "thumbnail": null,          "uuid": null,          "tags": []        }      ],      "output": {        "full_size": null,        "thumbnail": null,        "uuid": null      },      "input_description": {},      "model_used": null,      "output_dims": null,      "detail_needs_review": false,      "detail_review_reason": null,      "quality": null,      "quality_pending": false,      "status": "string",      "quality_score": 0,      "processing_time": 0,      "error_message": "string",      "feedback": "like",      "feedback_comment": "string",      "created_at": "string",      "review_status": null,      "reviewed_before": false,      "review_annotations": null,      "retouch_claim": null,      "tags": []    }  ],  "summary": {    "total_images": 0,    "successful": 0,    "failed": 0,    "average_quality_score": 0,    "success_rate": 0  },  "credits_used": null,  "anchor_index": null,  "review_summary": null,  "preset_extraction_inputs": null,  "detail_repair_references": null,  "edit_chat_attachments": null,  "edit_chat_identities": null,  "owner_user_id": null,  "quality_summary": null,  "is_hidden": false}