{"id":26611639,"url":"https://github.com/elisaado/somtoday-api-docs","last_synced_at":"2025-04-09T13:08:37.857Z","repository":{"id":38320376,"uuid":"128410073","full_name":"elisaado/somtoday-api-docs","owner":"elisaado","description":"Documentation for the SOMtoday API","archived":false,"fork":false,"pushed_at":"2025-03-27T14:54:12.000Z","size":246,"stargazers_count":74,"open_issues_count":3,"forks_count":17,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-02T11:08:15.577Z","etag":null,"topics":["api","documentation","markdown","rest","reverse-engineering","school","somtoday"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elisaado.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-06T15:05:12.000Z","updated_at":"2025-03-30T16:51:34.000Z","dependencies_parsed_at":"2024-04-04T23:26:45.552Z","dependency_job_id":"da6e22d5-40b5-43d5-9f28-8cce0fff0705","html_url":"https://github.com/elisaado/somtoday-api-docs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elisaado%2Fsomtoday-api-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elisaado%2Fsomtoday-api-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elisaado%2Fsomtoday-api-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elisaado%2Fsomtoday-api-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elisaado","download_url":"https://codeload.github.com/elisaado/somtoday-api-docs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248045233,"owners_count":21038553,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","documentation","markdown","rest","reverse-engineering","school","somtoday"],"created_at":"2025-03-24T02:49:26.632Z","updated_at":"2025-04-09T13:08:37.838Z","avatar_url":"https://github.com/elisaado.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# SOMtoday REST API docs\n\n#### Discord\n\n[![Discord Chat](https://img.shields.io/discord/789249810032361502.svg)](https://discord.gg/yE3e3erCut)\n\n## Table of contents\n\n\u003c!-- TOC --\u003e\n\n- [SOMtoday REST API docs](#somtoday-rest-api-docs)\n  - [Discord](#discord)\n  - [Table of contents](#table-of-contents)\n  - [Some miscellaneous stuff](#some-miscellaneous-stuff)\n  - [Authentication / authorization](Authentication.md)\n    - [Getting a list of schools](Authentication.md#getting-a-list-of-schools)\n    - [Authentication by mimicking the SOMToday app/webapp](Authentication.md#authentication-by-mimicking-the-somtoday-appwebapp)\n    - [Fetching the access token via SSO](Authentication.md#authentication-using-sso-single-sign-on)\n    - [Fetching the access token via Somtoday login: `POST /oauth2/token`](Authentication.md#fetching-the-access-token-via-somtoday-login)\n    - [Refreshing the token: `POST /oauth2/token`](Authentication.md#refreshing-the-access-token)\n  - [Fetching information](#fetching-information)\n    - [Current student(s): `GET /rest/v1/leerlingen`](#current-students-get-restv1leerlingen)\n    - [Student by ID: `GET /rest/v1/leerlingen/[id]`](#student-by-id-get-restv1leerlingenid)\n    - [Grades: `GET /rest/v1/resultaten/huidigVoorLeerling/[id]`](#grades-get-restv1resultatenhuidigvoorleerlingid)\n    - [Schedule: `GET /rest/v1/afspraken`](#schedule-get-restv1afspraken)\n    - [Absence Reports: `GET /rest/v1/absentiemeldingen`](#absence-reports-get-restv1absentiemeldingen)\n    - [Study Guides: `GET /rest/v1/studiewijzers`](#study-guides-get-restv1studiewijzers)\n    - [Subjects: `GET /rest/v1/vakken`](#subjects-get-restv1vakken)\n    - [User Account: `GET /rest/v1/account`](#account-get-restv1account--get-restv1accountid)\n    - [School Years: `GET /rest/v1/schooljaren`](#schooljaren-get-restv1schooljaren--get-restv1schooljarenid)\n    - [Vakkeuzes: `GET /rest/v1/vakkeuzes`](#vakkeuzes-get-restv1vakkeuzes)\n    - [Waarnemingen: `GET /rest/v1/waarnemingen`](#waarnemingen-get-restv1waarnemingen)\n    - [Messages: `GET /rest/v1/boodschappen/conversaties`](#messages-get-restv1boodschappenconversaties)\n    - [Schoolgegevens: `GET /rest/v1/leerlingen/[id]/schoolgegevens`](#schoolgegevens-get-restv1idschoolgegevens)\n    - [Vakanties: `GET /rest/v1/vakanties/leerling/[id]`](#vakanties-get-restv1vakantiesleerlingid)\n    - [Studiemateriaal: `GET /rest/v1/vakken/studiemateriaal/[id]` \u0026 `GET rest/v1/vakken/studiemateriaal/[id]/vak/[uuid]` \u0026 `/rest/v1/studiemateriaal/algemeen/[id]`](#studiemateriaal-get-restv1vakkenstudiemateriaalid--get-restv1vakkenstudiemateriaalidvakuuid--restv1studiemateriaalalgemeenid)\n    - [ICalendar: `GET /rest/v1/icalendar`](#icalendar-get-restv1icalendar)\n    - [ICalendar: `DELETE /rest/v1/icalendar`](#icalendar-delete-restv1icalendar)\n  - [Homework](Homework.md)\n    - [1. Homework from appointments: `GET /rest/v1/studiewijzeritemafspraaktoekenningen`](Homework.md#1-homework-from-appointments-get-restv1studiewijzeritemafspraaktoekenningen)\n    - [2. Homework from days: `GET /rest/v1/studiewijzeritemdagtoekenningen`](Homework.md#2-homework-from-days-get-restv1studiewijzeritemdagtoekenningen)\n    - [3. Homework from weeks: `GET /rest/v1/studiewijzeritemweektoekenningen`](Homework.md#3-homework-from-weeks-get-restv1studiewijzeritemweektoekenningen)\u003cbr\u003e\u003cbr\u003e\n    - [1. Homework Made `PUT /rest/v1/swigemaakt/[id]`](Homework.md#1-homework-made-put-restv1swigemaaktid)\n    - [2. Homework Made `PUT /rest/v1/swigemaakt/cou`](Homework.md#2-homework-made-put-restv1swigemaaktcou)\n\n\n\n\u003c!-- /TOC --\u003e\n\n## Some miscellaneous stuff\n\u003cdetails\u003e\u003csummary\u003eClick to open miscellaneous stuff\u003c/summary\u003e\n\n\n - Endpoint for the API is returned when you fetch the access token\n - Always include the header \"Accept\" with the value of \"application/json\" so you won't get XML. (except if you want XML :-) ) (the authentication stuff always returns JSON)\u003cbr\u003e\u003cbr\u003e\n\n - you can do sample requests using curl, for example:\n\n```bash\ncurl http://example.com/user/blah?active=true\u0026limit=3 -d \"key=value\u0026otherkey=value\" -H \"AHeader: Value\"\n```\n\nwhich will be listed here as\n\n| Name     | Type   | Value |\n|----------|--------|-------|\n| id       | URL    | blah  |\n| active   | Query  | true  |\n| limit    | Query  | 3     |\n| key      | Body   | value |\n| otherkey | Body   | value |\n| AHeader  | Header | Value |\n\nWhen there is a value that is unique to you (like username, password, or token), it will have a value like `[username]`\n\nI don't recommend using curl in your programming language, except for PHP but even there it's a pain. There are much better libraries.\n\n\u003cdetails\u003e\u003csummary\u003eA list of libraries for your language \u003c/summary\u003e  \n\nJavaScript: [window.fetch](https://developers.google.com/web/updates/2015/03/introduction-to-fetch)\u003cbr\u003e\nNodeJS: [node-fetch](https://github.com/bitinn/node-fetch), [HTTP from stdlib](https://nodejs.org/api/http.html), [Request](https://github.com/request/request), [Axios](https://github.com/axios/axios)\u003cbr\u003e\nGo: [net/http](https://golang.org/pkg/net/http/)\u003cbr\u003e\nRuby: [Faraday](https://github.com/lostisland/faraday), [HTTParty](https://github.com/jnunemaker/httparty)\u003cbr\u003e\nPython: [requests](http://docs.python-requests.org/en/master/)\u003cbr\u003e\n\nPlease add more if you know more.\n\n\u003c/details\u003e\n\n\u003c/details\u003e\n\n## Fetching information\n\nbaseurl: returned when you fetch a token (`somtoday_api_url`), usually [lowercase snakecased schoolname]-api.somtoday.nl\n\nAll routes here are prefixed with that baseurl.\n\n### Current student(s): `GET /rest/v1/leerlingen`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nThis REST method might return multiple students (I cannot test), since it says /leerlingen (Dutch plural for student).\n\nI suppose it returns all students the current user has access to (so if a school administrator runs it, it will return all students on the school).\n\n#### Parameters\n\n| Name          | Type      | Value                 |\n|---------------|-----------|-----------------------|\n| Authorization | Header    | Bearer [access_token] |\n| additional    | Parameter | pasfoto               |\n\nThe additional parameter is an optional GET parameter.\n\n#### Returns\n\nDepending on the additional parameters, some of the items in the result may not be present. Assuming `pasfoto` is set:\n\n```json\n{\n  \"items\": [\n    {\n      \"$type\": \"leerling.RLeerling\",\n      \"links\": [\n        {\n          \"id\": 1234,\n          \"rel\": \"self\",\n          \"type\": \"leerling.RLeerling\",\n          \"href\": \"https://bonhoeffer-api.somtoday.nl/rest/v1/leerlingen/1234\"\n        }\n      ],\n      \"permissions\": [\n        {\n          \"full\": \"leerling.RLeerlingPrimer:READ:INSTANCE(1234)\",\n          \"type\": \"leerling.RLeerlingPrimer\",\n          \"operations\": [\"READ\"],\n          \"instances\": [\"INSTANCE(1234)\"]\n        }\n      ],\n      \"additionalObjects\": {\n        \"pasfoto\": {\n          \"$type\": \"leerling.RLeerlingpasfoto\",\n          \"links\": [\n            {\n              \"id\": 1234,\n              \"rel\": \"self\"\n            }\n          ],\n          \"permissions\": [],\n          \"additionalObjects\": {},\n          \"datauri\": \"\u003cbase64 image\u003e\"\n        }\n      },\n      \"leerlingnummer\": 450000,\n      \"roepnaam\": \"Eli\",\n      \"achternaam\": \"Saado\",\n      \"email\": \"450000@live.bc-enschede.nl\",\n      \"mobielNummer\": \"06-00000000\",\n      \"geboortedatum\": \"2000-00-00\",\n      \"geslacht\": \"Man\"\n    }\n  ]\n}\n```\n\n#### Example\n\n```bash\ntoken='\u003cREDACTED\u003e' school_url=https://bonhoeffer-api.somtoday.nl\ncurl \"$school_url/rest/v1/leerlingen\" -H \"Authorization: Bearer $token\" -H \"Accept: application/json\"\n```\n\n---\n\n### Student by ID: `GET /rest/v1/leerlingen/[id]`\n\n#### Parameters\n\n| Name          | Type   | Value                 |\n|---------------|--------|-----------------------|\n| id            | URL    | [user id]             |\n| Authorization | Header | Bearer [access_token] |\n\n#### Returns\n\n```json\n{\n  \"links\": [\n    {\n      \"id\": 1234,\n      \"rel\": \"self\",\n      \"type\": \"leerling.RLeerling\",\n      \"href\": \"https://bonhoeffer-api.somtoday.nl/rest/v1/leerlingen/1234\"\n    }\n  ],\n  \"permissions\": [\n    {\n      \"full\": \"leerling.RLeerlingPrimer:READ:INSTANCE(1234)\",\n      \"type\": \"leerling.RLeerlingPrimer\",\n      \"operations\": [\"READ\"],\n      \"instances\": [\"INSTANCE(1234)\"]\n    }\n  ],\n  \"additionalObjects\": {},\n  \"leerlingnummer\": 450000,\n  \"roepnaam\": \"Eli\",\n  \"achternaam\": \"Saado\",\n  \"email\": \"450000@live.bc-enschede.nl\",\n  \"mobielNummer\": \"06-00000000\",\n  \"geboortedatum\": \"2000-00-00\",\n  \"geslacht\": \"Man\"\n}\n```\n\n#### Example\n\n```bash\ntoken='\u003cREDACTED\u003e' school_url=https://bonhoeffer-api.somtoday.nl id=1234\ncurl \"$school_url/rest/v1/leerlingen/$id\" -H \"Authorization: Bearer $token\" -H \"Accept: application/json\"\n```\n\n\u003c/details\u003e\n\n### Grades: `GET /rest/v1/resultaten/huidigVoorLeerling/[id]`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches the grades of the student. Note that all average grades are also grade items returned by the API. There are the different types of columns: the `type` property in the json (e.g. 'Toetskolom', 'ToetssoortGemiddeldeKolom').\n\n#### Parameters\n\n| Name          | Type      | Value                           |\n|---------------|-----------|---------------------------------|\n| id            | URL       | [user id]                       |\n| Authorization | Header    | Bearer [access_token]           |\n| Range         | Header    | items=[LowerBound]-[UpperBound] |\n| additional    | Parameter | berekendRapportCijfer           |\n| additional    | Parameter | samengesteldeToetskolomId       |\n| additional    | Parameter | resultaatkolomId                |\n| additional    | Parameter | cijferkolomId                   |\n| additional    | Parameter | toetssoortnaam                  |\n| additional    | Parameter | huidigeAnderVakKolommen         |\n\nThese LowerBound and UpperBound values are the amount of grades you want to request (the API uses pagination here). The value may not exceed 100, so the way to request **all** grades is by doing the following:\n\n1. Request 0-99\n2. Request 100-199\n3. Request 200-299\n4. Request .00-.99\n5. Continue until the response contains less than 99 records\n6. Profit!\n\n#### Returns\n\n```js\n{\n\"items\": [\n    {\n        \"$type\": \"resultaten.RResultaat\",\n        \"links\": [\n            {\n                \"id\": 1234,\n                \"rel\": \"self\",\n                \"type\": \"resultaten.RResultaat\",\n                \"href\": \"https://api.somtoday.nl/rest/v1/resultaten/1234\"\n            }\n        ],\n        \"permissions\": [\n            {\n                \"full\": \"resultaten.RResultaat:READ:INSTANCE(\u003cREDACTED\u003e)\",\n                \"type\": \"resultaten.RResultaat\",\n                \"operations\": [\n                    \"READ\"\n                ],\n                \"instances\": [\n                    \"INSTANCE(\u003cREDACTED\u003e)\"\n                ]\n            }\n        ],\n        \"additionalObjects\": {},\n        \"herkansingstype\": \"Geen\",\n        \"resultaat\": \"7.9\",\n        \"geldendResultaat\": \"7.9\",\n        \"datumInvoer\": \"2019-09-10T13:41:11.805+02:00\",\n        \"teltNietmee\": false,\n        \"toetsNietGemaakt\": false,\n        \"leerjaar\": 0,\n        \"periode\": 0,\n        \"examenWeging\": 0,\n        \"isExamendossierResultaat\": true,\n        \"isVoortgangsdossierResultaat\": false,\n        \"type\": \"ToetssoortGemiddeldeKolom\",\n        \"vak\": {\n            \"links\": [\n                {\n                    \"id\": 1234,\n                    \"rel\": \"self\",\n                    \"type\": \"onderwijsinrichting.RVak\",\n                    \"href\": \"https://api.somtoday.nl/rest/v1/vakken/1234\"\n                }\n            ],\n            \"permissions\": [\n                {\n                    \"full\": \"onderwijsinrichting.RVak:READ:INSTANCE(\u003cREDACTED\u003e)\",\n                    \"type\": \"onderwijsinrichting.RVak\",\n                    \"operations\": [\n                        \"READ\"\n                    ],\n                    \"instances\": [\n                        \"INSTANCE(\u003cREDACTED\u003e)\"\n                    ]\n                }\n            ],\n            \"additionalObjects\": {},\n            \"afkorting\": \"ckv\",\n            \"naam\": \"culturele en kunstzinnige vorming\"\n        },\n        \"leerling\": {\n            \"links\": [\n                {\n                    \"id\": 1234,\n                    \"rel\": \"self\",\n                    \"type\": \"leerling.RLeerlingPrimer\",\n                    \"href\": \"https://api.somtoday.nl/rest/v1/leerlingen/1234\"\n                }\n            ],\n            \"permissions\": [\n                {\n                    \"full\": \"leerling.RLeerlingPrimer:READ:INSTANCE(\u003cREDACTED\u003e)\",\n                    \"type\": \"leerling.RLeerlingPrimer\",\n                    \"operations\": [\n                        \"READ\"\n                    ],\n                    \"instances\": [\n                        \"INSTANCE(\u003cREDACTED\u003e)\"\n                    ]\n                }\n            ],\n            \"additionalObjects\": {},\n            \"UUID\": \"070dabd4-3449-4af3-8c38-788faac283a3\",\n            \"leerlingnummer\": 1234,\n            \"roepnaam\": \"\u003cREDACTED\u003e\",\n            \"voorvoegsel\": \"\u003cREDACTED\u003e\",\n            \"achternaam\": \"\u003cREDACTED\u003e\"\n        }\n    },\n    ...\n}\n```\n\n\u003c/details\u003e\n\n### Schedule: `GET /rest/v1/afspraken`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetch the appointments from the schedule of the student.\n\n#### Parameters\n\n| Name          | Type      | Value                 |\n|---------------|-----------|-----------------------|\n| Authorization | Header    | Bearer [access_token] |\n| sort          | Parameter | asc-id                |\n| additional    | Parameter | vak                   |\n| additional    | Parameter | docentAfkortingen     |\n| additional    | Parameter | leerlingen            |\n| begindatum    | Parameter | yyyy-MM-dd            |\n| einddatum     | Parameter | yyyy-MM-dd            |\n\n#### Returns\n\n```json\n{\n  \"items\": [\n    {\n      \"$type\": \"participatie.RAfspraak\",\n      \"links\": [\n        {\n          \"id\": 8849104409,\n          \"rel\": \"self\",\n          \"type\": \"participatie.RAfspraak\",\n          \"href\": \"AFSPRAAK_URL\"\n        }\n      ],\n      \"permissions\": [\n        {\n          \"full\": \"participatie.RAfspraak:READ:INSTANCE(8849104409)\",\n          \"type\": \"participatie.RAfspraak\",\n          \"operations\": [\"READ\"],\n          \"instances\": [\"INSTANCE(8849104409)\"]\n        }\n      ],\n      \"additionalObjects\": {\n        \"vak\": {\n          \"$type\": \"onderwijsinrichting.RVak\",\n          \"links\": [\n            {\n              \"id\": 126211284,\n              \"rel\": \"self\",\n              \"type\": \"onderwijsinrichting.RVak\",\n              \"href\": \"VAK_URL\"\n            }\n          ],\n          \"permissions\": [\n            {\n              \"full\": \"onderwijsinrichting.RVak:READ:INSTANCE(126211284)\",\n              \"type\": \"onderwijsinrichting.RVak\",\n              \"operations\": [\"READ\"],\n              \"instances\": [\"INSTANCE(126211284)\"]\n            }\n          ],\n          \"additionalObjects\": {},\n          \"afkorting\": \"wisB\",\n          \"naam\": \"wiskunde B\"\n        },\n        \"docentAfkortingen\": \"Stk\",\n        \"leerlingen\": {\n          \"$type\": \"LinkableWrapper\",\n          \"items\": [\n            {\n              \"$type\": \"leerling.RLeerlingPrimer\",\n              \"links\": [\n                {\n                  \"id\": 546308480,\n                  \"rel\": \"self\",\n                  \"type\": \"leerling.RLeerlingPrimer\",\n                  \"href\": \"LEERLING_URL\"\n                }\n              ],\n              \"permissions\": [\n                {\n                  \"full\": \"leerling.RLeerlingPrimer:READ:INSTANCE(546308480)\",\n                  \"type\": \"leerling.RLeerlingPrimer\",\n                  \"operations\": [\"READ\"],\n                  \"instances\": [\"INSTANCE(546308480)\"]\n                }\n              ],\n              \"additionalObjects\": {},\n              \"UUID\": \"UUID\",\n              \"leerlingnummer\": 119371,\n              \"roepnaam\": \"Christos\",\n              \"achternaam\": \"Karapasias\"\n            }\n          ]\n        }\n      },\n      \"afspraakType\": {\n        \"links\": [\n          {\n            \"id\": 144662674,\n            \"rel\": \"self\",\n            \"type\": \"participatie.RAfspraakType\",\n            \"href\": \"AFSPRAAK_TYPE_URL\"\n          }\n        ],\n        \"permissions\": [\n          {\n            \"full\": \"participatie.RAfspraakType:READ:INSTANCE(144662674)\",\n            \"type\": \"participatie.RAfspraakType\",\n            \"operations\": [\"READ\"],\n            \"instances\": [\"INSTANCE(144662674)\"]\n          }\n        ],\n        \"additionalObjects\": {},\n        \"naam\": \"Les\",\n        \"omschrijving\": \"Les\",\n        \"standaardKleur\": -2394583,\n        \"categorie\": \"Rooster\",\n        \"activiteit\": \"Verplicht\",\n        \"percentageIIVO\": 0,\n        \"presentieRegistratieDefault\": true,\n        \"actief\": true,\n        \"vestiging\": {\n          \"$type\": \"instelling.RVestiging\",\n          \"links\": [\n            {\n              \"id\": 126208855,\n              \"rel\": \"self\",\n              \"type\": \"instelling.RVestiging\",\n              \"href\": \"VESTIGING_URL\"\n            }\n          ],\n          \"permissions\": [\n            {\n              \"full\": \"instelling.RVestiging:READ:INSTANCE(126208855)\",\n              \"type\": \"instelling.RVestiging\",\n              \"operations\": [\"READ\"],\n              \"instances\": [\"INSTANCE(126208855)\"]\n            }\n          ],\n          \"additionalObjects\": {},\n          \"naam\": \"Fortes Lyceum\"\n        }\n      },\n      \"locatie\": \"217\",\n      \"beginDatumTijd\": \"2020-05-04T11:15:00.000+02:00\",\n      \"eindDatumTijd\": \"2020-05-04T12:00:00.000+02:00\",\n      \"beginLesuur\": 4,\n      \"eindLesuur\": 4,\n      \"titel\": \"217 - A5wisB_2 - Stk\",\n      \"omschrijving\": \"217 - A5wisB_2 - Stk\",\n      \"presentieRegistratieVerplicht\": true,\n      \"presentieRegistratieVerwerkt\": false,\n      \"afspraakStatus\": \"ACTIEF\",\n      \"vestiging\": {\n        \"links\": [\n          {\n            \"id\": 126208855,\n            \"rel\": \"self\",\n            \"type\": \"instelling.RVestiging\",\n            \"href\": \"VESTIGING_URL\"\n          }\n        ],\n        \"permissions\": [\n          {\n            \"full\": \"instelling.RVestiging:READ:INSTANCE(126208855)\",\n            \"type\": \"instelling.RVestiging\",\n            \"operations\": [\"READ\"],\n            \"instances\": [\"INSTANCE(126208855)\"]\n          }\n        ],\n        \"additionalObjects\": {},\n        \"naam\": \"SCHOOL_NAAM\"\n      }\n    }\n  ]\n}\n```\n\n#### Example\n\n```bash\ncurl \"$school_url/rest/v1/afspraken?sort=asc-id\u0026additional=vak\u0026additional=docentAfkortingen\u0026additional=leerlingen\u0026begindatum=2020-05-01\u0026einddatum=2020-05-19\" -H \"Authorization: Bearer $token\" -H \"Accept: application/json\"\n```\n\n\u003c/details\u003e\n\n### Absence Reports: `GET /rest/v1/absentiemeldingen`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches the absence reports of the user\n\n#### Parameters\n\n| Name           | Type      | Value                 |\n|----------------|-----------|-----------------------|\n| Authorization  | Header    | Bearer [access_token] |\n| begindatumtijd | Parameter | yyyy-MM-dd            |\n| einddatumtijd  | Parameter | yyyy-MM-dd            |\n\n#### Returns\n\nArray of absance reports\n\n```json\n{\n  \"items\": [\n    {\n      \"$type\": \"participatie.RAbsentieMelding\",\n      \"links\": [\n        {\n          \"id\": 1234567890123,\n          \"rel\": \"self\",\n          \"type\": \"participatie.RAbsentieMelding\",\n          \"href\": \"{{api_url}}/rest/v1/waarnemingen/1234567890123\"\n        }\n      ],\n      \"permissions\": [],\n      \"additionalObjects\": {},\n      \"leerling\": {\n        \"links\": [\n          {\n            \"id\": 1234567890,\n            \"rel\": \"self\",\n            \"type\": \"leerling.RLeerlingPrimer\",\n            \"href\": \"{{api_url}}/rest/v1/leerlingen/1234567890\"\n          }\n        ],\n        \"permissions\": [],\n        \"additionalObjects\": {},\n        \"UUID\": \"12abc34e-12a3-1a2b-a1b2-1a2b34cd5e67\",\n        \"leerlingnummer\": 100000,\n        \"roepnaam\": \"Name\",\n        \"achternaam\": \"Name\"\n      },\n      \"absentieReden\": {\n        \"links\": [\n          {\n            \"id\": 1234567890,\n            \"rel\": \"self\",\n            \"type\": \"participatie.RAbsentieRedenPrimer\",\n            \"href\": \"{{api_url}}/rest/v1/absentieredenen/1234567890\"\n          }\n        ],\n        \"permissions\": [],\n        \"additionalObjects\": {},\n        \"absentieSoort\": \"Absent\",\n        \"afkorting\": \"XC\",\n        \"omschrijving\": \"Onbekend\",\n        \"geoorloofd\": false\n      },\n      \"datumTijdInvoer\": \"yyyy-MM-dd'T'HH:mm:ss.SSS+HH:mm\",\n      \"beginDatumTijd\": \"yyyy-MM-dd'T'HH:mm:ss.SSS+HH:mm\",\n      \"eindDatumTijd\": \"yyyy-MM-dd'T'HH:mm:ss.SSS+HH:mm\",\n      \"beginLesuur\": 3,\n      \"eindLesuur\": 3,\n      \"afgehandeld\": true,\n      \"eigenaar\": {\n        \"links\": [\n          {\n            \"id\": 1234567890,\n            \"rel\": \"self\",\n            \"type\": \"medewerker.RMedewerker\",\n            \"href\": \"{{api_url}}/rest/v1/medewerkers/1234567890\"\n          }\n        ],\n        \"permissions\": [],\n        \"additionalObjects\": {},\n        \"UUID\": \"12abc34e-12a3-1a2b-a1b2-1a2b34cd5e67\",\n        \"nummer\": 100000,\n        \"afkorting\": \"HH\",\n        \"achternaam\": \"Henk\",\n        \"geslacht\": \"MAN\",\n        \"voorletters\": \"H.H.\",\n        \"roepnaam\": \"Hans\"\n      }\n    }\n  ]\n}\n```\n\u003c/details\u003e\n\n### Study Guides: `GET /rest/v1/studiewijzers`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches the study guides for the user\n\n#### Parameters\n\n| Name          | Type      | Value                 |\n|---------------|-----------|-----------------------|\n| Authorization | Header    | Bearer [access_token] |\n| additional    | Parameter | leerlingen            |\n| additional    | Parameter | bijlagen              |\n| additional    | Parameter | externeMaterialen     |\n| additional    | Parameter | bijlageMappen         |\n\nThe additional parameters are optional GET parameters to include information in the result. `leerlingen` will only give back 1 result when queried by a student, but will fetch all students when queried by a teacher/school admin.\n\n#### Returns\n\nDepending on the additional parameters, some of the items in the result may not be present. Assuming all 4 are set:\n\n```json\n{\n    \"items\": [\n        {\n            \"$type\": \"studiewijzer.RStudiewijzer\",\n            \"links\": [\n                {\n                    \"id\": 3709468886305,\n                    \"rel\": \"self\",\n                    \"type\": \"studiewijzer.RStudiewijzer\",\n                    \"href\": \"https://api.somtoday.nl/rest/v1/studiewijzers/3709468886305\"\n                }\n            ],\n            \"permissions\": [\n                {\n                    \"full\": \"studiewijzer.RStudiewijzer:READ:INSTANCE(3709468886305)\",\n                    \"type\": \"studiewijzer.RStudiewijzer\",\n                    \"operations\": [\n                        \"READ\"\n                    ],\n                    \"instances\": [\n                        \"INSTANCE(3709468886305)\"\n                    ]\n                }\n            ],\n            \"additionalObjects\": {\n                \"bijlageMappen\": {\n                    \"$type\": \"LinkableWrapper\",\n                    \"items\": []\n                },\n                \"bijlagen\": {\n                    \"$type\": \"LinkableWrapper\",\n                    \"items\": []\n                },\n                \"leerlingen\": {\n                    \"$type\": \"LinkableWrapper\",\n                    \"items\": [\n                        {\n                            \"$type\": \"leerling.RLeerlingPrimer\",\n                            \"links\": [\n                                {\n                                    \"id\": 9496745174,\n                                    \"rel\": \"self\",\n                                    \"type\": \"leerling.RLeerlingPrimer\",\n                                    \"href\": \"https://api.somtoday.nl/rest/v1/leerlingen/9496745174\"\n                                }\n                            ],\n                            \"permissions\": [\n                                {\n                                    \"full\": \"leerling.RLeerlingPrimer:READ:INSTANCE(9496745174)\",\n                                    \"type\": \"leerling.RLeerlingPrimer\",\n                                    \"operations\": [\n                                        \"READ\"\n                                    ],\n                                    \"instances\": [\n                                        \"INSTANCE(9496745174)\"\n                                    ]\n                                }\n                            ],\n                            \"additionalObjects\": {},\n                            \"UUID\": \"f8cf6f6c-c213-4526-8ba1-6a306cf724a4\",\n                            \"leerlingnummer\": 123456,\n                            \"roepnaam\": \"{{first_name}}\",\n                            \"achternaam\": \"{{last_name}}\"\n                        }\n                    ]\n                },\n                \"externeMaterialen\": {\n                    \"$type\": \"LinkableWrapper\",\n                    \"items\": []\n                }\n            },\n            \"uuid\": \"4d2188a0-03d8-4dca-9f51-0e54d3c353c6\",\n            \"naam\": \"vwo5.schka\",\n            \"vestiging\": {\n                \"links\": [\n                    {\n                        \"id\": 9496567717,\n                        \"rel\": \"self\",\n                        \"type\": \"instelling.RVestiging\",\n                        \"href\": \"https://api.somtoday.nl/rest/v1/vestigingen/9496567717\"\n                    }\n                ],\n                \"permissions\": [\n                    {\n                        \"full\": \"instelling.RVestiging:READ:INSTANCE(9496567717)\",\n                        \"type\": \"instelling.RVestiging\",\n                        \"operations\": [\n                            \"READ\"\n                        ],\n                        \"instances\": [\n                            \"INSTANCE(9496567717)\"\n                        ]\n                    }\n                ],\n                \"additionalObjects\": {},\n                \"naam\": \"Stella Maris College Meerssen\"\n            },\n            \"lesgroep\": {\n                \"links\": [\n                    {\n                        \"id\": 3543707887108,\n                        \"rel\": \"self\",\n                        \"type\": \"lesgroep.RLesgroep\",\n                        \"href\": \"https://api.somtoday.nl/rest/v1/lesgroepen/3543707887108\"\n                    }\n                ],\n                \"permissions\": [\n                    {\n                        \"full\": \"lesgroep.RLesgroep:READ:INSTANCE(3543707887108)\",\n                        \"type\": \"lesgroep.RLesgroep\",\n                        \"operations\": [\n                            \"READ\"\n                        ],\n                        \"instances\": [\n                            \"INSTANCE(3543707887108)\"\n                        ]\n                    }\n                ],\n                \"additionalObjects\": {},\n                \"UUID\": \"d4afb5b8-fbf6-4bbd-ac73-cb50cc883392\",\n                \"naam\": \"vwo5.schka\",\n                \"schooljaar\": {\n                    \"$type\": \"onderwijsinrichting.RSchooljaar\",\n                    \"links\": [\n                        {\n                            \"id\": 40851957,\n                            \"rel\": \"self\",\n                            \"type\": \"onderwijsinrichting.RSchooljaar\",\n                            \"href\": \"https://api.somtoday.nl/rest/v1/schooljaren/40851957\"\n                        }\n                    ],\n                    \"permissions\": [\n                        {\n                            \"full\": \"onderwijsinrichting.RSchooljaar:READ:INSTANCE(40851957)\",\n                            \"type\": \"onderwijsinrichting.RSchooljaar\",\n                            \"operations\": [\n                                \"READ\"\n                            ],\n                            \"instances\": [\n                                \"INSTANCE(40851957)\"\n                            ]\n                        }\n                    ],\n                    \"additionalObjects\": {},\n                    \"naam\": \"2021/2022\",\n                    \"vanafDatum\": \"2021-08-01\",\n                    \"totDatum\": \"2022-07-31\",\n                    \"isHuidig\": true\n                },\n                \"vak\": {\n                    \"links\": [\n                        {\n                            \"id\": 9505018979,\n                            \"rel\": \"self\",\n                            \"type\": \"onderwijsinrichting.RVak\",\n                            \"href\": \"https://api.somtoday.nl/rest/v1/vakken/9505018979\"\n                        }\n                    ],\n                    \"permissions\": [\n                        {\n                            \"full\": \"onderwijsinrichting.RVak:READ:INSTANCE(9505018979)\",\n                            \"type\": \"onderwijsinrichting.RVak\",\n                            \"operations\": [\n                                \"READ\"\n                            ],\n                            \"instances\": [\n                                \"INSTANCE(9505018979)\"\n                            ]\n                        }\n                    ],\n                    \"additionalObjects\": {},\n                    \"afkorting\": \"schk\",\n                    \"naam\": \"Scheikunde\"\n                },\n                \"heeftStamgroep\": false,\n                \"examendossierOndersteund\": true,\n                \"vestiging\": {\n                    \"links\": [\n                        {\n                            \"id\": 9496567717,\n                            \"rel\": \"self\",\n                            \"type\": \"instelling.RVestiging\",\n                            \"href\": \"https://api.somtoday.nl/rest/v1/vestigingen/9496567717\"\n                        }\n                    ],\n                    \"permissions\": [\n                        {\n                            \"full\": \"instelling.RVestiging:READ:INSTANCE(9496567717)\",\n                            \"type\": \"instelling.RVestiging\",\n                            \"operations\": [\n                                \"READ\"\n                            ],\n                            \"instances\": [\n                                \"INSTANCE(9496567717)\"\n                            ]\n                        }\n                    ],\n                    \"additionalObjects\": {},\n                    \"naam\": \"Stella Maris College Meerssen\"\n                }\n            }\n        }\n        ...\n    ]\n}\n```\n\n\u003c/details\u003e\n\n### Subjects: `GET /rest/v1/vakken`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches the subjects for the user\n\n#### Parameters\n\n| Name          | Type   | Value                 |\n|---------------|--------|-----------------------|\n| Authorization | Header | Bearer [access_token] |\n\n#### Returns\n\n```json\n{\n  \"items\": [\n    {\n      \"$type\": \"onderwijsinrichting.RVak\",\n      \"links\": [\n        {\n          \"id\": 123456789,\n          \"rel\": \"self\",\n          \"type\": \"onderwijsinrichting.RVak\",\n          \"href\": \"https://api.somtoday.nl/rest/v1/vakken/123456789\"\n        }\n      ],\n      \"permissions\": [\n        {\n          \"full\": \"onderwijsinrichting.RVak:READ:INSTANCE(123456789)\",\n          \"type\": \"onderwijsinrichting.RVak\",\n          \"operations\": [\n            \"READ\"\n          ],\n          \"instances\": [\n            \"INSTANCE(123456789)\"\n          ]\n        }\n      ],\n      \"additionalObjects\": {},\n      \"afkorting\": \"\u003cabbreviation\u003e\",\n      \"naam\": \"\u003csubject\u003e\"\n    }\n\t...\n  ]\n}\n```\n\n\u003c/details\u003e\n\n### Account: `GET /rest/v1/account/` / `GET /rest/v1/account/[id]` / `GET /rest/v1/account/me`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches information about the account that is connected with the Somtoday access token\n\n#### Parameters\n\n| Name          | Type      | Value                 |\n|---------------|-----------|-----------------------|\n| id            | URL       | [user-id]             |\n| Authorization | Header    | Bearer [access_token] |\n| additional    | Parameter | restricties           |\n\n\n#### Returns\n\n\n\n```json\n{\n  \"items\": [\n    {\n      \"$type\": \"auth.RAccount\",\n      \"links\": [\n        {\n          \"id\": 1234567890,\n          \"rel\": \"self\",\n          \"type\": \"auth.RAccount\",\n          \"href\": \"https://api.somtoday.nl/rest/v1/account/1234567890\"\n        }\n      ],\n      \"permissions\": [\n        {\n          \"full\": \"auth.RAccount:READ:INSTANCE(1234567890)\",\n          \"type\": \"auth.RAccount\",\n          \"operations\": [\n            \"READ\"\n          ],\n          \"instances\": [\n            \"INSTANCE(1234567890)\"\n          ]\n        }\n      ],\n      \"additionalObjects\": {\n        \"restricties\": {\n          \"$type\": \"LinkableWrapper\",\n          \"items\": [\n            {\n              \"$type\": \"restricties.REloRestricties\",\n              \"links\": [],\n              \"permissions\": [],\n              \"additionalObjects\": {},\n              \"vestigingsId\": REDACTED,\n              \"leerlingId\": REDACTED,\n              \"mobieleAppAan\": true,\n              \"studiewijzerAan\": true,\n              \"berichtenVerzendenAan\": false,\n              \"leermiddelenAan\": true,\n              \"adviezenTokenAan\": true,\n              \"opmerkingRapportCijferTonenAan\": true,\n              \"periodeGemiddeldeTonenResultaatAan\": true,\n              \"rapportGemiddeldeTonenResultaatAan\": true,\n              \"rapportCijferTonenResultaatAan\": true,\n              \"toetssoortgemiddeldenAan\": true,\n              \"seResultaatAan\": true,\n              \"stamgroepLeerjaarAan\": true,\n              \"emailWijzigenAan\": false,\n              \"mobielWijzigenAan\": false,\n              \"wachtwoordWijzigenAan\": true,\n              \"absentiesBekijkenAan\": true,\n              \"absentieConstateringBekijkenAan\": true,\n              \"absentieMaatregelBekijkenAan\": true,\n              \"absentieMeldingBekijkenAan\": true,\n              \"berichtenBekijkenAan\": true,\n              \"cijfersBekijkenAan\": true,\n              \"huiswerkBekijkenAan\": true,\n              \"nieuwsBekijkenAan\": true,\n              \"pasfotoLeerlingTonenAan\": true,\n              \"pasfotoMedewerkerTonenAan\": false,\n              \"profielBekijkenAan\": true,\n              \"roosterBekijkenAan\": true,\n              \"roosterBeschikbaarIcalAan\": true,\n              \"vakkenBekijkenAan\": true,\n              \"lesurenVerbergenSettingAan\": false\n            }\n          ]\n        }\n      },\n      \"gebruikersnaam\": \"[REDACTED]\",\n      \"accountPermissions\": [],\n      \"persoon\": {\n        \"$type\": \"leerling.RLeerlingPrimer\",\n        \"links\": [\n          {\n            \"id\": \"0123456789\",\n            \"rel\": \"self\",\n            \"type\": \"leerling.RLeerlingPrimer\",\n            \"href\": \"https://api.somtoday.nl/rest/v1/leerlingen/0123456789\"\n          }\n        ],\n        \"permissions\": [\n          {\n            \"full\": \"leerling.RLeerlingPrimer:READ:INSTANCE(1409824200)\",\n            \"type\": \"leerling.RLeerlingPrimer\",\n            \"operations\": [\n              \"READ\"\n            ],\n            \"instances\": [\n              \"INSTANCE(0123456789)\"\n            ]\n          }\n        ],\n        \"additionalObjects\": {},\n        \"UUID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n        \"leerlingnummer\": 100000,\n        \"roepnaam\": \"Name\",\n        \"voorvoegsel\": \"Name\",\n        \"achternaam\": \"Name\"\n      }\n    }\n  ]\n}\n```\n\n\u003c/details\u003e\n\n### Schooljaren: `GET /rest/v1/schooljaren` / `GET /rest/v1/schooljaren/[id]`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches information about a school year\n\n#### Parameters\n\n| Name          | Type   | Value                 |\n|---------------|--------|-----------------------|\n| id            | URL    | [id]                  |\n| id            | URL    | huidig                |\n| Authorization | Header | Bearer [access_token] |\n\nWhen you want info about the current school year add /huidig to the url\n\n#### Returns\n\n```json\n{\n  \"items\": [\n    {\n      \"$type\": \"onderwijsinrichting.RSchooljaar\",\n      \"links\": [\n        {\n          \"id\": 40851958, //this id is for everyone the same (in this case for year 2022/2023)\n          \"rel\": \"self\",\n          \"type\": \"onderwijsinrichting.RSchooljaar\",\n          \"href\": \"https://api.somtoday.nl/rest/v1/schooljaren/40851958\"\n        }\n      ],\n      \"permissions\": [\n        {\n          \"full\": \"onderwijsinrichting.RSchooljaar:READ:INSTANCE(40851958)\",\n          \"type\": \"onderwijsinrichting.RSchooljaar\",\n          \"operations\": [\n            \"READ\"\n          ],\n          \"instances\": [\n            \"INSTANCE(40851958)\"\n          ]\n        }\n      ],\n      \"additionalObjects\": {},\n      \"naam\": \"2022/2023\",\n      \"vanafDatum\": \"2022-08-01\",\n      \"totDatum\": \"2023-07-31\",\n      \"isHuidig\": true\n    },\n    ...\n  ]\n}\n```\n\n\u003c/details\u003e\n\n### Vakkeuzes: `GET /rest/v1/vakkeuzes`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches all the subjects you are currently enrolled in.\n\n#### Parameters\n\n| Name          | Type      | Value                 |\n|---------------|-----------|-----------------------|\n| Authorization | Header    | Bearer [access_token] |\n| additional    | Parameter | vaknormering          |\n| additional    | Parameter | actiefOpPeildatum     |\n\n#### Returns\n\n```json\n{\n  \"items\": [\n    {\n      \"$type\": \"onderwijsinrichting.RVakkeuze\",\n      \"links\": [\n        {\n          \"id\": xxxxxxxxxx,\n          \"rel\": \"self\",\n          \"type\": \"onderwijsinrichting.RVakkeuze\",\n          \"href\": \"https://api.somtoday.nl/rest/v1/vakkeuzes/xxxxxxxxxx\"\n        }\n      ],\n      \"permissions\": [\n        {\n          \"full\": \"onderwijsinrichting.RVakkeuze:READ:INSTANCE(xxxxxxxxxx)\",\n          \"type\": \"onderwijsinrichting.RVakkeuze\",\n          \"operations\": [\n            \"READ\"\n          ],\n          \"instances\": [\n            \"INSTANCE(xxxxxxxxxx)\"\n          ]\n        }\n      ],\n      \"additionalObjects\": {\n        \"vaknormering\": {\n          \"$type\": \"onderwijsinrichting.RVakNormering\",\n          \"vakId\": yyyyyyyyyy,\n          \"toetsnormering1\": \"Standaard\",\n          \"toetsnormering2\": \"Alternatief\"\n        }\n      },\n      \"vak\": {\n        \"links\": [\n          {\n            \"id\": yyyyyyyyyy,\n            \"rel\": \"self\",\n            \"type\": \"onderwijsinrichting.RVak\",\n            \"href\": \"https://api.somtoday.nl/rest/v1/vakken/yyyyyyyyyy\"\n          }\n        ],\n        \"permissions\": [\n          {\n            \"full\": \"onderwijsinrichting.RVak:READ:INSTANCE(yyyyyyyyyy)\",\n            \"type\": \"onderwijsinrichting.RVak\",\n            \"operations\": [\n              \"READ\"\n            ],\n            \"instances\": [\n              \"INSTANCE(yyyyyyyyyy)\"\n            ]\n          }\n        ],\n        \"additionalObjects\": {},\n        \"afkorting\": \"ne\",\n        \"naam\": \"Nederlandse taal\"\n      }\n    },\n    ...\n  ]\n}\n```\n\n\u003c/details\u003e\n\n### Waarnemingen: `GET /rest/v1/waarnemingen`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches all the waarnemingen currently tied to your account, filter them by date, isGeoorloofd and/or waarnemingSoort.\n\n#### Parameters\n\n| Name                       | Type      | Value                 |\n|----------------------------|-----------|-----------------------|\n| Authorization              | Header    | Bearer [access_token] |\n| waarnemingSoort (optional) | Parameter | Afwezig/aanwezig      |\n| isGeoorloofd (optional)    | Parameter | true/false            |\n\nYou can, if you want, provide dates to filter the results. If you don't provide any dates, it will return all the results. \nYou can either provide a date range or a single date. If you provide a single date, it will return all the results from that date. If you provide a date range, it will return all the results inbetween those dates.\n\n| Date types      | Type      | Value       |\n|-----------------|-----------|-------------|\n| begintNaOfOp    | Parameter | yyyy-MM-dd  |\n| OR              |\n| beginDatumTijd  | Parameter | yyyy-MM-dd  |\n| eindDatumTijd   | Parameter | yyyy-MM-dd  |\n\n#### Returns\n\n```json\n{\n  \"items\": [\n    {\n      \"$type\": \"participatie.RWaarneming\",\n      \"links\": [\n        {\n          \"id\": 1234567891234,\n          \"rel\": \"self\",\n          \"type\": \"participatie.RWaarneming\",\n          \"href\": \"https://api.somtoday.nl/rest/v1/waarnemingen/1234567891234\"\n        }\n      ],\n      \"permissions\": [\n        {\n          \"full\": \"participatie.RWaarneming:READ:INSTANCE(1234567891234)\",\n          \"type\": \"participatie.RWaarneming\",\n          \"operations\": [\n            \"READ\"\n          ],\n          \"instances\": [\n            \"INSTANCE(1234567891234)\"\n          ]\n        }\n      ],\n      \"additionalObjects\": {},\n      \"beginDatumTijd\": \"2023-01-09T11:05:00.000+01:00\",\n      \"eindDatumTijd\": \"2023-01-09T11:55:00.000+01:00\",\n      \"beginLesuur\": 4,\n      \"eindLesuur\": 4,\n      \"waarnemingSoort\": \"Aanwezig\",\n      \"leerling\": {\n        \"links\": [\n          {\n            \"id\": 1234567890,\n            \"rel\": \"self\",\n            \"type\": \"leerling.RLeerlingPrimer\",\n            \"href\": \"https://api.somtoday.nl/rest/v1/leerlingen/1234567890\"\n          }\n        ],\n        \"permissions\": [\n          {\n            \"full\": \"leerling.RLeerlingPrimer:READ:INSTANCE(1234567890)\",\n            \"type\": \"leerling.RLeerlingPrimer\",\n            \"operations\": [\n              \"READ\"\n            ],\n            \"instances\": [\n              \"INSTANCE(1234567890)\"\n            ]\n          }\n        ],\n        \"additionalObjects\": {},\n        \"UUID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n        \"leerlingnummer\": 100000,\n        \"roepnaam\": \"Name\",\n        \"voorvoegsel\": \"Name\",\n        \"achternaam\": \"Name\"\n      },\n      \"afspraak\": {\n        \"links\": [\n          {\n            \"id\": 12345678901345,\n            \"rel\": \"self\",\n            \"type\": \"participatie.RAfspraakPrimer\",\n            \"href\": \"https://api.somtoday.nl/rest/v1/afspraken/12345678901345\"\n          }\n        ],\n        \"permissions\": [\n          {\n            \"full\": \"participatie.RAfspraak:READ:INSTANCE(12345678901345)\",\n            \"type\": \"participatie.RAfspraak\",\n            \"operations\": [\n              \"READ\"\n            ],\n            \"instances\": [\n              \"INSTANCE(12345678901345)\"\n            ]\n          }\n        ],\n        \"additionalObjects\": {},\n        \"afspraakType\": {\n          \"links\": [\n            {\n              \"id\": 1234567890,\n              \"rel\": \"self\",\n              \"type\": \"participatie.RAfspraakType\",\n              \"href\": \"https://api.somtoday.nl/rest/v1/afspraaktype/1234567890\"\n            }\n          ],\n          \"permissions\": [\n            {\n              \"full\": \"participatie.RAfspraakType:READ:INSTANCE(1234567890)\",\n              \"type\": \"participatie.RAfspraakType\",\n              \"operations\": [\n                \"READ\"\n              ],\n              \"instances\": [\n                \"INSTANCE(1234567890)\"\n              ]\n            }\n          ],\n          \"additionalObjects\": {},\n          \"naam\": \"LES\",\n          \"omschrijving\": \"LES\",\n          \"standaardKleur\": -16448251,\n          \"categorie\": \"Rooster\",\n          \"activiteit\": \"Verplicht\",\n          \"percentageIIVO\": 100,\n          \"presentieRegistratieDefault\": true,\n          \"actief\": true,\n          \"vestiging\": {\n            \"$type\": \"instelling.RVestiging\",\n            \"links\": [\n              {\n                \"id\": 1234567890,\n                \"rel\": \"self\",\n                \"type\": \"instelling.RVestiging\",\n                \"href\": \"https://api.somtoday.nl/rest/v1/vestigingen/1234567890\"\n              }\n            ],\n            \"permissions\": [\n              {\n                \"full\": \"instelling.RVestiging:READ:INSTANCE(1234567890)\",\n                \"type\": \"instelling.RVestiging\",\n                \"operations\": [\n                  \"READ\"\n                ],\n                \"instances\": [\n                  \"INSTANCE(1234567890)\"\n                ]\n              }\n            ],\n            \"additionalObjects\": {},\n            \"naam\": \"De super coole school\",\n          }\n        },\n        \"locatie\": \"lokaal naam\",\n        \"beginDatumTijd\": \"2023-01-09T11:05:00.000+01:00\",\n        \"eindDatumTijd\": \"2023-01-09T11:55:00.000+01:00\",\n        \"beginLesuur\": 4,\n        \"eindLesuur\": 4,\n        \"titel\": \"titel\"\n      },\n      \"afgehandeld\": true,\n      \"invoerDatum\": \"2023-01-09T11:09:08.000+01:00\",\n      \"laatstGewijzigdDatum\": \"2023-01-09T11:09:08.000+01:00\",\n      \"herkomst\": \"Medewerker\",\n      \"ingevoerdDoor\": {\n        \"links\": [\n          {\n            \"id\": 1234567890123,\n            \"rel\": \"self\",\n            \"type\": \"medewerker.RMedewerkerPrimer\",\n            \"href\": \"https://api.somtoday.nl/rest/v1/medewerkers/1234567890123\"\n          }\n        ],\n        \"permissions\": [],\n        \"additionalObjects\": {},\n        \"UUID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n        \"nummer\": 12345678,\n        \"afkorting\": \"afkorting\",\n        \"achternaam\": \"name\",\n        \"geslacht\": \"VROUW/MAN\",\n        \"voorletters\": \"voorletter(s)\",\n        \"roepnaam\": \"roepnaam\"\n      },\n      \"laatstGewijzigdDoor\": {\n        \"links\": [\n          {\n            \"id\": 1234567890123,\n            \"rel\": \"self\",\n            \"type\": \"medewerker.RMedewerkerPrimer\",\n            \"href\": \"https://api.somtoday.nl/rest/v1/medewerkers/1234567890123\"\n          }\n        ],\n        \"permissions\": [],\n        \"additionalObjects\": {},\n        \"UUID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n        \"nummer\": 12345678,\n        \"afkorting\": \"afkorting\",\n        \"achternaam\": \"name\",\n        \"geslacht\": \"VROUW/MAN\",\n        \"voorletters\": \"voorletter(s)\",\n        \"roepnaam\": \"roepnaam\"\n      }\n    },\n    ...\n  ]\n}\n```\n\u003c/details\u003e\n\n### Messages: `GET /rest/v1/boodschappen/conversaties`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\nFetches your SomToday messages/berichten.\n\n#### Parameters\n\n| Name          | Type      | Value                  |\n|---------------|-----------|------------------------|\n| Authorization | Header    | Bearer [access_token]  |\n| additional    | Parameter | verzondenDoorGebruiker |\n| additional    | Parameter | verzenderCorrespondent |\n| additional    | Parameter | aantalExtraOntvangers  |\n| additional    | Parameter | actiefVoorGebruiker    |\n| alle          | Parameter | true/false             |\n\n#### Returns\n```json\n{\n    \"items\":[\n        {\n            \"$type\":\"berichten.RBoodschapConversatie\",\n            \"boodschappen\":[\n                {\n                    \"links\":[\n                        {\n                            \"id\":1234567890,\n                            \"rel\":\"koppeling\",\n                            \"type\":\"berichten.RBoodschap\"\n                        }\n                    ],\n            \"permissions\":[],\n            \"additionalObjects\":{\n                \"aantalExtraOntvangers\":0,\n                \"verzondenDoorGebruiker\":false,\n                \"ontvangerCorrespondenten\":{\n                    \"$type\":\"NonLinkableWrapper\",\n                    \"items\":[\n                        {\n                            \"$type\":\"berichten.RBoodschapCorrespondent\",\n                            \"naam\":\"REDACTED\",\n                            \"vakken\":[]\n                        },\n                            {\n                                \"$type\":\"berichten.RBoodschapCorrespondent\",\n                                \"naam\":\"REDACTED\",\n                                \"vakken\":[]\n                                }\n                    ]             \n                },\n                    \"verzenderCorrespondent\":{\n                        \"$type\":\"berichten.RBoodschapCorrespondent\",\n                        \"naam\":\"REDACTED\",\n                        \"sorteerNaam\":\"REDACTED\",\n                        \"initialen\":\"REDACTED\",\n                        \"vakken\":[\n                            {\n                                \"links\":[\n                                    {\n                                        \"id\":1234567890,\n                                        \"rel\":\"self\",\n                                        \"type\":\"onderwijsinrichting.RVak\",\n                                        \"href\":\"https://api.somtoday.nl/rest/v1/vakken/1234567890\"\n                                        }\n                                    ],\n                                    \"permissions\":[\n                                        {\n                                            \"full\":\"onderwijsinrichting.RVak:READ,UPDATE,DELETE:INSTANCE(1234567890)\",\n                                            \"type\":\"onderwijsinrichting.RVak\",\n                                            \"operations\":[\"READ\",\"UPDATE\",\"DELETE\"],\n                                            \"instances\":[\"INSTANCE(1234567890)\"]\n                                        }\n                                    ],\n                                    \"additionalObjects\":{},\n                                    \"afkorting\":\"schk\",\n                                    \"naam\":\"scheikunde\",\n                                    \"UUID\":\"UUID\"\n                            }\n                        ]\n                    },\n                    \"actiefVoorGebruiker\":true,\n                    \"isOuderavondUitnodiging\":false\n            },\n            \"startPublicatie\":\"tijd\",\n            \"verzendDatum\":\"tijd\",\n            \"wijzigingsDatum\":\"tijd\",\n            \"draft\":false,\n            \"onderwerp\":\"REDACTED\",\n            \"inhoud\":\"REDACTED\",\n            \"prioriteit\":\"NORMAAL\",\n            \"notificatieType\":\"Bericht\",\n            \"bijlages\":[\n                {\n                    \"links\":[\n                        {\n                            \"id\":1234567890,\n                            \"rel\":\"koppeling\",\n                            \"type\":\"berichten.RBoodschapBijlage\"\n                        }\n                    ],\n                    \"permissions\":[],\n                    \"additionalObjects\":{},\n                    \"assemblyResults\":[\n                        {\n                            \"links\":[\n                                {\n                                    \"id\":1234567890,\n                                    \"rel\":\"koppeling\",\n                                    \"type\":\"cloudfiles.bestanden.RAssemblyResult\"\n                                }\n                            ],\n                            \"permissions\":[],\n                            \"additionalObjects\":{},\n                            \"assemblyFileType\":\"MISC\",\n                            \"fileExtension\":\"xlsx\",\n                            \"mimeType\":\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n                            \"fileSize\":11039,\n                            \"fileType\":\"office\",\n                            \"fileUrl\":\"REDACTED.xlsx\",\n                            \"sslUrl\":\"REDACTED.xlsx\",\n                            \"fileName\":\"REDACTED.xlsx\"\n                        }\n                    ],\n                    \"sortering\":0\n                }\n            ]\n                }\n            ]\n        },\n        ...\n    ]\n}\n```\n\u003c/details\u003e\n\n### Schoolgegevens: `GET /rest/v1/leerlingen/[id]/schoolgegevens` \n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches info about the school, including your mentor.\n\n#### Parameters\n\n| Name          | Type   | Value                 |\n|---------------|--------|-----------------------|\n| id            | URL    | [user id]             |\n| Authorization | Header | Bearer [access_token] |\n\n#### Returns\n\n```json\n{\n    \"$type\": \"leerling.RLeerlingSchoolgegevens\",\n    \"instellingsnaam\": \"REDACTED\",\n    \"vestigingsnaam\": \"REDACTED\",\n    \"plaats\": \"REDACTED\",\n    \"straat\": \"REDACTED\",\n    \"postcode\": \"REDACTED\",\n    \"telefoonnummer\": \"REDACTED\",\n    \"email\": \"REDACTED\",\n    \"leerjaar\": 99,\n    \"mentoren\": [\n        \"REDACTED\"\n    ]\n}\n```\n\n\u003c/details\u003e\n\n### Vakanties: `GET /rest/v1/vakanties/leerling/[id]`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches info about the school, including your mentor.\n\n#### Parameters\n\n| Name          | Type   | Value                 |\n|---------------|--------|-----------------------|\n| id            | URL    | [user id]             |\n| Authorization | Header | Bearer [access_token] |\n\n#### Returns\n\n```json\n{\n    \"items\": [\n        {\n            \"$type\": \"participatie.RVakantie\",\n            \"links\": [\n                {\n                    \"id\": 123456789,\n                    \"rel\": \"self\",\n                    \"type\": \"participatie.RVakantie\",\n                    \"href\": \"https://api.somtoday.nl/rest/v1/vakanties/123456789\"\n                }\n            ],\n            \"permissions\": [\n                {\n                    \"full\": \"participatie.RVakantie:READ:INSTANCE(123456789)\",\n                    \"type\": \"participatie.RVakantie\",\n                    \"operations\": [\n                        \"READ\"\n                    ],\n                    \"instances\": [\n                        \"INSTANCE(123456789)\"\n                    ]\n                }\n            ],\n            \"additionalObjects\": {},\n            \"naam\": \"Herfstvakantie\",\n            \"beginDatum\": \"2023-10-16T00:00:00.000+02:00\",\n            \"eindDatum\": \"2023-10-20T00:00:00.000+02:00\"\n        },\n        ...\n    ]\n}\n```\n\n\u003c/details\u003e\n\n### Studiemateriaal: `GET /rest/v1/vakken/studiemateriaal/[id]` \u0026 `GET rest/v1/vakken/studiemateriaal/[id]/vak/[uuid]` \u0026 `/rest/v1/studiemateriaal/algemeen/[id]`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches all studiemateriaal. (I.E. Annual supplements, online textbooks, etc.)\n\nFirst, make a request to `GET /rest/v1/vakken/studiemateriaal/[id]`. And then to `/rest/v1/vakken/studiemateriaal/[id]/vak/[uuid]` with the UUID of subject which studiemateriaal you want to fetch. \n\n#### Parameters\n\n| Name          | Type   | Value                 |\n|---------------|--------|-----------------------|\n| id            | URL    | [user id]             |\n| Authorization | Header | Bearer [access_token] |\n\n#### Returns\n\n`GET /rest/v1/vakken/studiemateriaal/[id]` returns:\n\n```json\n{\n    \"items\": [\n        {\n            \"$type\": \"onderwijsinrichting.RVak\",\n            \"links\": [\n                {\n                    \"id\": 123456789,\n                    \"rel\": \"self\",\n                    \"type\": \"onderwijsinrichting.RVak\",\n                    \"href\": \"https://api.somtoday.nl/rest/v1/vakken/123456789\"\n                }\n            ],\n            \"permissions\": [\n                {\n                    \"full\": \"onderwijsinrichting.RVak:READ:INSTANCE(123456789)\",\n                    \"type\": \"onderwijsinrichting.RVak\",\n                    \"operations\": [\n                        \"READ\"\n                    ],\n                    \"instances\": [\n                        \"INSTANCE(123456789)\"\n                    ]\n                }\n            ],\n            \"additionalObjects\": {},\n            \"afkorting\": \"ne\",\n            \"naam\": \"Nederlandse taal\",\n            \"UUID\": \"REDACTED\"\n        },\n        ...\n    ]\n}\n```\n`GET /rest/v1/vakken/studiemateriaal/[id]/vak/[uuid]` returns:\n\n```json\n{\n    \"$type\": \"studiewijzer.RStudieMateriaal\",\n    \"studiewijzer\": {\n        \"links\": [\n            {\n                \"id\": 123456789,\n                \"rel\": \"self\",\n                \"type\": \"studiewijzer.RStudiewijzer\",\n                \"href\": \"https://api.somtoday.nl/rest/v1/studiewijzers/123456789\"\n            }\n        ],\n        \"permissions\": [\n            {\n                \"full\": \"studiewijzer.RStudiewijzer:READ:INSTANCE(123456789)\",\n                \"type\": \"studiewijzer.RStudiewijzer\",\n                \"operations\": [\n                    \"READ\"\n                ],\n                \"instances\": [\n                    \"INSTANCE(123456789)\"\n                ]\n            }\n        ],\n        \"additionalObjects\": {},\n        \"uuid\": \"Redacted\",\n        \"naam\": \"Nederland\",\n        \"vestiging\": {\n            \"links\": [\n                {\n                    \"id\": 123456789,\n                    \"rel\": \"self\",\n                    \"type\": \"instelling.RVestiging\",\n                    \"href\": \"https://api.somtoday.nl/rest/v1/vestigingen/123456789\"\n                }\n            ],\n            \"permissions\": [\n                {\n                    \"full\": \"instelling.RVestiging:READ:INSTANCE(123456789)\",\n                    \"type\": \"instelling.RVestiging\",\n                    \"operations\": [\n                        \"READ\"\n                    ],\n                    \"instances\": [\n                        \"INSTANCE(123456789)\"\n                    ]\n                }\n            ],\n            \"additionalObjects\": {},\n            \"naam\": \"REDACTED\",\n            \"uuid\": \"REDACTED\"\n        },\n        \"lesgroep\": {\n            \"links\": [\n                {\n                    \"id\": 123456789,\n                    \"rel\": \"self\",\n                    \"type\": \"lesgroep.RLesgroep\",\n                    \"href\": \"https://api.somtoday.nl/rest/v1/lesgroepen/123456789\"\n                }\n            ],\n            \"permissions\": [\n                {\n                    \"full\": \"lesgroep.RLesgroep:READ:INSTANCE(123456789)\",\n                    \"type\": \"lesgroep.RLesgroep\",\n                    \"operations\": [\n                        \"READ\"\n                    ],\n                    \"instances\": [\n                        \"INSTANCE(123456789)\"\n                    ]\n                }\n            ],\n            \"additionalObjects\": {},\n            \"UUID\": \"REDACTED\",\n            \"naam\": \"REDACTED\",\n            \"omschrijving\": \"REDACTED\",\n            \"schooljaar\": {\n                \"$type\": \"onderwijsinrichting.RSchooljaar\",\n                \"links\": [\n                    {\n                        \"id\": 12345689,\n                        \"rel\": \"self\",\n                        \"type\": \"onderwijsinrichting.RSchooljaar\",\n                        \"href\": \"https://api.somtoday.nl/rest/v1/schooljaren/12345689\"\n                    }\n                ],\n                \"permissions\": [\n                    {\n                        \"full\": \"onderwijsinrichting.RSchooljaar:READ:INSTANCE(12345689)\",\n                        \"type\": \"onderwijsinrichting.RSchooljaar\",\n                        \"operations\": [\n                            \"READ\"\n                        ],\n                        \"instances\": [\n                            \"INSTANCE(12345689)\"\n                        ]\n                    }\n                ],\n                \"additionalObjects\": {},\n                \"naam\": \"2023/2024\",\n                \"vanafDatum\": \"2023-08-01\",\n                \"totDatum\": \"2024-07-31\",\n                \"isHuidig\": true\n            },\n            \"vak\": {\n                \"links\": [\n                    {\n                        \"id\": 12345689,\n                        \"rel\": \"self\",\n                        \"type\": \"onderwijsinrichting.RVak\",\n                        \"href\": \"https://api.somtoday.nl/rest/v1/vakken/12345689\"\n                    }\n                ],\n                \"permissions\": [\n                    {\n                        \"full\": \"onderwijsinrichting.RVak:READ:INSTANCE(12345689)\",\n                        \"type\": \"onderwijsinrichting.RVak\",\n                        \"operations\": [\n                            \"READ\"\n                        ],\n                        \"instances\": [\n                            \"INSTANCE(12345689)\"\n                        ]\n                    }\n                ],\n                \"additionalObjects\": {},\n                \"afkorting\": \"ne\",\n                \"naam\": \"Nederlandse taal\",\n                \"UUID\": \"REDACTED\"\n            },\n            \"heeftStamgroep\": false,\n            \"examendossierOndersteund\": false,\n            \"vestiging\": {\n                \"links\": [\n                    {\n                        \"id\": 12345689,\n                        \"rel\": \"self\",\n                        \"type\": \"instelling.RVestiging\",\n                        \"href\": \"https://api.somtoday.nl/rest/v1/vestigingen/12345689\"\n                    }\n                ],\n                \"permissions\": [\n                    {\n                        \"full\": \"instelling.RVestiging:READ:INSTANCE(12345689)\",\n                        \"type\": \"instelling.RVestiging\",\n                        \"operations\": [\n                            \"READ\"\n                        ],\n                        \"instances\": [\n                            \"INSTANCE(12345689)\"\n                        ]\n                    }\n                ],\n                \"additionalObjects\": {},\n                \"naam\": \"REDACTED\",\n                \"uuid\": \"REDACTED\"\n            }\n        }\n    },\n    ...\n}\n```\n`GET /rest/v1/studiemateriaal/algemeen/[id]` returns:\n\n```json\n{\n  \"items\": [\n    {\n      \"$type\": \"leermiddel.REduRoutePortalUserProduct\",\n      \"links\": [\n        {\n          \"id\": 123456789,\n          \"rel\": \"self\",\n          \"type\": \"leermiddel.REduRoutePortalUserProduct\",\n          \"href\": \"https://api.somtoday.nl/rest/v1/edurouteportaluserproduct/123456789\"\n        }\n      ],\n      \"permissions\": [\n        {\n          \"full\": \"leermiddel.REduRoutePortalUserProduct:READ:INSTANCE(123456789)\",\n          \"type\": \"leermiddel.REduRoutePortalUserProduct\",\n          \"operations\": [\"READ\"],\n          \"instances\": [\"INSTANCE(123456789)\"]\n        }\n      ],\n      \"additionalObjects\": {},\n      \"leerling\": {\n        \"$type\": \"leerling.RLeerlingPrimer\",\n        \"links\": [\n          {\n            \"id\": 9496745174,\n            \"rel\": \"self\",\n            \"type\": \"leerling.RLeerlingPrimer\",\n            \"href\": \"https://api.somtoday.nl/rest/v1/leerlingen/9496745174\"\n          }\n        ],\n        \"permissions\": [\n          {\n            \"full\": \"leerling.RLeerlingPrimer:READ:INSTANCE(9496745174)\",\n            \"type\": \"leerling.RLeerlingPrimer\",\n            \"operations\": [\"READ\"],\n            \"instances\": [\"INSTANCE(9496745174)\"]\n          }\n        ],\n        \"additionalObjects\": {},\n        \"UUID\": \"f8cf6f6c-c213-4526-8ba1-6a306cf724a4\",\n        \"leerlingnummer\": 123456,\n        \"roepnaam\": \"{{first_name}}\",\n        \"achternaam\": \"{{last_name}}\"\n      },\n      \"product\": {\n        \"$type\": \"leermiddel.REduRoutePortalProduct\",\n        \"links\": [\n          {\n            \"id\": 1234567890123,\n            \"rel\": \"self\",\n            \"type\": \"leermiddel.REduRoutePortalProduct\",\n            \"href\": \"https://api.somtoday.nl/rest/v1/edurouteportalproduct/1234567890123\"\n          }\n        ],\n        \"permissions\": [\n          {\n            \"full\": \"leermiddel.REduRoutePortalProduct:READ:INSTANCE(1234567890123)\",\n            \"type\": \"leermiddel.REduRoutePortalProduct\",\n            \"operations\": [\"READ\"],\n            \"instances\": [\"INSTANCE(1234567890123)\"]\n          }\n        ],\n        \"additionalObjects\": {},\n        \"title\": \"Chemie Overal ed 5.0 vwo 5 FLEX  boek + online\",\n        \"url\": \"https://toegang.noordhoff.nl/1234567890123\",\n        \"UUID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n        \"methodeInformatie\": {\n          \"$type\": \"leermiddel.RMethodeInformatie\",\n          \"links\": [\n            {\n              \"id\": 1234567890123,\n              \"rel\": \"self\",\n              \"type\": \"leermiddel.RMethodeInformatie\",\n              \"href\": \"https://api.somtoday.nl/rest/v1/methodeinformatie/1234567890123\"\n            }\n          ],\n          \"permissions\": [\n            {\n              \"full\": \"leermiddel.RMethodeInformatie:READ:INSTANCE(1234567890123)\",\n              \"type\": \"leermiddel.RMethodeInformatie\",\n              \"operations\": [\"READ\"],\n              \"instances\": [\"INSTANCE(1234567890123)\"]\n            }\n          ],\n          \"additionalObjects\": {},\n          \"UUID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\n          \"dashboardMethodeNaam\": \"Chemie overal\",\n          \"methode\": \"Chemie overal\",\n          \"uitgever\": \"Noordhoff\"\n        }\n      },\n      \"UUID\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"\n    },\n    ...\n  ]\n}\n\n```\n\n\u003c/details\u003e\n\n### ICalendar: `GET /rest/v1/icalendar`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nFetches the url to the icalendar stream.\n\n#### Parameters\n\n| Name          | Type      | Value                 |\n|---------------|-----------|-----------------------|\n| Authorization | Header    | Bearer [access_token] |\n\n#### Returns\n\n```json\n{\n    \"links\": [],\n    \"permissions\": [],\n    \"additionalObjects\": {},\n    \"leerlingICalendarLink\": \"https://api.somtoday.nl/rest/v1/icalendar/stream/REDACTED\"\n}\n```\n\n\u003c/details\u003e\n\n### ICalendar: `DELETE /rest/v1/icalendar`\n\u003cdetails\u003e\u003csummary\u003eClick to open\u003c/summary\u003e\n\nDeletes the currently active icalendar stream\n\n#### Parameters\n\n| Name          | Type      | Value                 |\n|---------------|-----------|-----------------------|\n| Authorization | Header    | Bearer [access_token] |\n\n#### Returns\n\nNONE\n\n\u003c/details\u003e\n\n### Undocumented:\n\n- `GET /rest/v1/medewerkers/ontvangers`\n- `GET /rest/v1/maatregeltoekenningen`\n- `GET /rest/v1/leerlingadresseringen`\n- `GET /rest/v1/verzorgers/`\n- `GET /rest/v1/onderwijsopafstandperiodes/`\n- `GET /rest/v1/edurouteportaluserproduct/[id]`\n- `GET /rest/v1/methodeinformatie/[id]`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felisaado%2Fsomtoday-api-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felisaado%2Fsomtoday-api-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felisaado%2Fsomtoday-api-docs/lists"}