GET
/
mj
/
task
/
{taskId}
/
fetch
curl -X GET https://api.example.com/mj/task/1730621718151844/fetch \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "1730621826053455",
  "action": "IMAGINE",
  "prompt": "pig --v 6.1",
  "promptEn": "pig --v 6.1",
  "description": "Submit success",
  "status": "SUCCESS",
  "progress": "100%",
  "imageUrl": "https://cdn.example.com/image.png",
  "submitTime": 1730621826053,
  "startTime": 1730621828024,
  "finishTime": 1730621855817,
  "buttons": [
    {"customId": "MJ::JOB::upsample::1::xxx", "label": "U1", "type": 2, "style": 2},
    {"customId": "MJ::JOB::upsample::2::xxx", "label": "U2", "type": 2, "style": 2},
    {"customId": "MJ::JOB::variation::1::xxx", "label": "V1", "type": 2, "style": 2}
  ]
}
Query the status and results of a Midjourney task by task ID.

​
Path Parameters

​
taskId
string
required
Task ID.

​
Response

​
id
string
Task ID.
​
action
string
Task type (IMAGINE, UPSCALE, VARIATION, etc.).
​
prompt
string
Original prompt.
​
promptEn
string
English prompt.
​
status
string
Task status: NOT_START, SUBMITTED, IN_PROGRESS, SUCCESS, FAILURE.
​
progress
string
Progress percentage.
​
imageUrl
string
Generated image URL.
​
buttons
array
Available action buttons (U1-U4, V1-V4, etc.).
​
submitTime
integer
Submit timestamp.
​
startTime
integer
Start timestamp.
​
finishTime
integer
Finish timestamp.
​
failReason
string
Failure reason (if failed).
curl -X GET https://api.example.com/mj/task/1730621718151844/fetch \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "1730621826053455",
  "action": "IMAGINE",
  "prompt": "pig --v 6.1",
  "promptEn": "pig --v 6.1",
  "description": "Submit success",
  "status": "SUCCESS",
  "progress": "100%",
  "imageUrl": "https://cdn.example.com/image.png",
  "submitTime": 1730621826053,
  "startTime": 1730621828024,
  "finishTime": 1730621855817,
  "buttons": [
    {"customId": "MJ::JOB::upsample::1::xxx", "label": "U1", "type": 2, "style": 2},
    {"customId": "MJ::JOB::upsample::2::xxx", "label": "U2", "type": 2, "style": 2},
    {"customId": "MJ::JOB::variation::1::xxx", "label": "V1", "type": 2, "style": 2}
  ]
}