# List sessions

List all Meeting Buddy bot sessions for the authenticated user's organization.

Retrieve a paginated list of all Meeting Buddy sessions belonging to the authenticated user's organization. Results can be filtered by status and date range.

#### Query Parameters

**`status`** string optional

Filter by session status. Valid values: `initializing`, `joining`, `active`, `recording`, `leaving`, `completed`, `failed`.

**`start_date`** string optional

Filter sessions created after this date. ISO 8601 format (e.g., `2025-12-01` or `2025-12-01T00:00:00Z`).

**`end_date`** string optional

Filter sessions created before this date. ISO 8601 format (e.g., `2025-12-31` or `2025-12-31T23:59:59Z`).

**`page`** integer optional · Defaults to `1`

Page number (minimum: 1).

**`page_size`** integer optional · Defaults to `20`

Number of items per page (minimum: 1, maximum: 100).

## Returns

Returns a paginated list of [Session objects](/docs/api-reference/meeting-buddy/start-session#session-object) with pagination metadata including `total`, `page`, `page_size`, and `total_pages`.

Request

```bash cURL
curl -s -X GET "https://api.aitronos.com/v1/meeting-buddy/sessions?status=active&page=1&page_size=20" \
  -H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.tool
```


```python Python SDK
from aitronos import Aitronos

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

result = client.meeting_buddy.list_sessions(
    status="active",
    page=1,
    page_size=20,
)

for session in result.sessions:
    print(f"{session.session_id}: {session.status}")
print(f"Total: {result.total}")
```


```python Python
import os
import requests

access_token = os.environ["ACCESS_TOKEN"]

url = "https://api.aitronos.com/v1/meeting-buddy/sessions"
headers = {"Authorization": f"Bearer {access_token}"}
params = {
    "status": "active",
    "page": 1,
    "page_size": 20,
}

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

for session in data["sessions"]:
    print(f"{session['session_id']}: {session['status']}")
print(f"Total: {data['total']}")
```


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

const params = new URLSearchParams({
  status: 'active',
  page: '1',
  page_size: '20',
});

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

const data = await response.json();
data.sessions.forEach(session => {
  console.log(`${session.session_id}: ${session.status}`);
});
console.log(`Total: ${data.total}`);
```

Response

```json 200 OK
{
  "sessions": [
    {
      "session_id": "mbsess_abc123",
      "organization_id": "org_xyz789",
      "user_id": "usr_user123",
      "meeting_link": "https://teams.microsoft.com/l/meetup-join/abc123",
      "platform": "teams",
      "bot_name": "Meeting Buddy",
      "status": "active",
      "transcription_enabled": true,
      "transcription_language": "en",
      "debug_mode": false,
      "created_at": "2025-12-11T10:00:00Z",
      "updated_at": "2025-12-11T10:05:00Z",
      "join_timestamp": "2025-12-11T10:01:00Z",
      "leave_timestamp": null,
      "total_duration_seconds": 300.5,
      "segment_count": 15,
      "audio_file_count": 15,
      "video_file_count": 0,
      "total_size_bytes": 52428800,
      "output_directory": "recordings/org_xyz789/mbsess_abc123",
      "error_message": null,
      "error_code": null,
      "metadata": {},
      "current_participants": {},
      "participant_history": []
    }
  ],
  "total": 42,
  "page": 1,
  "page_size": 20,
  "total_pages": 3
}
```


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


```json 422 Validation Error
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid date format",
    "type": "client_error",
    "status": 422,
    "details": {
      "field": "start_date"
    },
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-11T10:00:00Z"
  }
}
```

## Related Resources

- [Start Session](/docs/api-reference/meeting-buddy/start-session)
- [Get Session Details](/docs/api-reference/meeting-buddy/get-session)
- [Stop Session](/docs/api-reference/meeting-buddy/stop-session)
- [Get Transcripts](/docs/api-reference/meeting-buddy/get-transcripts)
- [Export Transcript](/docs/api-reference/meeting-buddy/export-transcript)
- [Delete Session](/docs/api-reference/meeting-buddy/delete-session)
- [Stream Session Status](/docs/api-reference/meeting-buddy/session-status-stream)
- [Stream Transcripts](/docs/api-reference/meeting-buddy/transcript-stream)
- [Stream Logs](/docs/api-reference/meeting-buddy/log-stream)
- [Analytics Summary](/docs/api-reference/meeting-buddy/analytics-summary)