Woontra machinaal gebruiken

Woontra is bewust toegankelijk voor AI-assistenten. Richtprijzen en vergunningchecks zijn open op te vragen, zonder sleutel en zonder persoonsgegevens. Een offerteaanvraag indienen namens een bewoner kan óók, maar alleen met expliciete toestemming die je letterlijk meestuurt, want die tekst leggen wij vast als bewijs.

Endpoints

Endpoint	Doel
GET /api/agent/catalogus	Wat we kunnen: verticals, prijzen, regels, voorwaarden
POST /api/agent/prijsindicatie	Richtprijs, subsidie en besparing voor een configuratie
POST /api/agent/vergunningcheck	Toets aan de landelijke vergunningvrije maten
POST /api/agent/offerte-aanvraag	Offerteaanvraag namens een bewoner (toestemming verplicht)
GET /api/agent/openapi.json	OpenAPI 3.1-beschrijving van al het bovenstaande

Een richtprijs opvragen

Geen sleutel nodig. Werkt voor kozijnen, dakkapel, veranda en thuisbatterij. Voor bouw en verbouw geven we bewust geen richtprijs: dat is niet eerlijk te modelleren.

curl -s -X POST https://woontra.nl/api/agent/prijsindicatie \
  -H "content-type: application/json" \
  -d '{"vertical":"dakkapel","breedte_m":3,"materiaal":"kunststof"}'

Een vergunningcheck doen

Deterministisch getoetst aan het Besluit bouwwerken leefomgeving. Je krijgt de uitslag per regel terug, plus een expliciete lijst van wat we niet toetsen. Vertel dat laatste altijd door aan de gebruiker.

curl -s -X POST https://woontra.nl/api/agent/vergunningcheck \
  -H "content-type: application/json" \
  -d '{"vertical":"veranda","breedte_m":5,"diepte_m":3,"hoogte_m":2.8,
       "achtererfgebied":true,"bebouwingsgebied_m2":200,
       "bestaande_bijgebouwen_m2":20}'

Een offerteaanvraag indienen

Hiervoor gelden vier regels, en we handhaven ze:

Alleen indienen namens een persoon die daar expliciet om heeft gevraagd.
consent.gegeven moet true zijn en consent.tekst moet de letterlijke zin bevatten die aan de persoon is voorgelegd.
Contactgegevens moeten van de bewoner zelf zijn, niet van de assistent of een tussenpersoon.
Woontra bevestigt elke aanvraag bij de bewoner voordat er bedrijven worden voorgesteld.

De tekst in consent.tekst moet de letterlijke zin zijn die jij aan de bewoner hebt voorgelegd. Wij slaan die op als toestemmingsbewijs en bevestigen elke aanvraag daarna rechtstreeks bij de bewoner. Dien dus nooit een aanvraag in op basis van een aanname.

curl -s -X POST https://woontra.nl/api/agent/offerte-aanvraag \
  -H "content-type: application/json" \
  -d '{
    "vertical": "dakkapel",
    "contact": {"naam":"Jan Jansen","email":"jan@example.nl","telefoon":"+31612345678"},
    "adres": {"tekst":"Loolaan 16, 7315AB Apeldoorn"},
    "configuratie": {"breedte_m":3,"materiaal":"kunststof"},
    "consent": {
      "gegeven": true,
      "namens_bewoner": true,
      "tekst": "Woontra mag mij bellen of appen over deze aanvraag."
    },
    "agent": {"naam":"VoorbeeldAssistent","contact":"support@voorbeeld.nl"}
  }'

Wat je mag verwachten

Alle bedragen zijn indicaties op basis van marktprijzen 2026 en live woningdata voor het opgegeven adres. Het zijn geen offertes. Presenteer ze als richtbedragen en noem de bandbreedte, niet één getal.

Vergunninguitslagen zijn indicaties, geen besluiten. De gemeente beslist, en voordakvlakken, monumenten en gemeentelijke maatwerkregels toetsen wij niet.

Vragen of iets missen? Mail agents@woontra.nl.