> For the complete documentation index, see [llms.txt](https://docs.api.intratool.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.intratool.de/api-reference/surveys.md).

# Surveys

The survey system consists of several closely connected components, each fulfilling a specific role in the process of collecting and evaluating feedback.

At the center are the [Survey](/api-reference/surveys/surveys.md), which define the poll or questionnaire itself. A [Survey](/api-reference/surveys/surveys.md) contains all relevant settings, such as the title, description, type, and rules for participation and visibility. It serves as the framework for gathering responses from [Users](/api-reference/users.md) or [Departments](/api-reference/departments.md).

The possible answer choices for each survey are managed through [SurveyAnswerOptions](/api-reference/surveys/survey-answer-options.md). These options represent the selectable responses that participants can choose from when taking part in a [Survey](/api-reference/surveys/surveys.md). Each [Survey](/api-reference/surveys/surveys.md) can have multiple [SurveyAnswerOptions](/api-reference/surveys/survey-answer-options.md), which can be sorted and are protected from modification once voting has started.

When [Users](/api-reference/users.md) participate in a [Survey](/api-reference/surveys/surveys.md), their responses are recorded as [SurveyVote](/api-reference/surveys/survey-votes.md). Each vote is associated with a specific [User](/api-reference/users.md), [Department](/api-reference/departments.md), and [Survey](/api-reference/surveys/surveys.md), and documents the time the vote was submitted. This ensures that participation is tracked accurately and transparently.

To capture which answer options were selected in each [SurveyVote](/api-reference/surveys/survey-votes.md), the system uses [SurveyVoteSelectedAnswerOptions](https://github.com/intratool/intratool-api-docs/blob/gitbook-en/api-reference/surveys/survey-vote-selected-answer-options.md). This component links each [SurveyVote](/api-reference/surveys/survey-votes.md) to the chosen [SurveyAnswerOptions](/api-reference/surveys/survey-answer-options.md), enabling detailed analysis and aggregation of [Survey](/api-reference/surveys/surveys.md) results.