> For the complete documentation index, see [llms.txt](https://requestmechanic.gitbook.io/request-mechanic-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://requestmechanic.gitbook.io/request-mechanic-api-documentation/client/list-user-calls.md).

# List User Calls

Use the `GET /client/user-calls/`to retrieve a list of all calls associated with the current client user. The response includes details about the call, its participants, status, and associated room information.

***

#### Parameters

This endpoint does not require any parameters.

***

#### Responses

**200 OK**

**Description:** A list of calls associated with the client user.

**Example Response:**

```json
[
  {
    "id": 1,
    "room": {
      "id": 10,
      "room_id": "room123",
      "custom_room_id": "custom_room_abc",
      "is_active": true,
      "created_at": "2024-11-15T14:30:00Z",
      "participants": [
        {
          "id": 101,
          "name": "John Doe",
          "role": "Caller"
        },
        {
          "id": 102,
          "name": "Jane Smith",
          "role": "Participant"
        }
      ]
    },
    "caller": "John Doe",
    "participant": "Jane Smith",
    "status": "active",
    "start_time": "2024-11-15T14:35:00Z",
    "end_time": null,
    "created_at": "2024-11-15T14:30:00Z",
    "firebase_key": "abc123def456"
  }
]
```

***

#### Response Details

| Field                 | Type    | Description                                                                            |
| --------------------- | ------- | -------------------------------------------------------------------------------------- |
| `id`                  | integer | The unique ID of the call.                                                             |
| `room`                | object  | Details about the room associated with the call.                                       |
| `room.id`             | integer | The unique ID of the room.                                                             |
| `room.room_id`        | string  | The ID of the room.                                                                    |
| `room.custom_room_id` | string  | A custom identifier for the room.                                                      |
| `room.is_active`      | boolean | Whether the room is currently active.                                                  |
| `room.created_at`     | string  | The timestamp when the room was created.                                               |
| `room.participants`   | array   | A list of participants in the room.                                                    |
| `caller`              | string  | The name of the person who initiated the call.                                         |
| `participant`         | string  | The name of the person who joined the call.                                            |
| `status`              | string  | The current status of the call. Possible values: `[pending, active, ended, canceled]`. |
| `start_time`          | string  | The timestamp when the call started.                                                   |
| `end_time`            | string  | The timestamp when the call ended (if applicable).                                     |
| `created_at`          | string  | The timestamp when the call record was created.                                        |
| `firebase_key`        | string  | The Firebase key associated with the call.                                             |