Midjourney Task fetch

Fetch one Midjourney task's progress, result URLs, and button list.

GET /mj/task/{id}/fetch

Request headers

Name	Type	Required	Description
	string	Yes	Bearer token, e.g.

Path parameters

Name	Type	Required	Description
	string	Yes	Task ID; same as submit

Response fields

Name	Type	Description
	string	Task ID
	string	e.g. , , , , , , , ,
	string	Prompt
	string	English prompt
	string	Task description
	integer	Submit time
	integer	Start time
	integer	Finish time
	string	Image URL
	string	/ / / / / /
	string	Progress, e.g.
	string	Failure reason
	array | null	Button list; pass to Action
	string	Action id
	string	Icon
	string	Opaque state
	string	Video URL (capital V)
	integer	Image width
	integer	Image height
	array	Image URL list

Request example

curl https://octopusx.ai/mj/task/1712158011464906/fetch \
  -H "Authorization: Bearer YOUR_API_KEY"

Response example

In progress

{
  "id": "1712158011464906",
  "action": "IMAGINE",
  "prompt": "Cat",
  "promptEn": "Cat",
  "description": "Submit success",
  "submitTime": 1735689600000,
  "startTime": 1735689610000,
  "finishTime": 0,
  "imageUrl": "",
  "status": "IN_PROGRESS",
  "progress": "65%",
  "failReason": "",
  "buttons": null,
  "state": "",
  "VideoUrl": "",
  "imageWidth": 0,
  "imageHeight": 0,
  "imageUrls": []
}

Completed

{
  "id": "1712158011464906",
  "action": "IMAGINE",
  "prompt": "Cat",
  "promptEn": "Cat",
  "description": "Finished",
  "submitTime": 1735689600000,
  "startTime": 1735689610000,
  "finishTime": 1735689700000,
  "imageUrl": "https://example.com/mj/result.png",
  "status": "SUCCESS",
  "progress": "100%",
  "failReason": "",
  "buttons": [
    {
      "customId": "MJ::JOB::upsample::2::3dbbd469-36af-4a0f-8f02-df6c579e7011",
      "emoji": "U2",
      "type": 2,
      "style": 2
    }
  ],
  "state": "",
  "VideoUrl": "",
  "imageWidth": 2048,
  "imageHeight": 2048,
  "imageUrls": ["https://example.com/mj/result.png"]
}

Related

• Midjourney overview
• Batch query
• Action