Postman API Collection
Met deze Postman collection test je de Altum AI API direct en zie je per endpoint welke invoer wordt verwacht en welke output je terugkrijgt.
Download de Postman Collection
Gebruik deze collectie om alle Altum AI API’s direct te testen, requests te valideren en voorbeeldcode te genereren voor Nederlandse vastgoeddata.
Altum AI Postman API – Integratiehandleiding
De Altum AI Postman Collection biedt vooraf geconfigureerde requests voor een breed scala aan API’s:
Woningwaardering & AVM: directe waarde- en marktprijsinschattingen
Verduurzaming & Energielabels: energieprestaties volgens NTA 8800
Objectdata & Geometrie: bouwjaar, oppervlak, inhoud, coördinaten
Marktdata & Transacties: verkoopprijzen, huurreferenties en WWS-punten
Met deze collectie kun je endpoints testen, input/output begrijpen en integraties bouwen in productie- of sandboxomgevingen.
Aan de slag & authenticatie
Altum AI gebruikt API Key-authenticatie via headers.
Base URL:
https://api.altum.aiHeader Key:
x-api-key
Import instructies:
Sleep het
Altum APIs.postman_collection.jsonbestand in je Postman workspaceGa naar het tabblad Variabels van de collectie
Vervang
API_KEYdoor je productie- of sandboxkeyAlle requests gebruiken standaard de collectie-authenticatie
Kern API-categorieën
1. Woningwaardering & AVM
Endpoints:
/avm,/avmplus,/listingpriceBelangrijkste inputs: postcode, huisnummer, valuationdate
Gebruik: Bereken woningwaardes en marktprijzen op basis van Nederlandse trends
Voor: Hypotheekverstrekkers, makelaars, fintech-platforms
2. Verduurzaming & Energielabels
Endpoints:
/sustainability(v1 & v2),/energy-insights,/energylabelData: huidig label, potentieel label, COâ‚‚-reductie, ROI van maatregelen
Voor: Groene financiering, ESG-rapportages, woningverbeteringsadvies
3. Objectdata & Geometrie
Endpoints:
/objectdata,/location-data,/geometryData: bouwjaar, oppervlak (m²), inhoud (m³), 3D-coördinaten
4. Marktdata & Transacties
Endpoints:
/movedata,/transaction,/rental-reference,/wwsGebruik: Vergelijk vraagprijzen met verkoopprijzen of bereken WWS-punten
LLM & integratiecontext
Gebruik deze semantische mappings voor AI-agents en automatisering:
Property ID
bagid
String/Integer
Postcode NL
postcode (1234AB)
String
Energienorm
NTA 8800
Contextual
Waarderingsdatum
valuationdate (YYYYMMDD)
String
POST-request structuur:
Foutafhandeling & statuscodes
401/403– Ongeldige API Key of onvoldoende rechten422– Validatiefout (bijv. foutieve postcode)429– Rate limit overschreden
Extra resources
Documentatie: docs.altum.ai
Support: Contacteer het Altum AI team voor implementatiehulp
Last updated