---
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 DeerAPI.

## Path parameters

- `id` string, required

## Response `200`

Current task state.

- object
  - `id` string, required
  - `action` string
  - `customId` string
  - `botType` string
  - `prompt` string
  - `promptEn` string
  - `description` string
  - `state` string
  - `submitTime` integer
  - `startTime` integer
  - `finishTime` integer
  - `imageUrl` string, required
  - `videoUrl` string
  - `status` string, required
  - `progress` string, required
  - `failReason` string
  - `buttons` object[], required
    - `customId` string
    - `emoji` string
    - `label` string
    - `type` integer
    - `style` integer
  - `maskBase64` string
  - `properties` object
    - `finalPrompt` string
    - `finalZhPrompt` string

---

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