# Get session details

Retrieve detailed information about a specific Meeting Buddy bot session.

Get the full session profile including status, timestamps, recording statistics, and participant information. For active sessions, statistics are updated in real time. For completed sessions, final recording and transcription information is included.

#### Path Parameters

**`session_id`** string required

The unique identifier of the session. Must start with `mbsess_` prefix.

## Returns

Returns a [Session object](/docs/api-reference/meeting-buddy/start-session#session-object) with full details including current status, timestamps, recording statistics, and participant data.

Request

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


```python Python SDK
from aitronos import Aitronos

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

session = client.meeting_buddy.get_session(
    session_id="mbsess_abc123def456",
)

print(f"Status: {session.status}")
print(f"Duration: {session.total_duration_seconds}s")
print(f"Segments: {session.segment_count}")
```


```python Python
import os
import requests

access_token = os.environ["ACCESS_TOKEN"]
session_id = "mbsess_abc123def456"

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

response = requests.get(url, headers=headers)
session = response.json()
print(f"Status: {session['status']}")
print(f"Duration: {session['total_duration_seconds']}s")
```


```javascript JavaScript
const accessToken = process.env.ACCESS_TOKEN;
const sessionId = 'mbsess_abc123def456';

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

const session = await response.json();
console.log('Status:', session.status);
console.log('Duration:', session.total_duration_seconds, 's');
```

Response

```json 200 OK
{
  "session_id": "mbsess_abc123def456",
  "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_abc123def456",
  "error_message": null,
  "error_code": null,
  "metadata": {},
  "current_participants": {},
  "participant_history": []
}
```


```json 403 Forbidden
{
  "success": false,
  "error": {
    "code": "SESSION_ACCESS_DENIED",
    "message": "You don't have access to this session",
    "type": "client_error",
    "status": 403,
    "details": {
      "session_id": "mbsess_abc123def456"
    },
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-11T10:00:00Z"
  }
}
```


```json 404 Not Found
{
  "success": false,
  "error": {
    "code": "SESSION_NOT_FOUND",
    "message": "Session not found",
    "type": "client_error",
    "status": 404,
    "details": {
      "session_id": "mbsess_abc123def456"
    },
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-11T10:00:00Z"
  }
}
```


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

## Related Resources

- [Start Session](/docs/api-reference/meeting-buddy/start-session)
- [List Sessions](/docs/api-reference/meeting-buddy/list-sessions)
- [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)