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

# Retrieve a transcription

> Returns the transcription of the recorded call identified by `call_id`. Alias of the `transcription` endpoint.



## OpenAPI

````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml get /v1/cdrs/{call_id}/transcriptions
openapi: 3.1.0
info:
  title: Wavix APIs
  description: >-
    Wavix provides robust APIs that let you integrate voice and text messaging
    features directly into your app. Send text, place calls, and access detailed
    reports  programmatically.
  termsOfService: https://wavix.com/terms-and-conditions
  license:
    name: MIT
    identifier: MIT
  contact:
    name: Wavix
    url: https://wavix.com
    email: support@wavix.com
  version: '1.0'
servers:
  - url: https://api.wavix.com
    description: https://api.wavix.com
    variables: {}
security:
  - bearerAuth: []
tags:
  - name: SIP trunks
    description: SIP trunks
  - name: Buy
    description: Numbers
  - name: Cart
    description: Numbers
  - name: My numbers
    description: Numbers
  - name: Billing
    description: Billing, transactions, and invoices
  - name: Profile
    description: Account profile and customer information
  - name: CDRs
    description: Call detail records and call history
  - name: Speech Analytics
    description: Call transcription and speech analytics
  - name: SMS and MMS
    description: Messaging
  - name: Number Validator
    description: Phone number validation
  - name: Link shortener
    description: Short link and click metrics
  - name: 2FA
    description: Two-factor authentication
  - name: 10DLC
    description: 10DLC Campaigns and Brands
  - name: API Keys
    description: API key management
  - name: Call webhooks
    description: Webhook configuration for call events
  - name: Call control
    description: Programmable Voice
  - name: Call streaming
    description: Real-time call audio streaming over WebSocket
  - name: Call recording
    description: Call recording
  - name: Sub-accounts
    description: Sub-account management
  - name: Voice campaigns
    description: Outbound voice campaigns
  - name: Wavix Embeddable
    description: WebRTC embeddable widget
paths:
  /v1/cdrs/{call_id}/transcriptions:
    get:
      tags:
        - CDRs
      summary: Retrieve a transcription
      description: >-
        Returns the transcription of the recorded call identified by `call_id`.
        Alias of the `transcription` endpoint.
      operationId: cdrs_transcriptions
      parameters:
        - name: call_id
          in: path
          description: The unique ID of the call.
          required: true
          style: simple
          schema:
            type: string
            example: bbaa37bf-430a-46da-ade3-c248e407016
      responses:
        '200':
          description: Returns the call transcription.
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CDRTranscriptionResponse'
              examples:
                success:
                  summary: Successful response
                  value:
                    transcript:
                      '16572026750': ''
                      '16465292513': ''
                    turns:
                      - type: '46844685344'
                        s: 160
                        e: 7280
                        text: Hello, how can I help you?
                      - type: '+16572026750'
                        s: 2400
                        e: 3280
                        text: Hello, I have a question about my bill.
                    uuid: e84f350f-6da7-4b56-80eb-41dec572626b
                    language: en
                    duration: 102
                    charge: '0.01'
                    status: completed
                    transcription_date: '2023-01-09T10:04:39.734Z'
                    call_date: '2023-01-09T10:01:13.394Z'
                    call_uuid: bbaa37bf-430a-46da-ade3-c248e4070161
                    call_score: '3.8'
                    call_summary: The agent and client discussed billing issues.
        '403':
          $ref: '#/components/responses/ForbiddenErrorResponse'
        '404':
          $ref: '#/components/responses/NotFoundErrorResponse'
      deprecated: false
      security:
        - bearerAuth:
            - calls:read
