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

# Get Call

> Fetches all the details of the call whose sessionId is passed in the URL.

Retrieve detailed information about a specific call using its session ID. This endpoint returns complete call data including all participants, their individual metrics, and recording information.

## When to Use

| Scenario              | Description                                                     |
| --------------------- | --------------------------------------------------------------- |
| Call details page     | Display comprehensive information about a completed call        |
| Recording access      | Get the recording URL for playback or download                  |
| Participant analytics | View individual participant metrics (join time, duration, etc.) |
| Debugging             | Investigate issues with a specific call session                 |

## Example Request

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

## Response Details

The response includes:

* **Call metadata**: Type, mode, status, duration, timestamps
* **Participants array**: Each participant's UID, device ID, join/leave times, and individual audio/video minutes
* **Recordings array**: Recording IDs, URLs, duration, and timestamps (if `hasRecording` is true)

<Note>
  The `sessionId` is returned when a call is initiated via the SDK or can be found in the [List Calls](/rest-api/calls-apis/list-calls) response.
</Note>

## Participant States

Each participant in the response has a `state` field:

| State        | Description                          |
| ------------ | ------------------------------------ |
| `ongoing`    | Participant is currently in the call |
| `ended`      | Participant left the call normally   |
| `unanswered` | Participant didn't answer the call   |
| `rejected`   | Participant rejected the call        |


## OpenAPI

````yaml get /calls/{sessionId}
openapi: 3.1.0
info:
  title: calls-api
  version: '3'
servers:
  - url: https://{appId}.call-{region}.cometchat.io/v3
    variables:
      appId:
        default: appId
      region:
        default: region
security:
  - sec0: []
paths:
  /calls/{sessionId}:
    get:
      summary: Get Call
      description: >-
        Fetches all the details of the call whose sessionId is passed in the
        URL.
      operationId: get-call
      parameters:
        - name: onBehalfOf
          in: header
          description: UID of the user on whose behalf the action is performed.
          schema:
            type: string
        - name: sessionId
          in: path
          description: Call to Retrieve
          schema:
            type: string
          required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Get Call:
                  value: |-
                    {
                        "data": [
                            {
                                "sessionId": "v1.eu.2574867aa2e6e417.17158459999d7fa95b1b4faea599f11eb5ecf07611b0b335c3",
                                "totalAudioMinutes": 0,
                                "totalVideoMinutes": 0,
                                "totalDuration": "00:00:00",
                                "hasRecording": false,
                                "initiatedAt": 1715845999,
                                "initiator": "cometchat-uid-1",
                                "mode": "call",
                                "receiver": "cometchat-uid-2",
                                "receiverType": "user",
                                "status": "initiated",
                                "totalDurationInMinutes": 0,
                                "totalParticipants": 0,
                                "type": "audio",
                                "participants": [
                                    {
                                        "uid": "cometchat-uid-1",
                                        "totalAudioMinutes": 0,
                                        "totalVideoMinutes": 0,
                                        "isJoined": false,
                                        "totalDurationInMinutes": 0,
                                        "name": "Andrew Joseph",
                                        "avatar": "https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp"
                                    },
                                    {
                                        "uid": "cometchat-uid-2",
                                        "totalAudioMinutes": 0,
                                        "totalVideoMinutes": 0,
                                        "isJoined": false,
                                        "state": "unanswered",
                                        "totalDurationInMinutes": 0,
                                        "name": "George Alan",
                                        "avatar": "https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-2.webp"
                                    }
                                ],
                                "data": {
                                    "entities": {
                                        "initiator": {
                                            "entity": {
                                                "uid": "cometchat-uid-1",
                                                "name": "Andrew Joseph",
                                                "avatar": "https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp"
                                            }
                                        },
                                        "receiver": {
                                            "entity": {
                                                "uid": "cometchat-uid-2",
                                                "name": "George Alan",
                                                "avatar": "https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-2.webp"
                                            }
                                        }
                                    }
                                }
                            }
                        ]
                    }
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        sessionId:
                          type: string
                          example: >-
                            v1.eu.2574867aa2e6e417.17158459999d7fa95b1b4faea599f11eb5ecf07611b0b335c3
                        totalAudioMinutes:
                          type: integer
                          example: 0
                          default: 0
                        totalVideoMinutes:
                          type: integer
                          example: 0
                          default: 0
                        totalDuration:
                          type: string
                          example: '00:00:00'
                        hasRecording:
                          type: boolean
                          example: false
                          default: true
                        initiatedAt:
                          type: integer
                          example: 1715845999
                          default: 0
                        initiator:
                          type: string
                          example: cometchat-uid-1
                        mode:
                          type: string
                          example: call
                        receiver:
                          type: string
                          example: cometchat-uid-2
                        receiverType:
                          type: string
                          example: user
                        status:
                          type: string
                          example: initiated
                        totalDurationInMinutes:
                          type: integer
                          example: 0
                          default: 0
                        totalParticipants:
                          type: integer
                          example: 0
                          default: 0
                        type:
                          type: string
                          example: audio
                        participants:
                          type: array
                          items:
                            type: object
                            properties:
                              uid:
                                type: string
                                example: cometchat-uid-1
                              totalAudioMinutes:
                                type: integer
                                example: 0
                                default: 0
                              totalVideoMinutes:
                                type: integer
                                example: 0
                                default: 0
                              isJoined:
                                type: boolean
                                example: false
                                default: true
                              totalDurationInMinutes:
                                type: integer
                                example: 0
                                default: 0
                              name:
                                type: string
                                example: Andrew Joseph
                              avatar:
                                type: string
                                example: >-
                                  https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp
                        data:
                          type: object
                          properties:
                            entities:
                              type: object
                              properties:
                                initiator:
                                  type: object
                                  properties:
                                    entity:
                                      type: object
                                      properties:
                                        uid:
                                          type: string
                                          example: cometchat-uid-1
                                        name:
                                          type: string
                                          example: Andrew Joseph
                                        avatar:
                                          type: string
                                          example: >-
                                            https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-1.webp
                                receiver:
                                  type: object
                                  properties:
                                    entity:
                                      type: object
                                      properties:
                                        uid:
                                          type: string
                                          example: cometchat-uid-2
                                        name:
                                          type: string
                                          example: George Alan
                                        avatar:
                                          type: string
                                          example: >-
                                            https://assets.cometchat.io/sampleapp/v2/users/cometchat-uid-2.webp
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: apikey

````