---
title: "List by Condition"
method: POST
path: "/mj/task/list-by-condition"
---

# List by Condition

`POST /mj/task/list-by-condition`

## Request body

- object
  - `ids` string[], required — Array of Midjourney task ids to retrieve. Returns the current status and result for each.

## Response `200`

Success

- object[]
  - `action` string — Task type: `IMAGINE`, `UPSCALE`, `VARIATION`, `DESCRIBE`, `BLEND`, `VIDEO`, or another action name.
  - `buttons` object[] — 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
    - `style` integer
    - `type` integer
  - `description` string — Human-readable submission status message.
  - `failReason` string — Failure reason when `status` is `FAILURE`.
  - `finishTime` integer — Completion time as a Unix timestamp in milliseconds.
  - `id` string — Task id.
  - `imageUrl` string — 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.
  - `progress` string — Progress percentage string such as `58%` while the task runs and `100%` when finished.
  - `prompt` string — Original prompt as submitted.
  - `promptEn` string — Prompt after translation to the provider language. For `DESCRIBE` tasks, the extracted prompt suggestions arrive here.
  - `properties` object — Additional task metadata, such as `finalPrompt`.
  - `startTime` integer — Processing start time as a Unix timestamp in milliseconds.
  - `state` string — Custom state string echoed back from the submission for your own tracking.
  - `status` string — Task lifecycle state: `NOT_START`, `SUBMITTED`, `IN_PROGRESS`, `SUCCESS`, or `FAILURE`.
  - `submitTime` integer — Submission time as a Unix timestamp in milliseconds.

---

[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)