v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

List by Condition

post/mj/task/list-by-condition

Request body

idsstring[] required

Array of Midjourney task ids to retrieve. Returns the current status and result for each.

Response

Success

actionstring

Task type: IMAGINE, UPSCALE, VARIATION, DESCRIBE, BLEND, VIDEO, or another action name.

descriptionstring

Human-readable submission status message.

failReasonstring

Failure reason when status is FAILURE.

finishTimeinteger

Completion time as a Unix timestamp in milliseconds.

idstring

Task id.

imageUrlstring

Stable CometAPI-proxied image link (https://api.cometapi.com/mj/image/{id}). Prefer this link; entries in image_urls point at provider storage and can expire.

progressstring

Progress percentage string such as 58% while the task runs and 100% when finished.

promptstring

Original prompt as submitted.

promptEnstring

Prompt after translation to the provider language. For DESCRIBE tasks, the extracted prompt suggestions arrive here.

propertiesobject

Additional task metadata, such as finalPrompt.

startTimeinteger

Processing start time as a Unix timestamp in milliseconds.

statestring

Custom state string echoed back from the submission for your own tracking.

statusstring

Task lifecycle state: NOT_START, SUBMITTED, IN_PROGRESS, SUCCESS, or FAILURE.

submitTimeinteger

Submission time as a Unix timestamp in milliseconds.