Zwembadtijden Data

Partner-API en webwidget

Voeg actuele, genormaliseerde zwemtijden toe aan een gemeentelijke website, exploitantenapp of eigen dashboard.

Server-API

Gebruik een geheime serverkey. Responses bevatten bronlinks, confidence, versheid en dagelijkse limietheaders.

curl "https://jouwdomein.nl/api/v1/search?municipality=utrecht&date=2026-07-03&limit=10" \
  -H "Authorization: Bearer zr_live_..."

Webwidget

Gebruik een widgetkey die in Admin aan de website-origin van de klant is gekoppeld.

<zwembadtijden-widget
  api-key="zr_widget_..."
  municipality="utrecht"
  activity="banenzwemmen"
  limit="4">
</zwembadtijden-widget>
<script async src="https://zwembadtijden.nl/zwembadtijden-widget.js"></script>

Beschikbare endpoints

Methode	Endpoint	Gebruik
GET	/api/v1/search	Zoek roosterregels op datum, gemeente, afstand, activiteit en doelgroep.
GET	/api/v1/venues/:id	Haal locatie-, bassin-, prijs- en toegankelijkheidsinformatie op.
GET	/api/v1/openapi.json	Machineleesbaar OpenAPI-contract.