Seasons

Overview

Lists all seasons configured for the resort. Most other flaik Connect endpoints take a seasonId as a path parameter, so this is usually the second call a new integrator makes (after Resort Details) — it provides the season identifiers needed to call Schedule, POS Integration, and Class Management endpoints.

Seasons are returned for the lifetime of the resort, including past, current, and future seasons. Use isCurrent to identify the season that is "now".

Authentication

Include your access token in the Authorization header:

Authorization: Bearer {access_token}

See the Authentication Guide for details on obtaining access tokens.

Endpoint

GET {api-url}/api/globalsettings/seasons

Path Parameters

None.

Query Parameters

None.

Example Request

GET {api-url}/api/globalsettings/seasons
Authorization: Bearer {access_token}

Response Format

[
  {
    "id": 17,
    "startDate": "2024-11-15",
    "endDate": "2025-04-30",
    "isCurrent": true,
    "amPmAvailableShiftTypesEnabled": true,
    "nameShort": "24/25",
    "nameLong": "Winter 2024–2025",
    "nameDescriptive": "Winter Season 2024/2025",
    "resortStartDate": "2024-11-29",
    "resortEndDate": "2025-04-15"
  },
  {
    "id": 16,
    "startDate": "2023-11-15",
    "endDate": "2024-04-30",
    "isCurrent": false,
    "amPmAvailableShiftTypesEnabled": false,
    "nameShort": "23/24",
    "nameLong": "Winter 2023–2024",
    "nameDescriptive": "Winter Season 2023/2024",
    "resortStartDate": "",
    "resortEndDate": ""
  }
]

Response Fields

Each item in the array represents a single season.

Field	Type	Description
id	integer	Unique season identifier — pass to other endpoints as seasonId
startDate	date	Operational season start (YYYY-MM-DD)
endDate	date	Operational season end (YYYY-MM-DD)
isCurrent	boolean	true if today's date falls within this season's operational range. Exactly one season is current at a time during normal operation.
amPmAvailableShiftTypesEnabled	boolean	true if AM/PM split shift types are enabled for this season
nameShort	string	Short display name (e.g. "24/25") — empty string if not set
nameLong	string	Long display name (e.g. "Winter 2024–2025") — empty string if not set
nameDescriptive	string	Descriptive name used in admin UIs — empty string if not set
resortStartDate	date	First day the resort is open to guests (empty string if not set) — may differ from startDate if shifts begin before lifts open
resortEndDate	date	Last day the resort is open to guests (empty string is not set)

Caching is safe — seasons change rarely (typically once a year). Cache the result for the duration of an integration session and refresh on application startup.

Error Responses

HTTP Status	Description
401	Missing or invalid access token

Need help with season configuration? Contact [e-mail].