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

# Get Transcription Result

> Retrieve the result of a transcription by its UUID. Since transcription is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30 seconds until the `content` field is populated.

Once the transcription is complete, the response includes the full text, timestamped segments, and any previously generated AI content (summary, title, etc.).



## OpenAPI

````yaml POST /api/audios
openapi: 3.0.1
info:
  title: Easy-Peasy.AI API
  description: >-
    OpenAPI Specifications for the Easy-Peasy.AI API.


    All API requests must be authenticated with an API key. Include the
    `x-api-key` API key in the request header with all requests. You can get the
    API key [here](https://easy-peasy.ai/settings/api).
  version: 1.0.4
servers:
  - url: https://easy-peasy.ai
security:
  - apiKeyAuth: []
paths:
  /api/audios:
    post:
      summary: Get Transcription Result
      description: >-
        Retrieve the result of a transcription by its UUID. Since transcription
        is asynchronous (typically 1–5 minutes), poll this endpoint every 15–30
        seconds until the `content` field is populated.


        Once the transcription is complete, the response includes the full text,
        timestamped segments, and any previously generated AI content (summary,
        title, etc.).
      operationId: getTranscriptionResult
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
          description: Your API key
          example: 27feb2bb-aeb4-4a83-9fb6-8f3f2a15885e
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetAudioRequest'
      responses:
        '200':
          description: Audio transcription data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAudioResponse'
              examples:
                processing:
                  summary: Transcription still processing
                  value:
                    audio:
                      uuid: 4bc4e8ee-f29e-4a53-996e-5da955c42927
                      name: Team Meeting
                      content: ''
                      created_at: '2025-01-15T10:30:00.000Z'
                      segments: []
                      audio_type: Meeting
                      language: English
                completed:
                  summary: Transcription complete
                  value:
                    audio:
                      uuid: 4bc4e8ee-f29e-4a53-996e-5da955c42927
                      name: Team Meeting
                      content: >-
                        Speaker 1: Good morning everyone. Let's start with the
                        project update...
                      created_at: '2025-01-15T10:30:00.000Z'
                      segments:
                        - start: '0.00'
                          end: '3.50'
                          text: Good morning everyone.
                          speaker: Speaker 1
                      audio_type: Meeting
                      language: English
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Invalid API key
        '404':
          description: Audio not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Audio not found
components:
  schemas:
    GetAudioRequest:
      type: object
      required:
        - audio_id
      properties:
        audio_id:
          type: string
          description: >-
            The UUID of the audio transcription (returned from Create
            Transcription)
          example: 4bc4e8ee-f29e-4a53-996e-5da955c42927
    GetAudioResponse:
      type: object
      properties:
        audio:
          type: object
          properties:
            uuid:
              type: string
              description: Audio identifier
            name:
              type: string
              description: Audio name
            content:
              type: string
              description: >-
                Full transcription text. Empty string until processing
                completes.
            created_at:
              type: string
              format: date-time
              description: Creation timestamp
            segments:
              type: array
              description: Timestamped segments with optional speaker detection
              items:
                type: object
                properties:
                  start:
                    type: string
                    description: Start time in seconds
                  end:
                    type: string
                    description: End time in seconds
                  text:
                    type: string
                    description: Segment text
                  speaker:
                    type: string
                    description: Speaker label (if speaker detection was enabled)
            summary:
              type: string
              nullable: true
              description: AI-generated summary (if generated)
            audio_type:
              type: string
              description: Type of audio
            language:
              type: string
              description: Detected language
            title:
              type: string
              nullable: true
              description: AI-generated title (if generated)
            description:
              type: string
              nullable: true
              description: AI-generated description (if generated)
            keywords:
              type: string
              nullable: true
              description: AI-generated keywords (if generated)
            action_items:
              type: string
              nullable: true
              description: AI-generated action items (Meeting type, if generated)
            show_notes:
              type: string
              nullable: true
              description: AI-generated show notes (Podcast type, if generated)
            timestamped_overview:
              type: string
              nullable: true
              description: AI-generated timestamped overview (if generated)
            topics_and_bullets:
              type: string
              nullable: true
              description: AI-generated topics and bullets (if generated)
            linkedin_post:
              type: string
              nullable: true
              description: AI-generated LinkedIn post (if generated)
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
          example: Invalid API key
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. Get yours at
        https://easy-peasy.ai/settings/api

````