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

# Get subtitles

> SRT or WebVTT captions for a completed transcript, with the speaker in each cue.



## OpenAPI

````yaml GET /v1/transcripts/{id}/subtitles
openapi: 3.1.0
info:
  title: AirCaps API
  version: 1.0.0
  description: >-
    Speech-to-text for English. A5S Async v1 (REST) and A5S v2 Streaming
    (WebSocket).
servers:
  - url: https://api.aircaps.com
security:
  - bearerAuth: []
tags:
  - name: Transcripts
  - name: Files
  - name: Account
paths:
  /v1/transcripts/{id}/subtitles:
    get:
      tags:
        - Transcripts
      summary: Get subtitles
      description: >-
        SRT or WebVTT captions for a completed transcript, with the speaker in
        each cue.
      operationId: getSubtitles
      parameters:
        - name: id
          in: path
          required: true
          description: Transcript ID.
          schema:
            type: string
            example: tr_01k6z3m4q8w7e5r2t1y0u9i8o7
        - name: format
          in: query
          schema:
            type: string
            enum:
              - srt
              - vtt
            default: srt
        - name: chars_per_caption
          in: query
          description: Maximum characters per caption.
          schema:
            type: integer
            minimum: 10
            maximum: 200
            default: 42
      responses:
        '200':
          description: Subtitles as text.
          content:
            application/x-subrip:
              schema:
                type: string
              example: |
                1
                00:00:00,480 --> 00:00:02,310
                [speaker_0] hey good afternoon everybody
            text/vtt:
              schema:
                type: string
        '401':
          description: 'Missing or invalid API key. Codes: `unauthorized`.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  type: authentication_error
                  code: unauthorized
                  message: invalid API key
                  param: null
                  request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7
        '404':
          description: 'Not found. Codes: `not_found`.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  type: invalid_request_error
                  code: not_found
                  message: transcript not found
                  param: null
                  request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7
        '409':
          description: 'The transcript is not completed. Codes: `transcript_not_ready`.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  type: invalid_request_error
                  code: transcript_not_ready
                  message: transcript is processing
                  param: null
                  request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7
        '500':
          description: >-
            Server error. Safe to retry (use the same Idempotency-Key). Codes:
            `internal_error`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  type: api_error
                  code: internal_error
                  message: internal error
                  param: null
                  request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - type
            - code
            - message
            - request_id
          properties:
            type:
              type: string
              enum:
                - invalid_request_error
                - authentication_error
                - permission_error
                - rate_limit_error
                - api_error
            code:
              type: string
              description: Machine-readable code; see [Errors](/errors).
            message:
              type: string
            param:
              type:
                - string
                - 'null'
              description: The request field at fault, if any.
            request_id:
              type: string
              description: >-
                Also in the `x-request-id` header. Include it when contacting
                support.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your API key: `Authorization: Bearer aircaps_sk_...`'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.