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

# Get dub by ID

> Retrieve a specific dub by its ID. Only returns dubs created via API by the authenticated user. You should poll this a maximum of once every 3 seconds while waiting for a dub to complete.



## OpenAPI

````yaml get /v1/me/dubs/{dubId}
openapi: 3.1.0
info:
  title: VoiceDub API
  description: API for creating AI voice dubs and training custom voice models
  version: 1.0.0
  contact:
    name: VoiceDub Support
    email: help@voicedub.ai
    url: https://voicedub.ai
servers:
  - url: https://api.voicedub.ai
    description: Production server
security:
  - apiKeyAuth: []
tags:
  - name: Dubs
    description: Operations for creating and managing voice dubs
  - name: Voices
    description: Operations for creating and managing voice models
  - name: User
    description: Operations for managing user account and settings
paths:
  /v1/me/dubs/{dubId}:
    get:
      tags:
        - Dubs
      summary: Get dub by ID
      description: >-
        Retrieve a specific dub by its ID. Only returns dubs created via API by
        the authenticated user. You should poll this a maximum of once every 3
        seconds while waiting for a dub to complete.
      operationId: getDubById
      parameters:
        - in: path
          name: dubId
          description: UUID of the dub to retrieve
          schema:
            type: string
            format: uuid
            description: UUID of the dub to retrieve
            example: 123e4567-e89b-12d3-a456-426614174000
          required: true
      responses:
        '200':
          description: Dub retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  dub:
                    $ref: '#/components/schemas/DubPrivate'
                required:
                  - dub
        '404':
          description: Dub not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DubNotFoundError'
components:
  schemas:
    DubPrivate:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the dub
          example: 123e4567-e89b-12d3-a456-426614174000
        voiceId:
          type:
            - string
            - 'null'
          format: uuid
          description: Voice model used for the dub
          example: 123e4567-e89b-12d3-a456-426614174001
        link:
          type:
            - string
            - 'null'
          description: Original audio/video link if provided (null if not provided)
          example: https://example.com/audio.mp3
        separate:
          type: boolean
          description: Whether vocals were separated from backing track
          example: true
        status:
          type: string
          enum:
            - new
            - preprocessing
            - preprocessed
            - queued
            - starting
            - processing
            - finalizing
            - done
            - error
          description: Current processing status of the dub
          example: done
        inputDuration:
          type:
            - integer
            - 'null'
          description: Duration of input audio in milliseconds (null before preprocessed)
          example: 180000
        inputSource:
          type: string
          enum:
            - upload
            - link
          description: Source type of the input audio
          example: upload
        pitchShift:
          type: integer
          description: Pitch shift applied in semitones
          example: 0
        errorCode:
          type:
            - string
            - 'null'
          description: Error code if processing failed (null for now)
          example: null
        errorMessage:
          type:
            - string
            - 'null'
          description: Error message if processing failed (null for now)
          example: null
        apiCreditsUsed:
          type: integer
          description: API credits consumed for this dub (0 before /generate is called)
          example: 30
        apiCreditsLeft:
          type:
            - integer
            - 'null'
          description: >-
            Remaining API credits after this dub (null before /generate is
            called)
          example: 90
        completedAt:
          type:
            - string
            - 'null'
          description: >-
            Timestamp when dub processing completed (null if status is not
            "done" or "error")
          example: '2024-01-15T10:30:00.000Z'
        createdAt:
          type: string
          description: Timestamp when dub was created
          example: '2024-01-15T10:00:00.000Z'
        updatedAt:
          type: string
          description: Timestamp when dub was last updated
          example: '2024-01-15T10:30:00.000Z'
        dubUrl:
          type:
            - string
            - 'null'
          default: null
          description: Download URL for the completed dub (null if status is not done)
          example: https://example.com/dubs/123e4567-e89b-12d3-a456-426614174000.mp3
        requiredCredits:
          type:
            - number
            - 'null'
          default: null
          description: >-
            Number of credits required to process this dub (null before
            preprocessed)
          example: 30
      required:
        - id
        - voiceId
        - link
        - separate
        - status
        - inputDuration
        - inputSource
        - pitchShift
        - errorCode
        - errorMessage
        - apiCreditsUsed
        - apiCreditsLeft
        - completedAt
        - createdAt
        - updatedAt
        - dubUrl
        - requiredCredits
    DubNotFoundError:
      type: object
      properties:
        code:
          type: string
          const: not_found
          description: Error code
          example: not_found
        message:
          type: string
          description: Human-readable error message
          example: Dub not found
      required:
        - code
        - message
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API key in the format: "Api-Key <your-api-key>"'

````