# Get session trends

Get time-series session trends for Meeting Buddy sessions.

Returns session count, completion, failure, and duration trends over time, bucketed by day, week, or month. Useful for tracking usage patterns and identifying growth or decline in meeting recording activity. Defaults to the last 30 days with daily granularity.

#### 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.

**`granularity`** string optional · Defaults to `"day"`

Time bucketing level. Valid values: `day`, `week`, `month`.

## Returns

Returns a trends object containing the granularity and an array of data points:

| Field | Type | Description |
|  --- | --- | --- |
| `granularity` | string | Bucketing level used (`day`, `week`, or `month`) |
| `data` | array | Array of trend data points |


Each data point contains:

| Field | Type | Description |
|  --- | --- | --- |
| `period` | string | Period label (e.g., `"2025-12-15"` or `"2025-W50"`) |
| `session_count` | integer | Total sessions in the period |
| `completed_count` | integer | Completed sessions |
| `failed_count` | integer | Failed sessions |
| `total_duration_hours` | number | Total duration in hours |
| `avg_duration_minutes` | number | Average session duration in minutes |


Request

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


```python Python SDK
from aitronos import Aitronos

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

trends = client.meeting_buddy.get_trends(
    granularity="week",
    start_date="2025-12-01T00:00:00Z",
)

print(f"Granularity: {trends.granularity}")
for point in trends.data:
    print(f"  {point.period}: {point.session_count} sessions, "
          f"{point.completed_count} completed")
```


```python Python
import os
import requests

access_token = os.environ["ACCESS_TOKEN"]

url = "https://api.aitronos.com/v1/meeting-buddy/analytics/trends"
headers = {"Authorization": f"Bearer {access_token}"}
params = {"granularity": "week", "start_date": "2025-12-01T00:00:00Z"}

response = requests.get(url, headers=headers, params=params)
trends = response.json()

for point in trends["data"]:
    print(f"{point['period']}: {point['session_count']} sessions")
```


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

const params = new URLSearchParams({
  granularity: 'week',
  start_date: '2025-12-01T00:00:00Z',
});

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

const trends = await response.json();
trends.data.forEach(point => {
  console.log(`${point.period}: ${point.session_count} sessions`);
});
```

Response

```json 200 OK
{
  "granularity": "week",
  "data": [
    {
      "period": "2025-W49",
      "session_count": 35,
      "completed_count": 32,
      "failed_count": 3,
      "total_duration_hours": 52.3,
      "avg_duration_minutes": 44.8
    },
    {
      "period": "2025-W50",
      "session_count": 42,
      "completed_count": 40,
      "failed_count": 2,
      "total_duration_hours": 68.1,
      "avg_duration_minutes": 48.6
    },
    {
      "period": "2025-W51",
      "session_count": 38,
      "completed_count": 35,
      "failed_count": 3,
      "total_duration_hours": 55.7,
      "avg_duration_minutes": 43.9
    }
  ]
}
```


```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

- [Analytics Summary](/docs/api-reference/meeting-buddy/analytics-summary)
- [Active Sessions](/docs/api-reference/meeting-buddy/analytics-active)
- [Platform Breakdown](/docs/api-reference/meeting-buddy/analytics-platform-breakdown)
- [Duration Distribution](/docs/api-reference/meeting-buddy/analytics-duration-distribution)
- [Failure Analysis](/docs/api-reference/meeting-buddy/analytics-failure-analysis)