--- updatedAt: 2025-12-30T10:24:09.000Z agentTools: projectIndex: https://developers.livestorm.co/llms.txt --- # Get a Session Retrieve a single session. > 📘 This endpoint requires the `events:read` or `events:write` scopes. {` `} Use this endpoint to retrieve a specific session from a given event. Additionally, you can specify whether you want the returned payload to include its related People and parent Event objects using the `include` GET filter. # OpenAPI definition ```json { "openapi": "3.0.3", "info": { "title": "Livestorm - Public API", "description": "Welcome to Livestorm's Public API documentation.\nThe Livestorm API is organized around REST principles.\nIn addition, all request and response bodies, including errors, are encoded in JSON format.\n", "termsOfService": "https://livestorm.co/terms/", "contact": { "name": "Contact", "url": "https://support.livestorm.co", "email": "help@livestorm.co" }, "version": "1" }, "servers": [ { "url": "https://{defaultHost}", "variables": { "defaultHost": { "default": "api.livestorm.co/v1" } } } ], "components": { "securitySchemes": { "api_key": { "type": "apiKey", "name": "Authorization", "in": "header" }, "oauth2": { "type": "oauth2", "flows": { "authorizationCode": { "authorizationUrl": "/oauth/authorize", "tokenUrl": "/oauth/token", "scopes": { "full:read": "Grants read access", "full:write": "Grants write access" } } } } }, "schemas": { "BaseResponse": { "type": "object", "properties": { "id": { "type": "string", "description": "ID" }, "type": { "type": "string", "description": "Type" } } } } }, "tags": [ { "name": "Sessions" } ], "paths": { "/sessions/{id}": { "get": { "summary": "Get a Session", "tags": [ "Sessions" ], "description": "Retrieve a single session.", "security": [ { "api_key": [] }, { "oauth2": [] } ], "parameters": [ { "name": "id", "in": "path", "schema": { "type": "string" }, "description": "Session ID", "required": true }, { "name": "include", "in": "query", "schema": { "type": "array", "items": { "type": "string", "enum": [ "event", "people", "chat_messages", "questions", "recordings" ] } }, "description": "Include Related Data", "required": false } ], "responses": { "200": { "description": "Get detail", "content": { "application/vnd.api+json": { "schema": { "type": "object", "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/BaseResponse" }, { "type": "object", "description": "Data", "properties": { "attributes": { "type": "object", "description": "Attributes", "properties": { "event_type_id": { "type": "string", "x-nullable": true, "description": "" }, "status": { "type": "string", "x-nullable": false, "description": "" }, "timezone": { "type": "string", "x-nullable": false, "description": "" }, "name": { "type": "string", "x-nullable": false, "description": "" }, "room_link": { "type": "string", "x-nullable": false, "description": "" }, "attendees_count": { "type": "integer", "x-nullable": false, "description": "" }, "duration": { "type": "integer", "x-nullable": true, "description": "" }, "estimated_started_at": { "type": "integer", "x-nullable": false, "description": "" }, "started_at": { "type": "integer", "x-nullable": true, "description": "" }, "ended_at": { "type": "integer", "x-nullable": true, "description": "" }, "canceled_at": { "type": "integer", "x-nullable": true, "description": "" }, "created_at": { "type": "integer", "x-nullable": false, "description": "" }, "updated_at": { "type": "integer", "x-nullable": false, "description": "" }, "registrants_count": { "type": "integer", "x-nullable": true, "description": "" } } } } } ] } }, "required": [ "data" ] }, "examples": { "application/vnd.api+json": { "value": { "data": { "id": "803ea3db-6297-46f8-87aa-d63cf00105b7", "type": "sessions", "attributes": { "event_id": "183947a7-7d15-4e8b-a10a-627555966536", "status": "draft", "timezone": "Europe/Paris", "room_link": "https://app.livestorm.co/p/183947a7-7d15-4e8b-a10a-627555966536/live?s=803ea3db-6297-46f8-87aa-d63cf00105b7", "name": "Beta Quadrant", "attendees_count": 0, "duration": null, "estimated_started_at": 1758672000, "started_at": 0, "ended_at": 0, "canceled_at": 0, "created_at": 1733759015, "updated_at": 1733759015, "registrants_count": 0, "breakout_room_parent_session_id": null } } } } } } }, "headers": { "RateLimit-Monthly-Remaining": { "schema": { "type": "integer" }, "description": "The number of requests remaining for the current month" }, "RateLimit-Monthly-Limit": { "schema": { "type": "integer" }, "description": "The number of allowed requests for the current month" }, "RateLimit-Interval-Remaining": { "schema": { "type": "integer" }, "description": "The number of requests remaining for the current rate limit window (1 second)" }, "RateLimit-Interval-Limit": { "schema": { "type": "integer" }, "description": "The number of allowed requests for the current period (1 second)" } } }, "401": { "description": "Authentication failed", "content": {} }, "403": { "description": "Workspace blocked", "content": {} }, "404": { "description": "Not found", "content": {} }, "429": { "description": "Too Many Requests", "content": {}, "headers": { "RateLimit-Interval-Limit": { "schema": { "type": "integer" }, "description": "The number of allowed requests for the current period (1 second)" }, "RateLimit-Interval-Remaining": { "schema": { "type": "integer" }, "description": "The number of remaining requests for the current period (1 second)" }, "Retry-After": { "schema": { "type": "integer" }, "description": "The number of seconds you are required to wait before the next successful request" }, "RateLimit-Reset": { "schema": { "type": "integer" }, "description": "A timestamp of when the limit will be reset" } } } } } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true } } ```