Hoe werken datum- en tijdvelden in de API?
De API geeft datums en tijden in twee formaten terug, naast elkaar in hetzelfde antwoord:
- Het gewone formaat is
YYYY-MM-DD HH:MM:SS, bijvoorbeeld2026-05-18 14:30:00. Hier staat geen tijdzone bij. Dit is de datum en tijd in de tijdzone van het account. Die tijdzone staat in het veldtimezonevan hetzelfde object. - Het ISO-formaat bevat de offset voor de tijdzone, bijvoorbeeld
2026-05-18T14:30:00+02:00. Je herkent deze velden aan de toevoeging_iso.
Werk je met gebruikers of systemen in verschillende tijdzones, gebruik dan de _iso-variant. Dan is het altijd duidelijk om welke tijdzone het gaat.
Lege datumvelden uitlezen
Is de gewone waarde leeg, dan kan de _iso-variant helemaal ontbreken in het antwoord. Bij een veld dat nooit gewijzigd is, krijg je bijvoorbeeld wel "modified": null, maar geen modified_iso. Ga er dus niet vanuit dat dit veld altijd in het antwoord zit.
Andere objecten geven in dezelfde situatie wel "modified_iso": null terug. Controleer bij het uitlezen daarom altijd eerst of het veld in het antwoord zit.
Zelf een datum meesturen
Accepteert een endpoint een datum, dan mag je beide formaten gebruiken. Stuur je een ISO-datum mee in een query string, vervang het plusteken dan door %2B: