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

# List Call History

> List call history records

## Request

```bash theme={null}
curl "https://app.orova.ai/api/history?workspaceId=WORKSPACE_ID&page=1&limit=20" \
  -H "x-api-key: YOUR_API_KEY"
```

## Query parameters

| Parameter     | Type   | Default | Description                              |
| ------------- | ------ | ------- | ---------------------------------------- |
| `workspaceId` | string | —       | Filter by workspace                      |
| `page`        | number | `1`     | Page number                              |
| `limit`       | number | `10`    | Items per page                           |
| `agentType`   | string | —       | Filter by type: `voice`, `chat`, `video` |
| `startDate`   | string | —       | Filter from date (ISO 8601)              |
| `endDate`     | string | —       | Filter to date (ISO 8601)                |
| `search`      | string | —       | Search by name or phone                  |

## Response

```json theme={null}
{
  "data": [
    {
      "_id": "history_id",
      "agentType": "voice",
      "fullName": "John Doe",
      "mobileNumber": "+1234567890",
      "callDuration": 120,
      "callEndReason": "user_hangup",
      "callSummary": "Customer called about billing...",
      "callCost": 0.05,
      "workspace_id": "WORKSPACE_ID",
      "createdAt": "2025-01-01T00:00:00.000Z"
    }
  ],
  "total": 50,
  "page": 1,
  "limit": 10
}
```