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

# Get Audio Separation Task Status

> Retrieves the current status of an audio separation task using the specified `task_id`.

When you submit an audio file for separation into its component tracks, our system begins processing your request as a background task. This endpoint serves as your window into that process, allowing you to monitor the progression of your audio separation task from initiation to completion.

## Making Status Requests

To check on your audio separation task's progress, you'll need the unique `task_id` that was provided when you initially submitted your separation request. With this identifier, simply make a GET request to the endpoint:

```
GET https://client.camb.ai/apis/audio-separation/{task_id}
```

## Troubleshooting Common Issues

If you encounter difficulties while checking separation status, consider these common solutions:

1. **Invalid Task ID**: Verify the task ID was correctly stored and passed to the status endpoint. Task IDs are case-sensitive and must be used exactly as provided.

2. **Authentication Problems**: Ensure your API key is valid and correctly included in the request headers.

3. **Network Connectivity**: Implement proper error handling for network issues that might interrupt status checking, including automatic retry logic.

4. **Unexpected Terminal States**: If a separation ends with an error status, examine the error message for specific issues that might be addressed in subsequent separation attempts.

By properly integrating status checking into your application, you can create a seamless separation experience that keeps your users informed throughout the entire process, building confidence in your service and ensuring timely delivery.


## OpenAPI

````yaml get /audio-separation/{task_id}
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://client.camb.ai/apis
security: []
paths:
  /audio-separation/{task_id}:
    get:
      tags:
        - Apis
        - Audio-Separation
      summary: Get Audio Separation Status
      operationId: get_audio_separation_status_audio_separation__task_id__get
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/TaskIDParam'
            description: >-
              The unique identifier returned when you submitted your audio
              separation request. This serves as the reference point for
              tracking your specific task.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskStatus'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    TaskIDParam:
      type: string
      title: Task ID
      description: >-
        This parameter represents a unique identifier for a task. It is used in
        various API endpoints to query the status or result of a specific task.
        The `task_id` is typically returned when a task is created.
    TaskStatus:
      type: string
      enum:
        - SUCCESS
        - PENDING
        - TIMEOUT
        - ERROR
        - PAYMENT_REQUIRED
      title: TaskStatus
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        The `x-api-key` is a custom header required for authenticating requests
        to our API. Include this header in your request with the appropriate API
        key value to securely access our endpoints. You can find your API key(s)
        in the 'API' section of our studio website.

````