---
title: "Query batch tasks"
method: POST
path: "/suno/fetch"
---

# Query batch tasks

`POST /suno/fetch`

## Request body

- object
  - `ids` string[], required
  - `action` string, required — Action type: MUSIC or LYRICS.

## Response `200`

Batch task fetch

- object
  - `code` string, required — API response status code
  - `message` string, required — Response message
  - `data` object[], required — Array of primary data items.
    - `task_id` string — Unique task identifier
    - `notify_hook` string — Webhook callback URL for task completion or status changes.
    - `action` string — Task action type
    - `status` string — Current task status
    - `fail_reason` string — Failure reason, only present when the task has failed.
    - `submit_time` integer — Task submission timestamp (Unix timestamp, seconds)
    - `start_time` integer — Task processing start timestamp (Unix timestamp, seconds)
    - `finish_time` integer — Task completion timestamp (Unix timestamp, seconds)
    - `progress` string — Task completion progress percentage
    - `data` object[] — Array of task results.
      - `id` string, required — Unique identifier of the generated item
      - `title` string, required — Title of the generated item
      - `status` string, required — Status of the generated item
      - `metadata` object, required — Object containing detailed metadata of generated items.
        - `tags` string, required — Tags or keywords associated with the item
        - `prompt` string, required — Input prompt text used to generate the item
        - `duration` unknown, required
        - `error_type` unknown, required
        - `error_message` unknown, required
        - `audio_prompt_id` unknown, required
        - `gpt_description_prompt` string, required — GPT-generated descriptive prompt
      - `audio_url` string, required — URL of the generated audio file
      - `image_url` string, required — URL of the associated image
      - `video_url` string, required — URL of the associated video
      - `model_name` string, required — AI model name used
      - `image_large_url` string, required — URL of the associated large image
      - `major_model_version` string, required — Primary version number of the AI model used

---

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