# SurveyVoteSelectedAnswerOptions

## Introduction

`SurveyVoteSelectedAnswerOptions` represent the selected [SurveyAnswerOptions](https://docs.api.intratool.de/api-reference/surveys/survey-answer-options) for each [SurveyVote](https://docs.api.intratool.de/api-reference/surveys/survey-votes). They allow you to analyze which [SurveyAnswerOptions](https://docs.api.intratool.de/api-reference/surveys/survey-answer-options) were chosen by [Users](https://docs.api.intratool.de/api-reference/users) for a given [Survey](https://docs.api.intratool.de/api-reference/surveys/surveys), and to aggregate results for reporting and statistics. These entities are read-only and are managed automatically when [Users](https://docs.api.intratool.de/api-reference/users) vote.

## Model Definition

### Alias

`surveyVoteSelectedAnswerOption`

### Relations

| Key                  | Relation                                                                                        | Type       | Relation Field(s)         |
| -------------------- | ----------------------------------------------------------------------------------------------- | ---------- | ------------------------- |
| `surveyVote`         | [SurveyVote](https://docs.api.intratool.de/api-reference/surveys/survey-votes)                  | Belongs to | `survey_vote_id`          |
| `surveyAnswerOption` | [SurveyAnswerOption](https://docs.api.intratool.de/api-reference/surveys/survey-answer-options) | Belongs to | `survey_answer_option_id` |

## List by Survey

Get a list of all `SurveyVoteSelectedAnswerOptions` for a given [Survey](https://docs.api.intratool.de/api-reference/surveys/surveys).

**Definition**

<mark style="color:green;">`GET`</mark> `/api/surveys/{survey}/selected-answer-options`

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('GET', '/api/surveys/1/selected-answer-options', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
[
  {
    "id": 1,
    "survey_vote_id": 1,
    "survey_answer_option_id": 2,
    "created_at": "2024-07-15 12:00:00",
    "updated_at": "2024-07-15 12:00:00"
  },
  {
    "id": 2,
    "survey_vote_id": 2,
    "survey_answer_option_id": 3,
    "created_at": "2024-07-15 13:00:00",
    "updated_at": "2024-07-15 13:00:00"
  }
]
```

## Summary by Survey

Get a summary (grouped count) of selected [SurveyAnswerOptions](https://docs.api.intratool.de/api-reference/surveys/survey-answer-options) for a given [Survey](https://docs.api.intratool.de/api-reference/surveys/surveys).

**Definition**

<mark style="color:green;">`GET`</mark> `/api/surveys/{survey}/selected-answer-options/summary`

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('GET', '/api/surveys/1/selected-answer-options/summary', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
[
  {
    "survey_answer_option_id": 2,
    "count": 5
  },
  {
    "survey_answer_option_id": 3,
    "count": 3
  }
]
```