components:
  schemas:
    CDRTranscriptionResponse:
      title: CDRTranscriptionResponse
      required:
        - transcript
        - turns
        - uuid
        - language
        - duration
        - charge
        - status
        - transcription_date
        - call_date
        - call_uuid
        - call_score
        - call_summary
      type: object
      additionalProperties: false
      properties:
        transcript:
          type: object
          description: Mapping of phone numbers in the call to transcript text.
          additionalProperties:
            type: string
          example:
            '16572026750': ''
            '16465292513': ''
        turns:
          type: array
          description: List of speaker turns with text and start/end times.
          items:
            $ref: '#/components/schemas/TranscriptTurn'
          example:
            - type: '46844685344'
              s: 160
              e: 7280
              text: Hello, how can I help you?
            - type: '+16572026750'
              s: 2400
              e: 3280
              text: Hello, I have a question about my bill.
        uuid:
          type: string
          description: Transcription ID.
          example: e84f350f-6da7-4b56-80eb-41dec572626b
        language:
          $ref: '#/components/schemas/TranscriptionLanguage'
        duration:
          type: integer
          description: Call duration in seconds.
          format: int32
          example: 102
        charge:
          type: string
          description: Total charge for the transcription in USD.
          example: '0.01'
        status:
          $ref: '#/components/schemas/TranscriptionStatus'
        transcription_date:
          type: string
          description: >-
            Date and time when the transcription was processed in ISO 8601
            format.
          format: date-time
          example: '2023-01-09T10:04:39.734Z'
        call_date:
          type: string
          description: >-
            Date and time when the call was placed or received in ISO 8601
            format.
          format: date-time
          example: '2023-01-09T10:01:13.394Z'
        call_uuid:
          type: string
          description: Associated call ID.
          example: bbaa37bf-430a-46da-ade3-c248e4070161
        call_score:
          type: string
          description: |-
            Call sentiment score. Indicates negative (1.0-3.0), neutral,
             or positive (4.0-5.0).
          example: '3.8'
        call_summary:
          type: string
          description: One- or two-sentence call summary.
          example: The agent and client discussed billing issues.
    TranscriptTurn:
      title: TranscriptTurn
      type: object
      additionalProperties: false
      properties:
        type:
          type: string
          description: >-
            Phone number of the speaker attributed to this turn, in E.164
            format.
          example: '13132847320'
        s:
          type: integer
          description: >-
            Start of the `turn`, in milliseconds. The start time is calculated
            from the moment the call was answered.
          format: int32
          example: 3000
        e:
          type: integer
          description: >-
            End of the `turn`, in milliseconds. The end time is calculated from
            the moment the call was answered.
          format: int32
          example: 18000
        text:
          type: string
          description: Transcribed text attributed to the speaker for this turn.
          example: Hi there, how are you?
        sentiment:
          type: string
          description: >-
            Sentiment detected in the speaker's text for this turn, such as
            `neutral`, `positive`, or `negative`.
          example: neutral
      description: >-
        Represents a single turn in a call transcript. Each turn carries the
        text attributed to one speaker, with the start and end times for that
        text.
    TranscriptionLanguage:
      title: TranscriptionLanguage
      enum:
        - en
        - de
        - es
        - fr
        - it
        - null
      type:
        - string
        - 'null'
      description: >-
        Language of the transcription, as a two-letter ISO 639-1 code. One of
        `en` (English), `de` (German), `es` (Spanish), `fr` (French), or `it`
        (Italian). `null` lets the platform auto-detect the language.
    TranscriptionStatus:
      title: TranscriptionStatus
      enum:
        - completed
        - failed
      type: string
      description: >-
        Outcome of the transcription. One of `completed` (the transcript was
        produced) or `failed` (the transcription could not be produced).
    ForbiddenErrorResponse:
      title: ForbiddenErrorResponse
      type: object
      properties:
        success:
          type: boolean
          description: >-
            Indicates whether the request was successful. Always `false` for
            this error.
          example: false
        message:
          type: string
          description: Human-readable description of why access is forbidden.
          example: The service is not provisioned for your account.
    NotFoundErrorResponse:
      title: NotFoundErrorResponse
      type: object
      properties:
        success:
          type: boolean
          description: >-
            Indicates whether the request was successful. Always `false` for
            this error.
          example: false
        message:
          type: string
          description: >-
            Human-readable description stating that no resource matches the
            given ID.
          example: Record not found
  responses:
    ForbiddenErrorResponse:
      description: Request failed. The feature is disabled for your account.
      headers: {}
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ForbiddenErrorResponse'
    NotFoundErrorResponse:
      description: Request failed. An object with the specified ID is not found.
      headers: {}
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NotFoundErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >
        Wavix API key. Pass as `Authorization: Bearer <api_key>`. Keys support
        per-resource scopes (none / read / write). See [Restricted keys and
        scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes).

````