> 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/survey-definitions-by-season.md).

# Survey Definitions by Season

## Overview

Returns the **guest survey definitions** configured for a season — the surveys themselves, plus the questions that make up each survey. Use this when you need to know what surveys exist and what they ask.

> **Heads up — two "surveys" endpoints**
>
> flaik Connect exposes two different survey-related endpoints. They return different things:
>
> * **Survey Definitions** (this page, `/api/globalsettings/surveys/{seasonId}`) — survey **configuration** for a season: titles, questions, hints. Use this to model surveys in your system.
> * [**Class Survey Responses**](https://knowledgebase.flaik.com/flaik-knowledge-base/for-it-specialists/3.-flaik-connect-api/class-management/class-surveys-by-date-range) (`/api/classmanagement/surveys/{startDate}/{endDate}`) — survey **responses** captured against classes. Use this to ingest the answers guests have given.

## 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/surveys/{seasonId}
```

**Path Parameters**

| Parameter  | Type    | Required | Description                                                                                                                                                                    |
| ---------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `seasonId` | integer | Yes      | Season identifier — retrieve from the [Seasons](https://knowledgebase.flaik.com/flaik-knowledge-base/for-it-specialists/3.-flaik-connect-api/global-settings/seasons) endpoint |

**Query Parameters**

None.

**Example Request**

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

**Response Format**

```json
[
  {
    "id": 12,
    "title": "End of lesson — guest experience",
    "status": 1,
    "questions": [
      {
        "questionId": 41,
        "questionText": "How would you rate today's lesson overall?",
        "status": 1,
        "orderHint": 1,
        "minHint": "Very poor",
        "midHint": "Average",
        "maxHint": "Excellent"
      },
      {
        "questionId": 42,
        "questionText": "How likely are you to recommend us to a friend?",
        "status": 1,
        "orderHint": 2,
        "minHint": "Not at all",
        "midHint": "Maybe",
        "maxHint": "Definitely"
      }
    ]
  }
]
```

**Response Fields — Survey**

Each item in the top-level array represents a single survey definition.

| Field       | Type    | Description                                                         |
| ----------- | ------- | ------------------------------------------------------------------- |
| `id`        | integer | Unique survey identifier                                            |
| `title`     | string  | Survey display title                                                |
| `status`    | integer | Survey lifecycle status — see [Status Values](#status-values) below |
| `questions` | array   | The questions that make up this survey, in display order            |

**Response Fields — Question**

| Field          | Type    | Description                                                               |
| -------------- | ------- | ------------------------------------------------------------------------- |
| `questionId`   | integer | Unique question identifier                                                |
| `questionText` | string  | The question shown to the guest                                           |
| `status`       | integer | Question lifecycle status — see [Status Values](#status-values) below     |
| `orderHint`    | integer | Suggested display order within the survey (lower numbers first)           |
| `minHint`      | string  | Label shown next to the lowest end of a rating scale (e.g. `"Very poor"`) |
| `midHint`      | string  | Label shown at the midpoint of a rating scale                             |
| `maxHint`      | string  | Label shown next to the highest end of a rating scale                     |

### Status Values

Both `status` fields use the same set of values:

| Value | Meaning  |
| ----- | -------- |
| `1`   | Active   |
| `2`   | Inactive |

Surveys and questions can be marked inactive without being deleted. Filter on `status: 1` if you only want what's currently in use.

## Error Responses

| HTTP Status | Description                                            |
| ----------- | ------------------------------------------------------ |
| `400`       | The supplied `seasonId` does not exist for this resort |
| `401`       | Missing or invalid access token                        |

Need help with survey 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/survey-definitions-by-season.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.