Class Surveys by Date Range

Overview

Returns guest survey responses captured against classes in a date range — the answers guests gave to in-class survey questions, joined to the class and guest they relate to. Use this to ingest customer experience scores into reporting or NPS systems.

Heads up — two "surveys" endpoints

Flaik Connect exposes two different survey-related endpoints. They return different things:

• Class Survey Responses (this page, /api/classmanagement/surveys/{startDate}/{endDate}) — survey responses captured against classes. Use this to ingest the answers guests have given.

• Survey Definitions (/api/globalsettings/surveys/{seasonId}) — survey configuration for a season (titles, questions, hints). Use this to model the surveys themselves.

5-day window limit

The supplied date range must be 5 days or less (i.e. start and end can be at most 5 days apart). Walk longer windows in 5-day chunks — see the example loop on the Class Details by Date Range page.

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/classmanagement/surveys/{startDate}/{endDate}

Path Parameters

Parameter	Type	Required	Description
startDate	date	Yes	First day of the range, inclusive (YYYY-MM-DD)
endDate	date	Yes	Last day of the range, inclusive (YYYY-MM-DD). Must be ≤ 5 days after startDate.

Query Parameters

None.

Example Request

GET {api-url}/api/classmanagement/surveys/2025-01-15/2025-01-19
Authorization: Bearer {access_token}

Response Format

[
  {
    "id": 77001,
    "classId": 5012,
    "classGuestId": 88011,
    "guestId": 412,
    "identifierCode": "G412",
    "feedbackText": "Great instructor — Alex really enjoyed the day.",
    "questionResponses": [
      { "guestSurveyQuestionId": 41, "responseValue": 5 },
      { "guestSurveyQuestionId": 42, "responseValue": 4 },
      { "guestSurveyQuestionId": 43, "responseValue": null }
    ]
  }
]

Survey Response Fields

Each item in the top-level array represents one guest's complete response set against one class.

Field	Type	Description
id	integer	Unique survey response identifier
classId	integer	Class the response relates to (matches id in Class Details)
classGuestId	integer	Class-guest assignment identifier (matches classGuests[].id from Class Details)
guestId	integer	flaik guest identifier
identifierCode	string	External guest identifier — empty string if not set
feedbackText	string	Free-text feedback from the guest — empty string if no comment was given
questionResponses	array	Per-question answers (see fields below)

Question Response Fields (questionResponses[])

Field	Type	Description
guestSurveyQuestionId	integer	Question identifier — matches questions[].questionId from Survey Definitions
responseValue	integer	The numeric value the guest selected (e.g. 1–5 for a rating scale). null if the question was skipped or had no rating-style answer

Tip — joining responses to questions: The guestSurveyQuestionId here corresponds to questionId in the Survey Definitions response. To label or weight responses, fetch survey definitions once for the season and join client-side.

Error Responses

HTTP Status	Description
400	startDate or endDate is missing, malformed, or not a valid date
400	The supplied date range exceeds 5 days
401	Missing or invalid access token

Need help with survey ingest? Contact [e-mail].