REST API

Koppel Offzo met je bestaande systemen via de API.

Overzicht

De Offzo API biedt read-only toegang tot medewerker-, verlof- en verzuimgegevens. Gebruik de API om data te synchroniseren met andere HR-systemen, dashboards of rapportage-tools.

Volledige interactieve documentatie met voorbeelden en een "Try it" functie is beschikbaar op de Developers pagina.

Authenticatie

De API gebruikt Bearer token authenticatie. Je token stuur je mee in de Authorization header:

curl -H "Authorization: Bearer offzo_jouw_token" \
  https://offzo.nl/api/v1/organizations/SLUG/members

Token aanmaken

Ga naar Instellingen in je organisatie.
Scroll naar API Tokens.
Klik op Token aanmaken, geef het een naam en optionele vervaldatum.
Kopieer het token — het wordt eenmalig getoond.

Tip: Bewaar je token op een veilige plek. Je kunt het later niet meer ophalen. Als je het kwijtraakt, deactiveer het oude token en maak een nieuw aan.

Beschikbare endpoints

Endpoint	Beschrijving
`GET /members`	Lijst van alle actieve medewerkers
`GET /members/:id`	Detail incl. contracten en saldo's
`GET /leave-requests`	Verlofaanvragen (met filters)
`GET /balances`	Verlofsaldo's per medewerker
`GET /absences`	Verzuimmeldingen (met filters)

Alle endpoints zijn beschikbaar onder https://offzo.nl/api/v1/organizations/:slug/

Paginering

Alle lijst-endpoints ondersteunen paginering:

?page=1 — Paginanummer (default: 1)
?per_page=50 — Resultaten per pagina (default: 50, max: 100)

De response bevat een meta object met paginering-informatie:

{
  "data": [...],
  "meta": {
    "total": 42,
    "page": 1,
    "perPage": 50,
    "totalPages": 1
  }
}

Rate limiting

De API staat 1.000 requests per uur per token toe. Bij overschrijding ontvang je een 429 Too Many Requests response met een Retry-After header.