> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-docs-restapi-chatapi-eng-39107.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Call Transcriptions

> Retrieve the transcriptions generated for a CometChat call by sessionId, with pagination and links to the transcript files.

Retrieve the transcriptions generated for a specific call using its session ID. Each entry describes one transcript file, including the window it covers and the URL to download it.

## When to Use

| Scenario                | Description                                                                              |
| ----------------------- | ---------------------------------------------------------------------------------------- |
| Transcript playback     | Fetch the transcript file URLs for a completed call                                      |
| Compliance and archival | Export call transcripts into your own retention system                                   |
| Long calls              | Page through calls that produced more than the 5 transcripts embedded in the call object |
| Search and analytics    | Feed transcript content into downstream indexing or summarization                        |

## Example Request

```bash theme={null}
curl -X GET "https://{appId}.call-{region}.cometchat.io/v3/calls/v1.us.31780434a95d45.16923681138d75114d60d1345a22e4cc612263fb26c0b5cf92/transcriptions" \
  -H "apikey: YOUR_REST_API_KEY"
```

## Response Details

Each entry in the `data` array describes one transcript file:

| Property         | Type    | Description                                                                    |
| ---------------- | ------- | ------------------------------------------------------------------------------ |
| `roomName`       | string  | The conference room the transcript belongs to                                  |
| `mid`            | string  | Unique meeting identifier; absent when the transcript covers the whole session |
| `tid`            | string  | Unique transcript identifier                                                   |
| `startTime`      | integer | UNIX timestamp when the transcribed segment started                            |
| `endTime`        | integer | UNIX timestamp when the transcribed segment ended                              |
| `transcriptDate` | string  | ISO 8601 timestamp of when the transcript was produced                         |
| `transcriptUrl`  | string  | URL to the transcript file                                                     |

<Note>
  Transcriptions are generated asynchronously after a call ends, so a call that has just finished may return an empty `data` array. Fields with no value are omitted from the response rather than returned as `null`.
</Note>

## Pagination

Results are paginated, newest transcript first. Use `page` and `perPage` to page through them.

| Parameter | Default | Maximum |
| --------- | ------- | ------- |
| `page`    | 1       | —       |
| `perPage` | 100     | 1000    |

```bash theme={null}
curl -X GET "https://{appId}.call-{region}.cometchat.io/v3/calls/{sessionId}/transcriptions?page=2&perPage=50" \
  -H "apikey: YOUR_REST_API_KEY"
```

## Relationship to the Call Object

The [List Calls](/rest-api/calls-apis/list-calls) and [Get Call](/rest-api/calls-apis/get-call) responses embed the **5 most recent** transcriptions on each call whose `hasTranscription` is `true`. Use this endpoint when a call has more than 5 transcripts, or when you need to page through them.


## OpenAPI

````yaml get /calls/{sessionId}/transcriptions
openapi: 3.0.0
info:
  title: Calls APIs
  description: Manage calls using our API.
  version: '3.0'
servers:
  - url: https://{appId}.call-{region}.cometchat.io/v3
    variables:
      appId:
        default: appId
        description: (Required) App ID
      region:
        enum:
          - us
          - eu
          - in
        default: us
        description: Select Region
security: []
tags:
  - name: Calls
    description: The Calls tag
paths:
  /calls/{sessionId}/transcriptions:
    get:
      tags:
        - Calls
      summary: Get Call Transcriptions
      description: >-
        Fetches the transcriptions generated for the call whose sessionId is
        passed in the URL. Transcriptions are produced asynchronously after the
        call ends, so a call that has ended very recently may not have any yet.
      operationId: retrieve-call-transcriptions
      parameters:
        - $ref: '#/components/parameters/onBehalfOf'
        - name: sessionId
          in: path
          description: Call whose transcriptions are to be retrieved
          required: true
          schema:
            type: string
        - name: page
          in: query
          description: The page of results to return. Defaults to 1.
          schema:
            type: integer
        - name: perPage
          in: query
          description: >-
            The number of transcriptions to return per page. Defaults to 100,
            capped at 1000.
          schema:
            type: integer
      responses:
        '200':
          description: Retrieves Call Transcriptions
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/transcriptionSchema'
                  meta:
                    $ref: '#/components/schemas/metaSchema'
                type: object
              example:
                data:
                  - roomName: >-
                      v1.us.{appId}.16923681138d75114d60d1345a22e4cc612263fb26c0b5cf92@conference.rtc.cometchat.io
                    mid: 855e1519-1244-4213-8e40-53044c1e9e43
                    tid: 0f1f4d7a-6c3b-4a2e-9d15-8a7c2b4e6f10
                    startTime: 1692368127
                    endTime: 1692368146
                    transcriptDate: '2023-08-18T14:15:27.000Z'
                    transcriptUrl: >-
                      https://transcripts.cometchat.io/31780434a95d45/transcript_2023-08-18T14:15:27.000Z_0f1f4d7a-6c3b-4a2e-9d15-8a7c2b4e6f10.json
                meta:
                  pagination:
                    total: 1
                    count: 1
                    per_page: 100
                    current_page: 1
                    total_pages: 1
      security:
        - apiKey: []
components:
  parameters:
    onBehalfOf:
      name: onBehalfOf
      in: header
      description: UID of the user on whose behalf the action is performed.
      schema:
        type: string
  schemas:
    transcriptionSchema:
      properties:
        roomName:
          type: string
        mid:
          type: string
        tid:
          type: string
        startTime:
          type: integer
        endTime:
          type: integer
        transcriptDate:
          type: string
        transcriptUrl:
          type: string
      type: object
    metaSchema:
      properties:
        pagination:
          properties:
            total:
              type: integer
            count:
              type: integer
            per_page:
              type: integer
            current_page:
              type: integer
            total_pages:
              type: integer
          type: object
      type: object
  securitySchemes:
    apiKey:
      type: apiKey
      description: API Key with fullAccess scope(i.e. Rest API Key from the Dashboard).
      name: apikey
      in: header

````