cURL

curl -X GET "https://api.swoogo.com/api/v1/sessions?event_id=123&fields=id,name,date,start_time,end_time,capacity&expand=speakers,location&sort=date" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "items": [
    {
      "id": 1,
      "event_id": 12345,
      "name": "Event Management Basics",
      "admin_short_name": "MgmtBasics",
      "badge_name": "Basics of Management",
      "description": "An interactive workshop on event management fundamentals.",
      "date": "2025-08-08",
      "start_time": "11:45:00",
      "end_time": "12:45:00",
      "times_with_timezone": "10:00 AM - 12:00 PM (+09)",
      "use_event_timezone": true,
      "timezone": "Europe/London",
      "capacity": 20,
      "notes": null,
      "location": null,
      "location_id": null,
      "track": null,
      "track_id": null,
      "session_included": false,
      "locked_when_saved": true,
      "selected_by_default": false,
      "prevent_session_conflicts": false,
      "session_status": "live",
      "webinar_url": "",
      "direct_link": "https://demo.swoogo.com/test-event/session/1/admin-name",
      "virtual_link": "https://local.demo.swoogo.com/test-event/v/s-1",
      "created_at": "2025-04-21 15:46:23",
      "updated_at": "2025-04-21 15:47:37"
    }
  ],
  "_links": {
    "self": {
      "href": ""
    },
    "first": {
      "href": ""
    },
    "last": {
      "href": ""
    }
  },
  "_meta": {
    "totalCount": 1,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 20
  }
}

Sessions

Get All Sessions

Retrieves a paginated list of sessions for a specific event. Returns session scheduling, capacity, track, and configuration details.

Requires event_id as a query parameter. Use fields to control which fields are returned. Use search to filter by any session field (e.g., date=2025-08-08, session_status=live, name=*keynote*). Supports operators: =, !=, >=, <=, >, <, *contains*, *beginswith*, *endswith*.

Use expand to include related objects: speakers, location, track, translations, sessionAttendance, registrantCount, reservedCount, earlyBirds. Results are paginated with a maximum of 200 per page.

Available Fields

These are the standard fields available for configuring a session:

Name	Type	Description
`id`	integer	Unique identifier for the session.
`event_id`	integer	ID of the event associated with this session.
`name`	string	Title or name of the session.
`admin_short_name`	string	Admin-specific short name for internal usage.
`badge_name`	string	Display name on attendee badges.
`description`	string	Detailed description of the session.
`date`	string (date)	The date when the session will take place.
`start_time`	string (time)	Start time of the session.
`end_time`	string (time)	End time of the session.
`use_event_timezone`	integer	Whether the event’s default timezone is applied to the session.
`timezone`	string	Timezone for the session (see TZ Identifier column in the List of TZ Database Time Zones).
`capacity`	integer	Maximum number of attendees allowed.
`location_id`	integer	Identifier for the location.
`track_id`	integer	Identifier for the session’s track.
`selection_control`	string	Specifies whether the session is optional or included by default, setting the value ‘session_included’.
`webinar_url`	string (uri)	URL for the webinar if the session is virtual.
`sold_out_message`	string	Custom message displayed when the session is sold out.
`secure_id`	string	Secure identifier for the session.
`session_status`	string	Current status of the session. Possible values: `submitted`, `approved`, `rejected`, `converted`, `live`.
`locked_when_saved`	boolean	Whether the session is locked after being saved.
`selected_by_default`	boolean	Indicates if the session is selected by default for attendees.
`prevent_session_conflicts`	boolean	Whether should prevent conflicts with other sessions when selecting this session.
`custom_fields`	object	Custom fields associated with the session. Key-value pairs can be dynamic.

Extra Fields

This is the extra information that can be returned if required by specifying what you need in the expand variable:

Name	Type	Description
`speakers`	object	List of speakers assigned to this session
`location`	object	Selected Location for this event
`track`	object	Selected track for this event
`translations`	object	Custom translations set for this event
`sessionAttendance`	object	Session Attendance Information
`registrantCount`	object	Number of Registrants registered to this session
`reservedCount`	object	Number of Reserved seats for this session
`earlyBirds`	object	List all available early birds for this session

GET

sessions

cURL

curl -X GET "https://api.swoogo.com/api/v1/sessions?event_id=123&fields=id,name,date,start_time,end_time,capacity&expand=speakers,location&sort=date" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "items": [
    {
      "id": 1,
      "event_id": 12345,
      "name": "Event Management Basics",
      "admin_short_name": "MgmtBasics",
      "badge_name": "Basics of Management",
      "description": "An interactive workshop on event management fundamentals.",
      "date": "2025-08-08",
      "start_time": "11:45:00",
      "end_time": "12:45:00",
      "times_with_timezone": "10:00 AM - 12:00 PM (+09)",
      "use_event_timezone": true,
      "timezone": "Europe/London",
      "capacity": 20,
      "notes": null,
      "location": null,
      "location_id": null,
      "track": null,
      "track_id": null,
      "session_included": false,
      "locked_when_saved": true,
      "selected_by_default": false,
      "prevent_session_conflicts": false,
      "session_status": "live",
      "webinar_url": "",
      "direct_link": "https://demo.swoogo.com/test-event/session/1/admin-name",
      "virtual_link": "https://local.demo.swoogo.com/test-event/v/s-1",
      "created_at": "2025-04-21 15:46:23",
      "updated_at": "2025-04-21 15:47:37"
    }
  ],
  "_links": {
    "self": {
      "href": ""
    },
    "first": {
      "href": ""
    },
    "last": {
      "href": ""
    }
  },
  "_meta": {
    "totalCount": 1,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 20
  }
}

Authorizations

Authorization

string

header

required

OAuth 2.0 bearer token obtained from POST /oauth2/token. Tokens expire after 30 minutes. Include in the Authorization header as Bearer {access_token}.

Query Parameters

event_id

integer

required

integer - required - The ID of the event you want to retrieve sessions for

Example:

1

fields

string

string - optional - Comma separated list of fields you want to return

Example:

"id,event_id,name,admin_short_name,badge_name,description,date,start_time,end_time,times_with_timezone,use_event_timezone,timezone,capacity,notes,location,location_id,track,track_id,session_included,webinar_url,type_id,direct_link,virtual_link,created_at,updated_at"

expand

string

string - optional - Comma separated list of objects you want to return

Example:

"track"

string

string - optional - Filter conditions to narrow the results. Valid operators are =, !=, >=, <=, >, <, contains, beginswith, endswith

Example:

"id>123"

page

string

integer - optional - The page of results you want to view

Example:

"1"

per-page

string

integer - optional - The number of results per page (to a max of 200)

Example:

"5"

sort

string

string - optional - Sort the results (add - in front for opposite sort direction, e.g. "-id")

ids

string

Comma-separated list of IDs to retrieve. When provided, only records matching these IDs are returned. All values must be positive integers. Maximum 100 IDs per request.

Response

Collection

items

object[]

Show child attributes

_links

object

Show child attributes

_meta

object

Show child attributes

Overview

Get One Session

⌘I