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

# Get Subtitle Profiles

> Retrieve available subtitle profiles for the authenticated account



## OpenAPI

````yaml /openapi/phrase-studio.json get /v1/subtitle-profiles
openapi: 3.0.3
info:
  title: Studio API
  description: >-
    API for creating projects and reading transcription, translation, and
    dubbing results.
  version: 1.0.0
servers:
  - url: https://api.studio.us.phrase.com
    description: Production US Environment
  - url: https://api.studio.eu.phrase.com
    description: Production EU Environment
security: []
tags:
  - name: Projects
    description: Manage transcription, translation, and dubbing projects
  - name: Recordings
    description: Access recording status and output data
  - name: Subtitle Profiles
    description: Manage subtitle formatting profiles
  - name: Pronunciations
    description: Manage custom pronunciation rules
  - name: Glossaries
    description: Manage translation glossaries
  - name: Insights
    description: Manage AI-powered insight prompts
  - name: Safe Communications
    description: Access safe communication evaluation templates
paths:
  /v1/subtitle-profiles:
    get:
      tags:
        - Subtitle Profiles
      summary: Get Subtitle Profiles
      description: Retrieve available subtitle profiles for the authenticated account
      operationId: getSubtitleProfiles
      responses:
        '200':
          description: Subtitle profiles retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: Array of subtitle profiles
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Subtitle profile ID
                        name:
                          type: string
                          description: Subtitle profile name
                        description:
                          type: string
                          description: Subtitle profile description
                        active:
                          type: boolean
                          description: Whether this profile is active
                        minDuration:
                          type: number
                          description: Minimum subtitle duration (seconds)
                        maxDuration:
                          type: number
                          description: Maximum subtitle duration (seconds)
                        maxLineCharacterCount:
                          type: number
                          description: Max characters per line
                        maxGapBetweenWords:
                          type: number
                          description: Max gap between words (seconds)
                        subtitlePosition:
                          type: string
                          description: Subtitle position
                          enum:
                            - top
                            - bottom
                            - center
                            - right
                            - middle
                            - left
                        displaySpeakerNames:
                          type: boolean
                          description: Display speaker names
                        maxLinesPerScreen:
                          type: number
                          description: Max lines per screen
                        fontSize:
                          type: number
                          description: Font size for subtitles
                        textColor:
                          type: string
                          description: Text color (hex)
                        backgroundColor:
                          type: string
                          description: Background color (hex)
                        createdAt:
                          type: string
                          format: date-time
                          description: Creation time
                        updatedAt:
                          type: string
                          format: date-time
                          description: Last update time
                      required:
                        - id
                        - name
                        - active
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                      pageSize:
                        type: integer
                      total:
                        type: integer
                      totalPages:
                        type: integer
                    required:
                      - page
                      - pageSize
                      - total
                      - totalPages
        '401':
          description: Unauthorized (invalid API key)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalid_api_key:
                  summary: Invalid API key
                  value:
                    success: false
                    statusCode: 401
                    message: Unauthorized
                    timestamp: '2025-01-01T00:00:00.000Z'
        '403':
          description: Forbidden (access denied)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                forbidden:
                  summary: Access denied
                  value:
                    success: false
                    statusCode: 403
                    message: Access denied
                    timestamp: '2025-01-01T00:00:00.000Z'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                server_error:
                  summary: Unexpected error
                  value:
                    success: false
                    statusCode: 500
                    message: Internal server error
                    timestamp: '2025-01-01T00:00:00.000Z'
      security:
        - apiKeyAuth: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        statusCode:
          type: integer
          example: 400
        message:
          type: string
          example: Bad Request
        timestamp:
          type: string
          format: date-time
          example: '2025-01-01T00:00:00.000Z'
      required:
        - success
        - statusCode
        - message
        - timestamp
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````