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

# Get transcript

> Returns the transcript for a meeting, including speaker identification and time-stamped segments.



## OpenAPI

````yaml GET /meetings/{meeting_id}/transcript
openapi: 3.1.0
info:
  title: Timeless Public API
  version: 0.1.0
  description: >-
    The Timeless API is a REST API served over HTTPS. All requests and responses
    use JSON, and all endpoints require authentication.
servers:
  - url: https://api.timeless.day/v1
    description: Production
security:
  - HTTPBearer: []
tags:
  - name: meetings
    description: Retrieve meetings, recordings, and transcripts.
  - name: rooms
    description: Retrieve rooms that group related meetings.
  - name: documents
    description: Retrieve AI-generated meeting documents.
  - name: upload
    description: Upload audio or video files for transcription.
  - name: webhooks
    description: Manage webhook subscriptions for event notifications.
paths:
  /meetings/{meeting_id}/transcript:
    get:
      tags:
        - meetings
      summary: Get transcript
      description: >-
        Returns the transcript for a meeting, including speaker identification
        and time-stamped segments.
      operationId: get_meeting_transcript_v1_meetings__meeting_id__transcript_get
      parameters:
        - name: meeting_id
          in: path
          required: true
          schema:
            type: string
            title: Meeting Id
          description: The meeting ID (e.g., `mtg_abc123`).
          example: mtg_abc123
      responses:
        '200':
          description: The meeting transcript.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TranscriptResponse'
              example:
                meeting_id: mtg_abc123
                language: en
                speakers:
                  - id: spk_001
                    name: Alice Johnson
                  - id: spk_002
                    name: Bob Smith
                segments:
                  - speaker_id: spk_001
                    start_time: 0
                    end_time: 4.5
                    text: Good morning everyone, let's get started.
                  - speaker_id: spk_002
                    start_time: 4.8
                    end_time: 8.2
                    text: Sounds good. I have updates on the project.
        '401':
          description: Authentication required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Meeting not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    TranscriptResponse:
      properties:
        meeting_id:
          type: string
          title: Meeting Id
          description: The meeting ID.
          example: mtg_abc123
        language:
          anyOf:
            - type: string
            - type: 'null'
          title: Language
          description: The detected language of the transcript (e.g., `en`).
          example: en
        speakers:
          items:
            $ref: '#/components/schemas/Speaker'
          type: array
          title: Speakers
          description: List of identified speakers.
        segments:
          items:
            $ref: '#/components/schemas/Segment'
          type: array
          title: Segments
          description: Transcript segments in chronological order.
      type: object
      required:
        - meeting_id
        - language
        - speakers
        - segments
      title: TranscriptResponse
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: not_found
            message:
              type: string
              example: Resource not found
            details:
              type: array
              items:
                type: object
                properties:
                  field:
                    type: string
                  message:
                    type: string
          required:
            - code
            - message
      required:
        - error
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Speaker:
      properties:
        id:
          type: string
          title: Id
          description: Speaker ID.
          example: spk_001
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
          description: Speaker name, if identified.
          example: Alice Johnson
      type: object
      required:
        - id
        - name
      title: Speaker
    Segment:
      properties:
        speaker_id:
          type: string
          title: Speaker Id
          description: ID of the speaker for this segment.
          example: spk_001
        start_time:
          type: number
          title: Start Time
          description: Start time in seconds from the beginning of the meeting.
          example: 0
        end_time:
          type: number
          title: End Time
          description: End time in seconds.
          example: 4.5
        text:
          type: string
          title: Text
          description: The transcribed text.
          example: Good morning everyone, let's get started.
      type: object
      required:
        - speaker_id
        - start_time
        - end_time
        - text
      title: Segment
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
      description: >-
        API token from your [Timeless
        dashboard](https://my.timeless.day/api-token).

````