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

# Suno Query Single

> Use DeerAPI to call the Suno Query Single endpoint with request details, response details, examples, and an OpenAPI playground.

## Overview

Use this endpoint to call the Suno Query Single 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/music/suno/get-query-single.openapi.json GET /suno/fetch/{task_id}
openapi: 3.1.0
info:
  title: Query Single Task API
  version: 1.0.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /suno/fetch/{task_id}:
    get:
      summary: Query single task
      operationId: query_single_task
      parameters:
        - name: task_id
          in: path
          required: true
          description: Task ID. Available in the generate music response.
          schema:
            type: string
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    description: Task status
                  message:
                    type: string
                    description: >-
                      Message. Usually empty on success, may contain error
                      details on failure.
                  data:
                    type: object
                    description: Main data payload containing task details.
                    properties:
                      task_id:
                        type: string
                        description: Unique task identifier (UUID)
                      action:
                        type: string
                        description: Task type or operation type
                      status:
                        type: string
                        description: Current task status
                      fail_reason:
                        type: string
                        description: Failure reason. Only valid when status is FAILED.
                      submit_time:
                        type: integer
                        description: Task submission timestamp (Unix timestamp, seconds)
                      start_time:
                        type: integer
                        description: >-
                          Task processing start timestamp (Unix timestamp,
                          seconds)
                      finish_time:
                        type: integer
                        description: Task completion timestamp (Unix timestamp, seconds)
                      progress:
                        type: string
                        description: Task processing progress (percentage)
                      data:
                        type: 'null'
                        description: Output result data of the task
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````