---
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
  - `buttons` object[]
    - `customId` string
    - `emoji` string
    - `label` string
    - `style` integer
    - `type` integer
  - `description` string
  - `failReason` string
  - `finishTime` integer
  - `id` string
  - `imageUrl` string
  - `progress` string
  - `prompt` string
  - `promptEn` string
  - `properties` object
  - `startTime` integer
  - `state` string
  - `status` string
  - `submitTime` integer

---

[API](https://skmtc.net/deerapi/apis/text-to-audio-api.md) · [All operations](https://skmtc.net/deerapi/apis/text-to-audio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deerapi/text-to-audio-api/versions/b6265ced74a1/schema)