Partner API

Koppel de WWS-puntentelling met je eigen software

Bereken WWS-punten, maximale huur en huursegment via één eenvoudige REST-API — altijd op de meest recente regels, met automatische adres- en energielabel-verrijking. Ideaal voor vastgoedbeheer-software.

Altijd actuele regels

Elke berekening draait op de meest recente, juridisch geldende WWS-versie voor de opgegeven peildatum. Wetswijzigingen verwerken wij — jij hoeft niets bij te houden.

Adres erin, alles eruit

Geef alleen een adres en de kenmerken die je kent. Wij vullen automatisch het energielabel (EP-Online) en de WOZ-waarde aan en berekenen de punten.

Deterministisch & uitlegbaar

Je krijgt niet alleen het totaal, maar ook de puntentelling per rubriek met uitleg — direct te tonen of te bewaren bij het huurcontract.

Zelf koppelen, vandaag nog

Maak in je account een API-key aan en bouw direct. Je eerste 25 berekeningen zijn gratis — daarna pay-as-you-go.

In drie stappen gekoppeld

1

Maak een API-key aan

Ga naar Account → API-keys en genereer een key. Bewaar hem veilig — je ziet hem maar één keer.

2

Roep de API aan

Stuur een POST-request met je woningkenmerken. Voor de meeste integraties is /enrich het handigst: adres + minimale input.

3

Verwerk het resultaat

Je ontvangt WWS-punten, maximale huur, het huursegment en de puntentelling per rubriek — klaar om in je eigen software te tonen.

Voorbeeld-aanroep

curl -X POST https://api.vastgoedvoordeel.com/v1/huurpunten/enrich \
  -H "Authorization: Bearer vv_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "postcode": "1012JS",
    "huisnummer": "34",
    "facts": { "woonoppervlakte_m2": 75 }
  }'

Voorbeeld-antwoord

{
  "ok": true,
  "data": {
    "totalPoints": 156,
    "maxRent": 1123.50,
    "segment": "midden",
    "rulesetVersionCode": "ZELFSTANDIG_WWS_2024.01",
    "lineItems": [ /* puntentelling per rubriek */ ],
    "warnings": [],
    "enrichment": {
      "energyLabel": { "applied": true, "labelClass": "B", "source": "ep-online" },
      "woz": { "applied": true, "value": 285000, "source": "kadaster" }
    }
  }
}

Gratis starten, daarna betalen per gebruik

Je eerste 25 berekeningen zijn gratis. Daarna betaal je € 0,50 excl. btw per berekening, maandelijks gebundeld op één factuur. Grotere koppeling of een vast tarief nodig? Neem contact op.

Klaar om te koppelen?

Maak een API-key aan en bouw vandaag nog je eerste integratie.

Uitleg in de kennisbank

Regels en hoe het product werkt — geen marketingpagina’s.