# Get analytics summary

Get a dashboard summary with all key metrics for Meeting Buddy sessions.

Returns an aggregated summary of Meeting Buddy session metrics within a date range, including total sessions, active/completed/failed counts, average duration, success rate, platform distribution, and transcription usage. Defaults to the last 30 days if no date range is specified.

#### Query Parameters

**`start_date`** string optional

Start of date range (UTC, ISO 8601 format). Defaults to 30 days before `end_date`.

**`end_date`** string optional

End of date range (UTC, ISO 8601 format). Defaults to current time.

## Returns

Returns a summary object with the following fields:

| Field | Type | Description |
|  --- | --- | --- |
| `total_sessions` | integer | Total number of sessions in the date range |
| `active_sessions` | integer | Currently active sessions |
| `completed_sessions` | integer | Completed sessions |
| `failed_sessions` | integer | Failed sessions |
| `total_duration_hours` | number | Sum of all session durations in hours |
| `avg_duration_minutes` | number | Average session duration in minutes |
| `total_participants_unique` | integer | Approximate unique participant count |
| `platform_distribution` | object | Session counts by platform (e.g., `{"meet": 15, "zoom": 8}`) |
| `success_rate` | number | Ratio of completed to completed + failed sessions |
| `sessions_today` | integer | Sessions created today |
| `sessions_this_week` | integer | Sessions created in the last 7 days |
| `transcription_enabled_rate` | number | Fraction of sessions with transcription enabled |


Request

```bash cURL
curl -s -X GET "https://api.aitronos.com/v1/meeting-buddy/analytics/summary?start_date=2025-12-01T00:00:00Z&end_date=2025-12-31T23:59:59Z" \
  -H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.tool
```


```python Python SDK
from aitronos import Aitronos

client = Aitronos(api_key="your-api-key")

summary = client.meeting_buddy.get_analytics_summary(
    start_date="2025-12-01T00:00:00Z",
    end_date="2025-12-31T23:59:59Z",
)

print(f"Total sessions: {summary.total_sessions}")
print(f"Success rate: {summary.success_rate:.1%}")
print(f"Avg duration: {summary.avg_duration_minutes:.1f} min")
```


```python Python
import os
import requests

access_token = os.environ["ACCESS_TOKEN"]

url = "https://api.aitronos.com/v1/meeting-buddy/analytics/summary"
headers = {"Authorization": f"Bearer {access_token}"}
params = {
    "start_date": "2025-12-01T00:00:00Z",
    "end_date": "2025-12-31T23:59:59Z",
}

response = requests.get(url, headers=headers, params=params)
summary = response.json()
print(f"Total sessions: {summary['total_sessions']}")
print(f"Success rate: {summary['success_rate']:.1%}")
```


```javascript JavaScript
const accessToken = process.env.ACCESS_TOKEN;

const params = new URLSearchParams({
  start_date: '2025-12-01T00:00:00Z',
  end_date: '2025-12-31T23:59:59Z',
});

const response = await fetch(
  `https://api.aitronos.com/v1/meeting-buddy/analytics/summary?${params}`,
  {
    headers: {
      'Authorization': `Bearer ${accessToken}`,
    },
  }
);

const summary = await response.json();
console.log('Total sessions:', summary.total_sessions);
console.log('Success rate:', (summary.success_rate * 100).toFixed(1) + '%');
```

Response

```json 200 OK
{
  "total_sessions": 156,
  "active_sessions": 3,
  "completed_sessions": 142,
  "failed_sessions": 11,
  "total_duration_hours": 234.5,
  "avg_duration_minutes": 45.2,
  "total_participants_unique": 89,
  "platform_distribution": {
    "teams": 82,
    "zoom": 45,
    "meet": 24,
    "webex": 5
  },
  "success_rate": 0.928,
  "sessions_today": 5,
  "sessions_this_week": 28,
  "transcription_enabled_rate": 0.95
}
```


```json 401 Unauthorized
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication is required to access this resource.",
    "type": "client_error",
    "status": 401,
    "details": {},
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-11T10:00:00Z"
  }
}
```

## Related Resources

- [Active Sessions](/docs/api-reference/meeting-buddy/analytics-active)
- [Session Trends](/docs/api-reference/meeting-buddy/analytics-trends)
- [Platform Breakdown](/docs/api-reference/meeting-buddy/analytics-platform-breakdown)
- [Status Breakdown](/docs/api-reference/meeting-buddy/analytics-status-breakdown)
- [Duration Distribution](/docs/api-reference/meeting-buddy/analytics-duration-distribution)
- [Failure Analysis](/docs/api-reference/meeting-buddy/analytics-failure-analysis)
- [List Sessions](/docs/api-reference/meeting-buddy/list-sessions)