Skip to main content
POST
/
mj
/
task
/
list-by-condition
List by Condition
curl --request POST \
  --url https://api.cometapi.com/mj/task/list-by-condition \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "example"
  ]
}
'
[
  {
    "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
​
buttons
object[]
​
description
string
​
failReason
string
​
finishTime
integer
​
id
string
​
imageUrl
string
​
progress
string
​
prompt
string
​
promptEn
string
​
properties
object
​
startTime
integer
​
state
string
​
status
string
​
submitTime
integer