Skip to main content
POST
/
mj
/
task
/
list-by-condition
cURL
curl https://api.cometapi.com/mj/task/list-by-condition \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["<task_id>", "<task_id>"]
  }'
[
  {
    "action": "<string>",
    "buttons": [
      {
        "customId": "<string>",
        "emoji": "<string>",
        "label": "<string>",
        "style": 123,
        "type": 123
      }
    ],
    "description": "<string>",
    "failReason": "<string>",
    "finishTime": 123,
    "id": "<string>",
    "imageUrl": "<string>",
    "progress": "<string>",
    "prompt": "<string>",
    "promptEn": "<string>",
    "properties": {},
    "startTime": 123,
    "state": "<string>",
    "status": "<string>",
    "submitTime": 123
  }
]
Use this endpoint when you need to retrieve a batch of Midjourney tasks instead of polling one task id at a time.

​
When to use it

  • You are tracking many Midjourney tasks together
  • You want to filter by task state, submission window, or other server-side conditions
  • You need a dashboard or reconciliation job instead of an interactive single-task poll

​
Query pattern

1

Use single-task polling for hot paths

For one active task, prefer Fetch Single Task, because it is simpler and faster.
2

Use condition-based listing for batch checks

Send your filter conditions through this endpoint when you need to inspect multiple Midjourney tasks in one request.
3

Follow up on interesting tasks

When the batch result shows tasks that need deeper inspection or continuation, switch back to Fetch Single Task and Action.
Use this route for monitoring and reconciliation jobs; use Fetch Single Task for the main interactive polling path.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
ids
string[]
required

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

Response

200 - application/json

Success

​
action
string

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

​
buttons
object[]

Action buttons available on the finished task. Send a button's customId together with this task's id to /mj/submit/action to upscale, vary, zoom, or pan.

​
description
string

Human-readable submission status message.

​
failReason
string

Failure reason when status is FAILURE.

​
finishTime
integer

Completion time as a Unix timestamp in milliseconds.

​
id
string

Task id.

​
imageUrl
string

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.

​
progress
string

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

​
prompt
string

Original prompt as submitted.

​
promptEn
string

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

​
properties
object

Additional task metadata, such as finalPrompt.

​
startTime
integer

Processing start time as a Unix timestamp in milliseconds.

​
state
string

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

​
status
string

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

​
submitTime
integer

Submission time as a Unix timestamp in milliseconds.