---
description: >-
  This API endpoint allows you to retrieve call logs for your organization. It
  provides flexible filtering options and pagination to help you access the
  specific data you need.
---

# Get Call Logs



### Endpoint

```
GET https://www.tabbly.io/dashboard/agents/endpoints/call-logs
```

### Authentication

All requests require a valid API key associated with your organization.

### Required Parameters

| Parameter        | Type   | Description                                    |
| ---------------- | ------ | ---------------------------------------------- |
| api\_key         | string | Your organization's API key for authentication |
| organization\_id | string | The ID of your organization                    |



### Optional Parameters

| Parameter      | Type    | Description                                                |
| -------------- | ------- | ---------------------------------------------------------- |
| date\_from     | string  | Start date for filtering records (format: YYYY-MM-DD)      |
| date\_to       | string  | End date for filtering records (format: YYYY-MM-DD)        |
| call\_status   | string  | Filter by call status (e.g., "call answered", "voicemail") |
| campaign\_id   | string  | Filter by specific campaign ID                             |
| use\_agent\_id | string  | Filter by agent ID                                         |
| limit          | integer | Maximum number of records to return (default: 100)         |
| offset         | integer | Number of records to skip for pagination (default: 0)      |



### Response Format

The API returns data in JSON format.

#### Success Response

```json
jsonCopy{
  "status": "success",
  "message": "Call logs retrieved successfully",
  "total_records": 150,
  "filtered_records": 50,
  "page_size": 50,
  "page_offset": 0,
  "data": [
    {
      "id": "123",
      "called_to": "+15551234567",
      "use_agent_id": "45123",
      "called_time": "2025-03-12 14:30:00",
      "organization_id": "org_xyz789",
      "called_by_account": "account_123",
      "campaign_id": "campaign_456",
      "call_recording": "https://tabbly.io/recordings/call123.mp3",
      "call_duration": "245",
      "call_sentiment": "positive",
      "call_transcript": "Transcript of the call...",
      "call_json_output": "{\"key\":\"value\"}",
      "call_summary": "Summary of the call...",
      "call_status": "completed",
      "telco_pricing": "0.015",
      "agent_minute_price": "0.08",
      "total_call_cost": "0.98"
    },
    // Additional records...
  ]
}
```

#### Error Responses

**Missing Required Parameters**

```json
jsonCopy{
  "status": "error",
  "message": "API key and organization ID are required"
}
```

**Invalid API Key**

```json
jsonCopy{
  "status": "error",
  "message": "Invalid API key"
}
```

**Invalid Date Format**

```json
jsonCopy{
  "status": "error",
  "message": "Invalid date_from format. Use YYYY-MM-DD"
}
```

**Database Connection Error**

```json
jsonCopy{
  "status": "error",
  "message": "Database connection failed"
}
```

### Example Requests

#### Basic Request (Latest 100 Call Logs)

```
GET https://www.tabbly.io/dashboard/agents/endpoints/call-logs?api_key=YOUR_API_KEY&organization_id=YOUR_ORG_ID
```

#### Filtered Request (Date Range and Status)

```
GET https://www.tabbly.io/dashboard/agents/endpoints/call-logs?api_key=YOUR_API_KEY&organization_id=YOUR_ORG_ID&date_from=2025-01-01&date_to=2025-03-14&call_status=completed
```

#### Paginated Request (50 Records, Page 2)

```
GET https://www.tabbly.io/dashboard/agents/endpoints/call-logs?api_key=YOUR_API_KEY&organization_id=YOUR_ORG_ID&limit=50&offset=50
```

### Notes



* Results are sorted by ID in descending order (newest first)
* For large datasets, use the pagination parameters to improve performance
