Voor developers — API
Documentatie voor partners die Ketelafspraak-tarieven, beschikbaarheid of attest-status willen integreren.
Wat de API doet
De Ketelafspraak-API geeft partners read-only toegang tot tariefdata, beschikbaarheid per regio en attest-verificatie. Bedoeld voor:
- Verzekeraars die willen verifiëren of een geclaimd onderhoud effectief is uitgevoerd.
- Vastgoedbeheerders die tarieven en planningen willen tonen in een interne tool.
- Energie- en isolatie-platformen die een onderhoudsmoment willen voorstellen na een offerte.
Endpoints (v1, REST)
| Methode | Pad | Functie |
|---|---|---|
GET | /api/v1/merken | Lijst van ondersteunde ketel-merken. |
GET | /api/v1/werktypes | Onderhoud, herstelling, met basis-tarieven per type. |
GET | /api/v1/tarief/{merk}/{werktype}/{gemeente} | Vast tarief voor de combinatie. |
GET | /api/v1/beschikbaarheid/{gemeente} | Eerstvolgende vrije tijdsloten. |
POST | /api/v1/attest/verifieer | Controle van een attest-nummer. |
Authenticatie
Bearer-token, uitgegeven per partner. Rate-limit: 60 requests/minuut voor read-endpoints, 10/minuut voor attest-verificatie. Voor toegang: api@ketelafspraak.be met een korte beschrijving van de use case.
Status
De v1 is in beperkte release. Endpoints en payload-structuur kunnen tot eind 2026 nog wijzigen — wij garanderen 30 dagen aankondiging voor breaking changes binnen actieve partner-integraties.
Klaar om uw afspraak te plannen?
Boek nu