> For the complete documentation index, see [llms.txt](https://knowledgebase.flaik.com/flaik-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.flaik.com/flaik-knowledge-base/for-it-specialists/3.-flaik-connect-api/global-settings/seasons.md).

# 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](https://knowledgebase.flaik.com/flaik-knowledge-base/for-it-specialists/3.-flaik-connect-api/global-settings/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:

```http
Authorization: Bearer {access_token}
```

See the [Authentication Guide](https://knowledgebase.flaik.com/flaik-knowledge-base/for-it-specialists/3.-flaik-connect-api/overview/authentication) for details on obtaining access tokens.

## Endpoint

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

**Path Parameters**

None.

**Query Parameters**

None.

**Example Request**

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

**Response Format**

```json
[
  {
    "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)                                                                       |

{% hint style="info" %}
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.
{% endhint %}

## Error Responses

| HTTP Status | Description                     |
| ----------- | ------------------------------- |
| `401`       | Missing or invalid access token |

Need help with season configuration? Contact <resortsupport@flaik.com>.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://knowledgebase.flaik.com/flaik-knowledge-base/for-it-specialists/3.-flaik-connect-api/global-settings/seasons.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.