API-endpoint reporting/leave-requests: verlofaanvragen

Het endpoint reporting/leave-requests geeft de verlofaanvragen per medewerker voor een gegeven periode.

Request

MethodeGET
URLreporting/leave-requests/{startDate}/{endDate}/
Parameterstoken, contractPermanent (optioneel, 0 of 1, standaard 1), contractFlex (optioneel, 0 of 1, standaard 1), sort (optioneel, veldnaam om op te sorteren, zie de veldbeschrijving), order (optioneel, asc of desc, standaard asc)

Voorbeeld: /api/v1/reporting/leave-requests/{startDate}/{endDate}/?token=xxxxxxxx-xxx-xxxx-xxxx-xxxxxxxxxxxx

Voorbeeld van een antwoord

{
    "[request]": {
        "path": "/api/v1/reporting/leave-requests/2026-07-15/2026-08-31/",
        "arguments": {
            "startDate": "2026-07-15",
            "endDate": "2026-08-31"
        },
        "date": "2026-09-05 11:39:09",
        "status": "success"
    },
    "[leaveRequests]": [
        {
            "firstName": "Joëlle",
            "lastName": "Ekkers",
            "externalReference": null,
            "contractType": "vast",
            "startDate": "2026-08-10",
            "startTime": null,
            "endDate": "2026-08-10",
            "endTime": null,
            "requestedHours": "10.00",
            "compensationHours": 0,
            "leaveType": "geboorteverlof (betaald)",
            "status": "akkoord",
            "notes": null
        }
    ]
}

Veldbeschrijving

VeldBeschrijving
firstNameVoornaam medewerker
lastNameAchternaam medewerker
externalReferenceExterne referentie / medewerkernummer
contractTypeContractsoort: vast of flex
startDateStartdatum van de verlofaanvraag (jjjj-mm-dd)
startTimeStarttijd van de verlofaanvraag, of null bij een hele dag verlof
endDateEinddatum van de verlofaanvraag (jjjj-mm-dd)
endTimeEindtijd van de verlofaanvraag, of null bij een hele dag verlof
requestedHoursAantal aangevraagde verlofuren
compensationHoursAantal uren opgenomen als tijd-voor-tijd (TvT) in plaats van verlof
leaveTypeSoort verlof (bijvoorbeeld regulier of geboorteverlof (betaald))
statusStatus van de aanvraag: open, akkoord of afgewezen
notesOpmerking bij de verlofaanvraag, of null als die leeg is

Lees in Roosterplaats API hoe u de API inschakelt en hoe de antwoorden zijn opgebouwd.

Laatst bijgewerkt:

Meer artikelen in Endpoint-specificaties

Stel uw vraag via WhatsApp