> For the complete documentation index, see [llms.txt](https://doc.evalytics.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.evalytics.nl/onderdelen/vragensets.md).

# Vragensets

## Overzichtstabel termen

|                           |                                                                                                                                                                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| code                      | De code van de vragenset                                                                                                                                                                                                                   |
| description               | Omschrijving van de vragenset                                                                                                                                                                                                              |
| name                      | Naam van de vragenset                                                                                                                                                                                                                      |
| questions                 | Een lijst met vragen die aan de vragensets gekoppeld zijn                                                                                                                                                                                  |
| status                    | De huidige status van de vragenset. ongoing = actief, draft = concept                                                                                                                                                                      |
| lockedBy                  | De huidige vragenset is **gelocked** door de aangegeven gebruiker. Het is dan niet meer mogelijk om de vragenset te bewerken door andere gebruikers.                                                                                       |
| organisationObject        | De organisatie die de eigenaar is van de vragenset                                                                                                                                                                                         |
| evaluationCount           | Het totaal aantal evaluaties wat gekoppeld is aan de vragenset, ongeacht de huidige organisatie/opleiding                                                                                                                                  |
| evaluationCountCurrentOrg | Het totaal aantal evaluaties wat gekoppeld is aan de vragenset binnen de huidige organisatie/opleiding                                                                                                                                     |
| createdByObject           | De gebruiker die de vragenset heeft aangemaakt                                                                                                                                                                                             |
| questionCount             | Het totaal aantal vragen binnen een vragenset                                                                                                                                                                                              |
| routing                   | Het is mogelijk om routering toe te passen voor een vragenset. Bij een bepaald antwoord op een vraag kan je dan extra vragen stellen of vragen overslaan. Als een vragenset routering gebruikt staat hierbinnen de routering gedefinieerd. |

## Vragensets ophalen (lijst)

<mark style="color:blue;">`GET`</mark> `https://api-portal.evalytics.nl/questionSet`

#### Query Parameters

| Name                   | Type    | Description                                                                                   |
| ---------------------- | ------- | --------------------------------------------------------------------------------------------- |
| q                      | string  | Zoek op vragensets (naam, omschrijving, code)                                                 |
| questionTypes          | array   | Filter op vraag type (1=cursus, 2=docent, 7=toets)                                            |
| countLinkedEvaluations | boolean | Voegt aan alle vragensets het totaal aantal evaluaties toe die gebruik maken van de vragenset |
| countQuestions         | boolean | Voegt aan alle vragensets het totaal aantal vragen toe                                        |
| hasRouting             | boolean | Filter op vragensets met vraag routering                                                      |

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

```
{
  "metadata": {
    "timestamp": "2021-06-22T11:21:11.409Z",
    "resultSet": {
      "count": 1
    }
  },
  "results": [
    {
      "deleted": 0,
      "createdBy": "bootstrap",
      "modifiedBy": null,
      "archived": 0,
      "status": "ongoing",
      "code": "XAMHUBXF",
      "name": "Verdieping 'Toets'",
      "description": "Deze verdiepende toetsvragen kunnen aanvullende context bieden op de toetsvragen gesteld in de standaard vragenset.",
      "isPreselection": 0,
      "routing": null,
      "lockedBy": null,
      "organisation": 418,
      "topOrganisation": 418,
      "id": 376,
      "createdAt": "2020-04-12T19:12:43.000Z",
      "updatedAt": "2020-04-12T19:12:43.000Z",
      "createdByObject": {
        "id": "3",
        "name": "Evalytics"
      },
      "organisationObject": {
        "id": 123,
        "name": "Example school"
      },
      "questionCount": 2,
      "evaluationCount": 0,
      "evaluationCountCurrentOrg": 0
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Vragenset ophalen (item)

<mark style="color:blue;">`GET`</mark> `https://api-portal.evalytics.nl/questionSet/:id`

#### Path Parameters

| Name | Type   | Description                 |
| ---- | ------ | --------------------------- |
| id   | string | Interne id van de vragenset |

#### Query Parameters

| Name                     | Type    | Description                               |
| ------------------------ | ------- | ----------------------------------------- |
| populateWithLockedByUser | boolean | Voegt toe wie de vragenset gelocked heeft |

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

```
{
  "lockedBy": null,
  "organisation": 418,
  "topOrganisation": 418,
  "deleted": false,
  "createdBy": "bootstrap",
  "modifiedBy": null,
  "archived": false,
  "status": "ongoing",
  "code": "XAMHUBXF",
  "name": "Verdieping 'Toets'",
  "description": "Deze verdiepende toetsvragen kunnen aanvullende context bieden op de toetsvragen gesteld in de standaard vragenset.",
  "isPreselection": false,
  "routing": null,
  "id": 376,
  "createdAt": "2020-04-12T19:12:43.000Z",
  "updatedAt": "2020-04-12T19:12:43.000Z",
  "questions": []
}
```

{% endtab %}
{% endtabs %}