# Get status breakdown

Get session counts grouped by status.

Returns a breakdown of Meeting Buddy sessions by their current status within the specified date range. Each item includes the count and percentage of total. Defaults to the last 30 days.

#### 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 breakdown object:

| Field | Type | Description |
|  --- | --- | --- |
| `dimension` | string | Always `"status"` for this endpoint |
| `total` | integer | Total sessions across all statuses |
| `items` | array | Breakdown items, one per status |


Each item contains:

| Field | Type | Description |
|  --- | --- | --- |
| `label` | string | Status name (e.g., `"completed"`, `"failed"`, `"active"`) |
| `count` | integer | Number of sessions with this status |
| `percentage` | number | Percentage of total sessions |


Request

```bash cURL
curl -s -X GET "https://api.aitronos.com/v1/meeting-buddy/analytics/status-breakdown" \
  -H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.tool
```


```python Python SDK
from aitronos import Aitronos

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

breakdown = client.meeting_buddy.get_status_breakdown()

print(f"Total: {breakdown.total}")
for item in breakdown.items:
    print(f"  {item.label}: {item.count} ({item.percentage:.1f}%)")
```


```python Python
import os
import requests

access_token = os.environ["ACCESS_TOKEN"]

url = "https://api.aitronos.com/v1/meeting-buddy/analytics/status-breakdown"
headers = {"Authorization": f"Bearer {access_token}"}

response = requests.get(url, headers=headers)
data = response.json()

for item in data["items"]:
    print(f"{item['label']}: {item['count']} ({item['percentage']:.1f}%)")
```


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

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

const data = await response.json();
data.items.forEach(item => {
  console.log(`${item.label}: ${item.count} (${item.percentage.toFixed(1)}%)`);
});
```

Response

```json 200 OK
{
  "dimension": "status",
  "total": 156,
  "items": [
    {
      "label": "completed",
      "count": 142,
      "percentage": 91.0
    },
    {
      "label": "failed",
      "count": 11,
      "percentage": 7.1
    },
    {
      "label": "active",
      "count": 2,
      "percentage": 1.3
    },
    {
      "label": "initializing",
      "count": 1,
      "percentage": 0.6
    }
  ]
}
```


```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)
- [Platform Breakdown](/docs/api-reference/meeting-buddy/analytics-platform-breakdown)
- [Failure Analysis](/docs/api-reference/meeting-buddy/analytics-failure-analysis)
- [Session Trends](/docs/api-reference/meeting-buddy/analytics-trends)