---
title: "Fetch a Midjourney task"
method: GET
path: "/mj/task/{id}/fetch"
---

# Fetch a Midjourney task

`GET /mj/task/{id}/fetch`

Use the task id returned by imagine, action, blend, modal, or editor endpoints. This is the main polling endpoint for Midjourney workflows on CometAPI.

## Path parameters

- `id` string, required

## Response `200`

Current task state.

- object
  - `id` string, required — Task id.
  - `action` string — Task type: `IMAGINE`, `UPSCALE`, `VARIATION`, `DESCRIBE`, `BLEND`, `VIDEO`, or another action name.
  - `customId` string — Button customId that created this task, when the task came from an action.
  - `botType` string — Bot that handled the task, `MID_JOURNEY` or `NIJI_JOURNEY`, when reported.
  - `prompt` string — Original prompt as submitted.
  - `promptEn` string — Prompt after translation to the provider language. For `DESCRIBE` tasks, the extracted prompt suggestions arrive here.
  - `description` string — Human-readable submission status message.
  - `state` string — Custom state string echoed back from the submission for your own tracking.
  - `submitTime` integer — Submission time as a Unix timestamp in milliseconds.
  - `startTime` integer — Processing start time as a Unix timestamp in milliseconds.
  - `finishTime` integer — Completion time as a Unix timestamp in milliseconds.
  - `imageUrl` string, required — Stable CometAPI-proxied image link (`https://api.cometapi.com/mj/image/{id}`). Prefer this link; entries in `image_urls` point at provider storage and can expire.
  - `videoUrl` string — Generated video link for `VIDEO` tasks.
  - `status` string, required — Task lifecycle state: `NOT_START`, `SUBMITTED`, `IN_PROGRESS`, `SUCCESS`, or `FAILURE`.
  - `progress` string, required — Progress percentage string such as `58%` while the task runs and `100%` when finished.
  - `failReason` string — Failure reason when `status` is `FAILURE`.
  - `buttons` object[], required — Action buttons available on the finished task. Send a button's `customId` together with this task's id to `/mj/submit/action` to upscale, vary, zoom, or pan.
    - `customId` string
    - `emoji` string
    - `label` string
    - `type` integer
    - `style` integer
  - `maskBase64` string — Mask attached to the task when a region edit created it.
  - `properties` object — Additional task metadata, such as `finalPrompt`.
    - `finalPrompt` string
    - `finalZhPrompt` string

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)