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

# Get Transcription Task

> Retrieve the status and results of a transcription task. Keep polling while the status is `PENDING`, `RECEIVED`, `STARTED`, or `PROGRESS`. When the status is `SUCCESS`, the `data` object is populated.



## OpenAPI

````yaml /openapi/transcription.json get /open/partner/ai/transcriptions/{transcription_id}
openapi: 3.0.4
info:
  title: Transcription API
  description: >-
    Submit audio for transcription and poll for results. Authenticate with the
    API key headers (`client_id` / `api_key`) issued alongside `secret_key` in
    the Portal.
  version: 0.0.1
servers:
  - url: https://platform-us.plaud.ai/developer/api
    description: US partner endpoint
  - url: https://platform-jp.plaud.ai/developer/api
    description: Japan partner endpoint
security: []
paths:
  /open/partner/ai/transcriptions/{transcription_id}:
    get:
      tags:
        - Transcription API
      summary: Get Transcription Task
      description: >-
        Retrieve the status and results of a transcription task. Keep polling
        while the status is `PENDING`, `RECEIVED`, `STARTED`, or `PROGRESS`.
        When the status is `SUCCESS`, the `data` object is populated.
      operationId: getTranscription
      parameters:
        - in: path
          name: transcription_id
          required: true
          schema:
            type: string
          description: The `transcription_id` returned when the audio was submitted.
          example: task_exec_xxx
      responses:
        '200':
          description: Transcription status and results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TranscriptionResultResponse'
              example:
                transcription_id: task_exec_xxx
                status: SUCCESS
                data:
                  text: Meeting started at 10am...
                  language: en
                  duration: 1843
                  results:
                    - start: 0
                      end: 4.2
                      text: Meeting started at 10am.
                      speaker_id: Speaker 1
                      language: en-US
                      language_probability: '0.941'
      security:
        - clientId: []
          clientApiKey: []
components:
  schemas:
    TranscriptionResultResponse:
      type: object
      properties:
        transcription_id:
          type: string
          example: task_exec_xxx
        status:
          $ref: '#/components/schemas/TranscriptionStatus'
        data:
          type: object
          description: Populated when the status is `SUCCESS`.
          properties:
            text:
              type: string
              description: Full transcript text.
            language:
              type: string
              description: Detected or specified language.
            duration:
              type: integer
              description: Audio duration in seconds.
            results:
              type: array
              description: Time-aligned transcript segments.
              items:
                $ref: '#/components/schemas/TranscriptionSegment'
    TranscriptionStatus:
      type: string
      description: >-
        `PENDING`, `RECEIVED`, `STARTED`, `PROGRESS` indicate the task is in
        progress — keep polling. `SUCCESS` means the data is ready. `FAILURE`
        and `REVOKED` are terminal failures.
      enum:
        - PENDING
        - RECEIVED
        - STARTED
        - PROGRESS
        - SUCCESS
        - FAILURE
        - REVOKED
      example: PENDING
    TranscriptionSegment:
      type: object
      properties:
        start:
          type: number
          description: Segment start time, in seconds.
          example: 0
        end:
          type: number
          description: Segment end time, in seconds.
          example: 4.2
        text:
          type: string
          description: Transcript text for the segment.
          example: Meeting started at 10am.
        speaker_id:
          type: string
          description: Speaker label, present when diarization is enabled.
          example: Speaker 1
        language:
          type: string
          description: Language
          example: en-US
        language_probabilitiy:
          type: number
          description: Probability (0-1) of language confidence
          example: '0.94'
  securitySchemes:
    clientId:
      type: apiKey
      in: header
      name: X-Client-Id
      description: Your `client_id`, issued in the Portal.
    clientApiKey:
      type: apiKey
      in: header
      name: X-Client-Api-Key
      description: >-
        Your `api_key`, issued alongside `client_id` / `secret_key` in the
        Portal.

````