GET sessions/get | ExpoPlatform Helpdesk

GET `/api/v2/sessions/get`

Returns a list of sessions for the specified event, optionally filtered by a timestamp and optionally including scheduled participant details.

Authentication

Authorization: Bearer <your_api_key>

Endpoint

GET /api/v2/sessions/get

Query Parameters

Parameter	Type	Required	Default	Description
`event_id`	integer	Yes	—	The ID of the event to retrieve sessions for
`timestamp`	integer	No	`0`	Unix timestamp. When provided, only sessions updated after this timestamp are returned. Useful for incremental synchronisation
`with_accounts`	boolean	No	`false`	When set to `true`, scheduled participant details are included in each session

Response Format

Success Response (HTTP 200)

JSON

{
  "code": 200,
  "response_id": "...",
  "data": [ ... ]
}

The data field contains an array of session objects.

Session Object Fields

Field	Type	Nullable	Description
`id`	integer	No	Unique session ID
`external_id`	string	Yes	External identifier from your system
`exhibitor_id`	integer	Yes	Associated exhibitor ID, if this session belongs to an exhibitor
`start`	integer	No	Session start time as a Unix timestamp
`end`	integer	No	Session end time as a Unix timestamp
`title`	string	No	Session title
`description`	string	Yes	Session description
`abstract`	string	Yes	Session abstract
`track`	integer	No	Track (event category) ID
`type`	integer	No	Session type ID
`hall_id`	integer	No	Hall ID (location)
`stand_id`	integer	Yes	Stand ID, if applicable
`isActive`	boolean	No	Whether the session is currently active
`isFeatured`	boolean	No	Whether the session is featured
`visibleToCategories`	string	Yes	Visibility restrictions by participant category. `null` means visible to all
`speakers`	object	Yes	Map of speaker account IDs assigned to this session
`moderators`	object	Yes	Map of moderator account IDs assigned to this session
`sponsors`	array	Yes	Array of sponsor IDs
`tags`	array[integer]	No	Array of tag IDs associated with this session
`price`	integer	No	Session price. `0` means free
`capacity`	integer	No	Maximum number of attendees. `0` means unlimited
`max_shedule`	integer	No	Maximum schedule slots
`round_table`	boolean	No	Whether this is a round-table format session
`last_update`	integer	No	Unix timestamp of the last modification

Error Responses

HTTP Code	Condition	Error Message
400	`event_id` is missing	`Missing required parameter: event_id`
400	`event_id` is not a valid integer	`Param must be a integer: event_id`
400	No event found with the given ID	`Could not find an event with id = {event_id}`
403	Missing or invalid API key	`Forbidden`

Example Request

Bash

curl -X GET "https://your-event-domain.com/api/v2/sessions/get?event_id=7&timestamp=1678000000&with_accounts=true" \
  -H "Authorization: Bearer your_api_key_here"

Best Practices

Incremental Synchronisation

Use the timestamp parameter to retrieve only sessions updated since your last sync
Store the last_update value from the most recently updated session and use it in subsequent requests

Scheduling Data

Set with_accounts=true only when you need scheduled participant details, as it increases response size
Speaker and moderator IDs can be cross-referenced with the Participants endpoint to retrieve full profile data