> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-docs-ios-pin-save-threads-parity.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.

The optional `onBehalfOf` header scopes the request to a specific user; leave it out to call as the app itself.

## 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

````