> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.deerapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Midjourney Get

> Use DeerAPI to call the Midjourney Get endpoint with request details, response details, examples, and an OpenAPI playground.

## Overview

Use this endpoint to call the Midjourney Get workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

## Before you start

Use the DeerAPI base URL and pass your API Key in the `Authorization` header:

```text theme={null}
https://api.deerapi.com
```

```text theme={null}
Authorization: Bearer $DEERAPI_KEY
```

## Model selection

Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

## Implementation notes

* Use the OpenAPI playground for the exact request fields accepted by this endpoint.
* Keep API Keys on the server side when you build production applications.
* Log the request ID from failed calls so support can investigate the request.
* Retry `429`, `500`, and `503` responses with exponential backoff.


## OpenAPI

````yaml /api/openapi/image/midjourney/tasks/get-get-by-id.openapi.json GET /mj/task/{id}/fetch
openapi: 3.1.0
info:
  title: Fetch Single Task API
  version: 1.0.0
  description: >-
    Poll a Midjourney task created through DeerAPI and read the finished image
    URL plus the next available action buttons.
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /mj/task/{id}/fetch:
    get:
      summary: Fetch a Midjourney task
      description: >-
        Use the task id returned by imagine, action, blend, modal, or editor
        endpoints. This is the main polling endpoint for Midjourney workflows on
        DeerAPI.
      operationId: fetch_single_task
      parameters:
        - name: id
          in: path
          required: true
          description: Midjourney task id.
          schema:
            type: string
      responses:
        '200':
          description: Current task state.
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - status
                  - progress
                  - imageUrl
                  - buttons
                properties:
                  id:
                    type: string
                  action:
                    type: string
                  customId:
                    type: string
                  botType:
                    type: string
                  prompt:
                    type: string
                  promptEn:
                    type: string
                  description:
                    type: string
                  state:
                    type: string
                  submitTime:
                    type: integer
                  startTime:
                    type: integer
                  finishTime:
                    type: integer
                  imageUrl:
                    type: string
                  videoUrl:
                    type: string
                  status:
                    type: string
                  progress:
                    type: string
                  failReason:
                    type: string
                  buttons:
                    type: array
                    items:
                      type: object
                      properties:
                        customId:
                          type: string
                        emoji:
                          type: string
                        label:
                          type: string
                        type:
                          type: integer
                        style:
                          type: integer
                  maskBase64:
                    type: string
                  properties:
                    type: object
                    properties:
                      finalPrompt:
                        type: string
                      finalZhPrompt:
                        type: string
                example:
                  id: '1773314942177684'
                  status: SUCCESS
                  progress: 100%
                  imageUrl: https://api.deerapi.com/mj/image/1773314942177684
                  videoUrl: ''
                  buttons:
                    - customId: MJ::JOB::upsample::1::example
                      emoji: ''
                      label: U1
                      type: 2
                      style: 1
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````