List tasks

The task-list API returns multiple task objects for the supplied ids, which is useful for refreshing a known set of tasks at once. In each task object, status, progress, imageUrl, and buttons describe its state, progress, result, and available actions.

POST/mj/task/list-by-condition

Retrieve multiple Midjourney task records by their task IDs.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization header.

In: header

Request Body

application/json

List of task IDs to retrieve.

TypeScript Definitions

Use the request body type in TypeScript.

ids*array<string>

List of task IDs to retrieve.

Response Body

`application/json`

curl -X POST "https://example.com/mj/task/list-by-condition" \  -H "Content-Type: application/json" \  -d '{    "ids": [      "task-001",      "task-002"    ]  }'

[
  {
    "action": "IMAGINE",
    "buttons": [
      {
        "customId": "MJ::JOB::upsample::1::example",
        "emoji": "U1",
        "label": "U1",
        "style": 2,
        "type": 0
      }
    ],
    "description": "string",
    "failReason": "",
    "finishTime": 0,
    "id": "task-001",
    "imageUrl": "https://example.com/result.png",
    "progress": "100%",
    "prompt": "Cat",
    "promptEn": "Cat",
    "properties": {},
    "startTime": 0,
    "state": "request-001",
    "status": "SUCCESS",
    "submitTime": 0
  }
]

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`