Analysis endpoint

REST API endpoints

De volgende API endpoints kunnen bevraagd worden na authenticatie. In alle calls moet de eerdergenoemde JWT token meegegeven worden.

• Product 'analyse': https://ws.fundermaps.com/api/v3/product/analysis/{id}

De {id} parameter in een endpoint wordt gebruikt voor het aavragen van een object. De volgende waarde worden geaccepteerd als object:

• BAG pand 1.0 (Voorbeeld: 0505100000043060)
• BAG pand 2.0 (Voorbeeld: NL.IMBAG.PAND.0344100000090032)
• BAG nummeraanduiding 1.0 (Voorbeeld: 0758200000100363)
• BAG nummeraanduiding 2.0 (Voorbeeld: NL.IMBAG.NUMMERAANDUIDING.0758200000100520)

Voorbeeld teruglevering:
NL.IMBAG.NUMMERAANDUIDING.0399200000000095.json

Staging

Voor het testen van de webservice is een staging omgeving ingericht. Deze omgeving verschilt alleen op domein. Aanvragen verlopen exact hetzelfde op de staging omgeving als op de productie omgeving, inclusief dezelfde authenticatiegegevens en product data. Dezelfde API key zal dus werken op zowel de staging omgeving als op de productie omgeving.

• Product 'analyse': https://ws-staging.fundermaps.com/api/v3/product/analysis/{id}

Na het gebruik van de staging omgeving kan naadloos en zonder extra gegevens gebruik worden gemaakt van de productie omgeving.

Catalogus

Attributen en taxanomie

Download hier de tabel:

• taxanomie_03072025.xlsx (fasing out)
• taxanomie_25082025.xlsx (fasing out)
• taxanomie_02122025.xlsx

Toelichting catalogus

Betrouwbaarheden

Binnen de webservice V3 worden verschillende soorten vastgestelde data ontsloten, waaronder bijvoorbeeld funderingsherstel, ondergrondtype, pandhoogte en funderingstype. Wanneer deze informatie in de database is opgenomen, betreft het vastgestelde informatie. Deze data geniet de hoogst mogelijke betrouwbaarheid, aangezien er een brondocument als bewijs beschikbaar is. Indien deze informatie beschikbaar is, wordt deze ontsloten in de webservice.

Voor het funderingstype zijn er naast vastgestelde gegevens ook inschattingen beschikbaar voor panden waarvan geen gegevens bekend zijn. Hiervoor is een model in FunderMaps ontwikkeld. De betrouwbaarheid van het toegekende funderingstype wordt meegestuurd en kan worden gebaseerd op de nieuw geïntroduceerde “cluster” betrouwbaarheid (waarbij naar naastgelegen panden wordt gekeken) of volgens de modelanalyse “indicative”.

Voor de risicoanalyses van funderingsproblematiek geldt eenzelfde uitgangspunt. Wanneer er kwaliteitsgegevens bekend zijn in de FunderMaps database, wordt het risico als “vastgesteld” ontsloten. Wanneer het risico uit de omgeving kan worden aangenomen of middels een modelanalyse kan worden bepaald, geldt een respectievelijke betrouwbaarheid van “cluster” of “indicatief”.

Beschikbaarheid Data

Alle attributen, met uitzondering van de met ‘Indien beschikbaar’ aangeduide attributen, kunnen voor 99% van de bevragingen (1 bevraging = 1 adres) worden ontsloten. In 1% van de bevragingen kan het voorkomen dat er gegevens voor dat object ontbreken. In dat geval ontbreken er een of meer uitgangspunten die noodzakelijk zijn voor de analyse of bepaalde uitgangspunten vallen buiten de toleranties. In dat geval wordt “onbekend” teruggegeven.

Bouwjaar

Het bouwjaar dat wordt meegegeven in de webservice kan verschillen van de uitgangspunten van de BAG. Wanneer het bouwjaar in de FunderMaps database is vastgelegd, kan ervan uitgegaan worden dat het bouwjaar in de BAG niet correct is. Het bouwjaar in FunderMaps wordt alleen vastgelegd indien het afwijkt van het bouwjaar dat de BAG ontsluit. Er is binnen FunderMaps dan een bewijsdocument voor deze afwijking beschikbaar.

Funderingsherstel

Panden waarbij funderingsherstel is uitgevoerd, worden ontsloten. Deze gegevens zijn echter niet landelijk compleet en zijn geregistreerd bij de samenwerkende gemeentes of door input van de woningeigenaar zelf via een melding in het nationaal funderingsloket. Het kan dus voorkomen dat panden niet als “hersteld” worden weergegeven terwijl dit wel het geval is.

Herstelkosten

Inzicht wordt gegeven in de lokale indicatieve kosten voor funderingsherstel indien een van de indicatieve risicobeoordelingen als “Hoog” wordt aangegeven.

Registratie

Een bevraging aan de webservice op nummeraanduiding, pandnummer of adres geldt als één (1) call. Over de in de overeenkomst afgesproken termijn wordt het totaal van alle calls opgeteld en in rekening gebracht. Een afschrift van de gemaakte calls is inzichtelijk in uw FunderMaps Dashboard. De registratie van de gemaakte calls maakt geen onderscheid in dubbele aanvragen. Twee dezelfde aanvragen worden geregistreerd als twee (2) calls.