Hieronder is een lijst van alle beschikbare API versies. Klik op een versie om de documentatie te bekijken.
Voor versies onder versie 3 zijn aparte API tokens nodig, waarbij bijvoorbeeld tokens van versie 1 niet werken voor versie 2 of 3.
Het is belangrijk om de juiste tokens te verkrijgen en correct toe te passen voor elke versie. Vanaf versie 3 is het echter mogelijk om één token te gebruiken voor alle versies.
Dit betekent dat bijvoorbeeld versie 4(+) dezelfde tokens zal gebruiken als versie 3, waardoor het gebruik van één token voor verschillende versies mogelijk wordt.
Indien u nog een token heeft voor versie 1 of 2 wordt u aangeraden om een nieuw token aan te vragen voor versie 3. Dit kan vanaf nu zelfstanding doen via het portaal onder het menu 'API' (alleen beschikbaar voor uitleners).
| Versie | Opmerkingen (wijzigingen ten opzichte van de vorige versie) | Status | Gepubliceerd op | EOL op |
|---|---|---|---|---|
| 8.0.0 | SETU 2.0 update. Verzekeringen stap toegevoegd, voorwaarden en/of beschrijving tekstveld toegevoegd aan alle stappen. | Released | 30/05/2026 | - |
| 7.6.0 | rawHourlyWage veld toegevoegd aan functiegroepen voor niet-afgeronde waarde van het uurloon. | Released | 05/05/2026 | - |
| 7.5.0 | 'Word beschreven als waarde' vraag toegevoegd aan stappen. Beschrijving veld toegevoegd aan duurzame inzetbaarheid. Type wordt tekstveld toegevoegd bij eenmalige uitkeringen, vaste onvoorwaardelijke uitkeringen en jubilieumuitkeringen. Diverse SETU versie 1.0 bugfixes & ophalen van specifieke versie van pdf & json inlenersbeloningen op basis van documentID in plaats van numerieke versie. | Released | 18/03/2026 | - |
| 7.4.0 | 'Dagen' bij IKB eenheid dropdown toegevoegd. En 'TypeOther' veld toegevoegd aan vergoedingen. | Released | 18/02/2026 | - |
| 7.3.0 | AutoAssistType toegevoegd aan uitnodigingen, op basis daarvan wordt er een meehelpverzoek of meehelpverzoek+ met additionele rechten klaargezet | Released | 13/01/2026 | - |
| 7.2.0 | Interval opties beperken voor arbeidsduur verkorting | Released | 02/01/2026 | - |
| 7.1.0 | Nieuw endpoint for base64 encoded pdf van de inlenersbeloning. Verder toevoeging van beschrijving veld bij loondoorbetaling bij ziekte, beschreven als waarde velden bij overige arbeidsvoorwaarden & duurzame inzetbaarheid. | Released | 22/12/2025 | - |
| 7.0.0 | Diverse kleine toevoegingen, arbeidsduur per week indien anders & tijd-voor-tijd regeling | Released | 27/11/2025 | - |
| 6.3.0 | Werkomschrijving in SETU endpoint toevoegen samen met diverse bugfixes | Released | 06/11/2025 | - |
| 6.2.0 | Naar rato velden voor vergoedingen | Released | 29/10/2025 | - |
| 6.1.0 | Doelgroep voor pensioen, min-max waarde voor vergoedingen & gebruik van CAO veld voor SETU endpoint | Released | 25/10/2025 | - |
| 6.0.0 | Nieuwe API onderdelen voor nieuwe uitvraag standaard (2026), SETU standaard en migratie bestaande toeslagen, vergoedingen, overige arbeidsvoorwaarden & reisuren- reistijd | Released | 20/10/2025 | - |
| 5.0.0 | Uitfaseren velden van arbeidsduurverkorting, vrijstellingen voor (onbelaste) vergoedingen toevoegen van vakantiebijslag & eindejaarsuitkering | Released | 20/08/2025 | - |
| 4.6.0 | CAO API - Ophalen van volledige CAO informatie | Released | 12/06/2025 | - |
| 4.5.0 | CAO API | Released | 05/05/2025 | - |
| 4.4.0 | Uitbreiding velden voor uitnodiging om gang van zaken te versnellen (fast-lane) | Released | 05/02/2024 | - |
| 4.3.0 | Functie afhankelijkheden toegevoegd aan stap 4 t/m 8 | Released | 23/12/2024 | - |
| 4.2.1 | Optie: '6 ploegendienst' toegevoegd aan toeslagen | Released | 05/09/2024 | - |
| 4.2.0 | Toeslag type tijd toegevoegd | Released | 17/06/2024 | - |
| 4.1.0 | Rekenmethodes verplaatsen, inlenersbeloning webhook informatie uitbreiden, backoffice functionaliteit en aantal kleine correcties | Released | 30/05/2024 | - |
| 4.0.1 | Dubbele encoding van de query parameters in de oAuth callback URL opgelost | Released | 08/05/2024 | - |
| 4.0.0 | Toepassing van oAuth 2.0 voor authenticatie en autorisatie van gebruikers | Released | 14/02/2024 | - |
| 3.4.0 | Functie afhankelijkheden toegevoegd aan stap 4 t/m 8 | Released | 23/12/2024 | - |
| 3.3.1 | Optie: '6 ploegendienst' toegevoegd aan toeslagen | Released | 05/09/2024 | - |
| 3.3.0 | Toeslag type tijd toegevoegd | Released | 17/06/2024 | - |
| 3.2.0 | Rekenmethodes verplaatsen, inlenersbeloning webhook informatie uitbreiden, backoffice functionaliteit en aantal kleine correcties | Released | 30/05/2024 | - |
| 3.1.0 | Uitvraag API (ophalen van verstrekte functies, versturen van uitnodigingen om te verstrekken & webhooks) | Released | 10/10/2023 | - |
| 3.0.0 | Nieuwe opbouw & documentatie | Released | 22/09/2023 | - |
| 2.1.0 | Aanbieden van informatie n.a.v. wijzigingen per 1 juli voor inlenersbeloningen | Released | 12/05/2023 | 30/05/2024 |
| 2.0.0 | Update met o.a. betrekking op organisatie structuur en de indeling van het systeem | Released | 19/01/2023 | 30/05/2024 |
| 1.0.0 | Originele versie | Released | - | 30/05/2024 |