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

# Get Task Status

> Query the status and result of any async task

<Info>
  All async endpoints (generate, lyrics, mashupLyrics, concat, remaster, mp4, wav, etc.) return a `taskId`. Use this endpoint to poll the task until it reaches a terminal status (`success`, `failed`, or `timeout`).
</Info>

## Task Status Values

| Status    | Description                                            |
| --------- | ------------------------------------------------------ |
| `ready`   | Task is queued, waiting to be processed                |
| `running` | Task is currently being processed                      |
| `stream`  | Task is streaming partial results                      |
| `success` | Task completed successfully — check `data` for results |
| `failed`  | Task failed — check `failReason` and `failCode`        |
| `timeout` | Task timed out                                         |

## Polling Best Practices

<Tip>
  Use exponential backoff when polling: start with 2-3 second intervals, then gradually increase. Music generation tasks typically take 30-120 seconds depending on the task type.
</Tip>


## OpenAPI

````yaml GET /suno/v2/status
openapi: 3.0.0
info:
  title: Suno AI
  description: API documentation for Suno AI
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.mountsea.ai
    description: API Gateway
security: []
tags:
  - name: suno
    description: ''
  - name: suno/studio
    description: Studio Song Editor（与 audio/crop|fade|reverse 独立）
paths:
  /suno/v2/status:
    get:
      tags:
        - suno
      summary: get task status
      description: get task status, you can get the task status by taskId
      operationId: ApiPublicController_getTaskStatus
      parameters:
        - name: taskId
          required: true
          in: query
          description: Task ID
          schema:
            example: '1212'
            type: string
      responses:
        '200':
          description: The task status information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTaskStatusResDto'
      security:
        - bearerAuth: []
components:
  schemas:
    GetTaskStatusResDto:
      type: object
      properties:
        taskId:
          type: string
          description: Task id.
          example: task_1731a9b2f4
        status:
          enum:
            - queued
            - ready
            - running
            - stream
            - awaiting
            - success
            - failed
            - timeout
          type: string
          description: task status
        failReason:
          type: string
          description: Failure reason when status=FAILED.
          example: Audio source not found.
        failCode:
          type: number
          description: Failure code when status=FAILED.
          example: 4001
        data:
          type: object
          description: Data associated with the task.
        finishAt:
          type: string
          description: Task finished time (UTC).
          example: '2025-08-18T02:35:00.000Z'
          format: date-time
        createdAt:
          type: string
          description: Task created time (UTC).
          example: '2025-08-18T02:30:00.000Z'
          format: date-time
      required:
        - taskId
        - status
        - createdAt
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````