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

# Get Task by ID

Fetch a single Task by its `id`. Use this to check target status and retrieve output download links.


## OpenAPI

````yaml GET /tasks/{id}
openapi: 3.1.0
info:
  title: AudioShake API
  version: 1.0.0
  description: >-
    API for AI-powered audio source separation, stem extraction, and
    transcription.
  license:
    name: Proprietary
    url: https://www.audioshake.ai/terms
  contact:
    name: AudioShake
    url: https://audioshake.ai
servers:
  - url: https://api.audioshake.ai
security:
  - apiKey: []
tags:
  - name: assets
    description: Audio and media file assets managed by AudioShake
  - name: tasks
    description: Stem separation, source separation, and transcription alignment tasks
paths:
  /tasks/{id}:
    get:
      tags:
        - tasks
      summary: Get Task by ID
      operationId: getTask
      parameters:
        - schema:
            type: string
          in: path
          name: id
          required: true
          description: Unique identifier of the Task
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    description: Unique identifier of the Task
                    type: string
                  createdAt:
                    format: date-time
                    description: Timestamp of when the Task was created
                    type: string
                  completedAt:
                    anyOf:
                      - format: date-time
                        description: Timestamp of when the Task was completed
                        type: string
                      - type: 'null'
                  clientId:
                    description: Unique identifier of the client
                    type: string
                  cost:
                    description: Processing cost in credits
                    type: number
                  assetId:
                    description: >-
                      Asset ID of an input media file. Mutually exclusive with
                      url
                    type: string
                  url:
                    anyOf:
                      - description: >-
                          URL of an input media file. Mutually exclusive with
                          assetId
                        type: string
                      - type: 'null'
                  writeDestination:
                    anyOf:
                      - description: >-
                          S3 URI prefix outputs were written under. Outputs are
                          organized as
                          <writeDestination>/<taskId>/targets/<targetId>/output/<filename>.
                          Only present when a custom write destination was
                          provided.
                        type: string
                      - type: 'null'
                  metadata:
                    description: >-
                      Client-provided metadata. Stored and returned as-is in
                      responses and webhooks.
                    type: string
                  targets:
                    description: Processing targets and their current status
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          description: Unique identifier of the target
                          type: string
                        model:
                          description: >-
                            Model to run. See the Models page for available
                            options.
                          type: string
                        status:
                          description: >-
                            Status of the target: 'processing' – actively
                            running; 'completed' – results ready in output;
                            'error' – see error field for details
                          enum:
                            - processing
                            - completed
                            - error
                          type: string
                        formats:
                          type: array
                          items:
                            description: Output file formats (e.g. "wav", "mp3", "json")
                            type: string
                        output:
                          description: >-
                            Downloadable output files for this target. Populated
                            when status is "completed".
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                description: Filename of the output asset
                                type: string
                              format:
                                description: Format of the output file
                                type: string
                              link:
                                description: >-
                                  Presigned download URL. Expires after one hour
                                  — re-fetch the Task for a fresh link.
                                type: string
                            required:
                              - name
                              - format
                              - link
                        cost:
                          description: Processing cost in credits
                          type: number
                        error:
                          anyOf:
                            - type: object
                              properties:
                                code:
                                  description: Error code
                                  type: number
                                message:
                                  description: Error message
                                  type: string
                              required:
                                - code
                                - message
                            - type: 'null'
                        duration:
                          description: Processed audio duration in seconds
                          type: number
                        residual:
                          description: Include residual with results
                          type: boolean
                        language:
                          description: >-
                            ISO 639-1 two-letter language code. Improves model
                            accuracy and timing alignment for transcription and
                            alignment models. If omitted, the model will attempt
                            to auto-detect.
                          type: string
                        transcriptUrl:
                          description: URL to transcript file for alignment
                          type: string
                        transcriptAssetId:
                          description: Asset ID of a transcript for alignment
                          type: string
                      required:
                        - id
                        - model
                        - status
                        - formats
                        - output
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````