> ## Documentation Index
> Fetch the complete documentation index at: https://marinabox.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Sessions

> Retrieve all active sessions using the MarinaBox SDK

## List Active Sessions

Returns a list of all currently active sessions.

### Python SDK

```python theme={null}
from marinabox import MarinaboxSDK

sdk = MarinaboxSDK()
sessions = sdk.list_sessions()  # Returns List[BrowserSession]

# Print session details
for session in sessions:
    print(f"Session ID: {session.session_id}")
    print(f"VNC Port: {session.vnc_port}")
    print(f"Status: {session.status}")
```

### Response Objects

The method returns a list of `BrowserSession` objects, each containing:

```python theme={null}
{
    "session_id": "abc123xyz",
    "container_id": "abc123xyz789",
    "vnc_port": 5002,
    "created_at": "2024-12-14T10:30:00Z",
    "env_type": "browser",
    "debug_port": 4002,
    "status": "running",
    "runtime_seconds": 3600,
    "tag": "Development"
}
```

### Error Handling

```python theme={null}
try:
    sessions = sdk.list_sessions()
except Exception as e:
    print(f"Failed to list sessions: {e}")
```

***

### Get Support & Join Our Community

* Discord: [https://discord.gg/nAyFBSSU87](https://discord.gg/nAyFBSSU87)
* Email: [askmarinabox@gmail.com](mailto:askmarinabox@gmail.com)
