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

# Get captions files list

> This endpoint retrieves a list of caption files for a specified YouTube video.



## OpenAPI

````yaml get /files/captions/{videoId}
openapi: 3.1.0
info:
  version: 1.0.0
  title: Poix API
servers:
  - url: https://api.poix.io
    description: Production server
security: []
paths:
  /files/captions/{videoId}:
    get:
      summary: Get captions files list
      description: >-
        This endpoint retrieves a list of caption files for a specified YouTube
        video.
      operationId: getCaptionsFilesList
      parameters:
        - schema:
            type: string
            minLength: 11
            maxLength: 11
            description: The YouTube video ID
            example: dQw4w9WgXcQ
          required: true
          name: videoId
          in: path
        - schema:
            type: string
            enum:
              - json
              - text
              - csv
            description: The format of the response
            example: json
          required: false
          name: format
          in: query
        - schema:
            type: string
            minLength: 2
            maxLength: 2
            description: The language code for the captions
            example: en
          required: false
          name: lang
          in: query
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    languageCode:
                      type: string
                      description: The language code of the caption
                    languageName:
                      type: string
                      description: The language name of the caption
                    isAutoGenerated:
                      type: boolean
                      description: Whether the caption is auto-generated
                    url:
                      type: string
                      format: uri
                      description: The URL of the caption file
                  required:
                    - languageCode
                    - languageName
                    - isAutoGenerated
                    - url
                description: List of available caption files
              example:
                - languageCode: en
                  languageName: English (auto-generated)
                  isAutoGenerated: true
                  url: >-
                    https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=b2DyZtXMMZ2hi9oP_JmNkAo&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1727185631&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=750EEBD31FAB04DE0E1F1266932F3C4044F113EB.2E33088AAE47992D009A6B199B413B9D7836E0FC&key=yt8&kind=asr&lang=en&fmt=json3
                - languageCode: en
                  languageName: English (auto-generated)
                  isAutoGenerated: true
                  url: >-
                    https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=b2DyZtXMMZ2hi9oP_JmNkAo&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1727185631&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=750EEBD31FAB04DE0E1F1266932F3C4044F113EB.2E33088AAE47992D009A6B199B413B9D7836E0FC&key=yt8&kind=asr&lang=en&fmt=srt
                - languageCode: en
                  languageName: English (auto-generated)
                  isAutoGenerated: true
                  url: >-
                    https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=b2DyZtXMMZ2hi9oP_JmNkAo&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1727185631&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=750EEBD31FAB04DE0E1F1266932F3C4044F113EB.2E33088AAE47992D009A6B199B413B9D7836E0FC&key=yt8&kind=asr&lang=en&fmt=vtt
                - languageCode: en
                  languageName: English (auto-generated)
                  isAutoGenerated: true
                  url: >-
                    https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=b2DyZtXMMZ2hi9oP_JmNkAo&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1727185631&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=750EEBD31FAB04DE0E1F1266932F3C4044F113EB.2E33088AAE47992D009A6B199B413B9D7836E0FC&key=yt8&kind=asr&lang=en&fmt=ttml
                - languageCode: en
                  languageName: English (auto-generated)
                  isAutoGenerated: true
                  url: >-
                    https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=b2DyZtXMMZ2hi9oP_JmNkAo&caps=asr&opi=112496729&exp=xbt&xoaf=5&hl=en&ip=0.0.0.0&ipbits=0&expire=1727185631&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=750EEBD31FAB04DE0E1F1266932F3C4044F113EB.2E33088AAE47992D009A6B199B413B9D7836E0FC&key=yt8&kind=asr&lang=en&fmt=srv1
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      issues:
                        type: array
                        items:
                          type: object
                          properties:
                            code:
                              type: string
                            maximum:
                              type: number
                            type:
                              type: string
                            inclusive:
                              type: boolean
                            exact:
                              type: boolean
                            message:
                              type: string
                            path:
                              type: array
                              items:
                                type: string
                          required:
                            - code
                            - type
                            - message
                            - path
                      name:
                        type: string
                        enum:
                          - ZodError
                    required:
                      - issues
                      - name
                required:
                  - success
                  - error
              example:
                success: false
                error:
                  issues:
                    - code: too_big
                      maximum: 11
                      type: string
                      inclusive: true
                      exact: true
                      message: String must contain exactly 11 character(s)
                      path:
                        - videoId
                  name: ZodError
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                    required:
                      - message
                required:
                  - error
              example:
                error:
                  message: Forbidden
      security:
        - Bearer: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````