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}
  ]
}