Retrieve a task

The single-task retrieval API returns the task action, status, progress, image URL, and buttons. Use status to determine whether to keep waiting. After the task succeeds, use a buttons[].customId value to run a subsequent Action.

GET/mj/task/{id}/fetch

Retrieve a task's status, progress, image URL, and available action buttons by task ID.

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

Midjourney task ID.

Response Body

`application/json`

curl -X GET "https://example.com/mj/task/string/fetch"

{
  "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

Path Parameters

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`