Taxon Partner API

1.Overzicht

Eén aanvraag per adres, één gegevensbundel voor het expertisedossier: het basispakket (referentiepunten, buurtstatistieken, voorzieningen, perceel en prijskaart) en, als aparte optie, een indicatieve waardering (AVM). Voor wederverkoop-partners die de gegevens tonen in hun eigen software.

2.Authenticatie

Elke aanvraag draagt de header X-Api-Key. De sleutel is lang-levend, gebonden aan uw partneraccount en wordt door Taxon enkel als hash bewaard. U krijgt ze precies één keer te zien, in het partnerdashboard (zie "Uw sleutels beheren" hieronder).

• Geheimhouding. De sleutel blijft in uw backend. Nooit in een browser, een mobiele app of een publieke repository. Roep de API server-naar-server aan.
• Rotatie. Een live-sleutel roteert u zelf in het partnerdashboard (zie "Uw sleutels beheren" hieronder): de nieuwe sleutel wordt één keer getoond, de oude blijft 7 dagen werken met de melding key_rotation_pending en antwoordt daarna 403 key_revoked.
• IP-allowlist. Optioneel kan de sleutel beperkt worden tot de IP-adressen van uw servers (403 ip_not_allowed vanaf elk ander adres).
• Lek of vermoeden van misbruik: roteer of trek de sleutel meteen zelf in via het dashboard en meld het binnen 48 uur; Taxon trekt de oude sleutel dan zo nodig onmiddellijk in.

Uw sleutels beheren 2.3.0

Sinds 08-09-2026 beheert u uw sleutels zelf in het partnerdashboard op taxon.be (taxon.be/api_partner, luik "Beheer"). Elke handeling daar wordt gelogd (wie, wanneer, vanaf welk IP-adres) en aan Taxon gemeld; de waarde van een sleutel staat nooit in een log of een e-mail.

Foutcodes van de dashboardhandelingen (als tekst getoond in het dashboard, nooit op /address of /usage): key_already_revealed, reveal_expired, not_revealable, key_limit_reached, live_key_not_allowed, not_self_revocable.

3.Headers

Elk antwoord (ook een fout) bevat de header X-Request-ID en het veld request_id. Vermeld het bij elke supportvraag.

4.GET /address

Levert de gevraagde secties voor één adres in Vlaanderen, Wallonië of Brussel. Verwerking: validatie, plafondcontrole, geocoding, dedup-controle, secties parallel ophalen, aanrekening, antwoord. Typische antwoordtijd 1 tot 8 seconden (AVM en parcel zijn het traagst; meerdere percelen 3 tot 12 seconden); stel uw client-timeout in op minstens 60 seconden.

Query-parameters

Voorbeeld-request

GET /api/v1/partner/address?address=Doorniksestraat%2040%2C%208500%20Kortrijk&sections=basic,avm&type=apartment&living_area_m2=95 HTTP/1.1
Host: taxonapi.be
X-Api-Key: tx_live_<32 hex>
X-User-Ref: office-kortrijk-03
X-Case-Ref: DOS-2026-0452
Idempotency-Key: 2c6a8b1e-3f4d-4a5b-9c7e-1d2f3a4b5c6d
Accept-Language: en

Voorbeeld-response (200)

Live antwoord van 08-09-2026 (live-sleutel, gebruiker office-kortrijk-03, aanvraag cf514c7de2714c11806e2ebf053d0247), ingekort tot één referentiepunt per blok en drie voorzieningen; het blok price_map (deel van het basispakket) is hier weggelaten, zie sectie 5. Met een live-sleutel is environment gelijk aan live, is charged gelijk aan true en is free_reason gelijk aan null; de bedragen in billing.price zijn die van de overeenkomst van de klant waarmee het antwoord gevangen is, de uwe volgen uw eigen overeenkomst. Met een testsleutel is environment gelijk aan test, is charged gelijk aan false, is free_reason gelijk aan test en is elk bedrag 0.00.

{
  "request_id": "cf514c7de2714c11806e2ebf053d0247",
  "environment": "live",
  "address": {
    "input": "Doorniksestraat 40, 8500 Kortrijk",
    "normalized": "Doorniksestraat 40, 8500 Kortrijk",
    "box": null,
    "postal_code": "8500",
    "municipality": "Kortrijk",
    "lat": 50.82541,
    "lon": 3.267149,
    "region": "VL",
    "nis_code": "34022",
    "geocoder": "geo.api.vlaanderen.be",
    "geocode_score": 0.95,
    "precision": "house_number"
  },
  "sections_delivered": ["basic", "parcel", "avm", "price_map"],
  "basic": {
    "comparables": [
      {
        "type": "apartment",
        "type_label": "apartment",
        "transaction": "sale",
        "transaction_label": "for sale",
        "address_mode": "house_number",
        "radius_m": 1000,
        "count": 25,
        "excluded_subject_property": 0,
        "max_age_months": 24,
        "items": [
          {
            "ref": "r_1a30b3b90e",
            "address": "Schouwburgplein 10, 8500 Kortrijk",
            "distance_m": 157,
            "type": "apartment",
            "transaction": "sale",
            "price": 250000,
            "price_kind": "asking_price",
            "price_kind_label": "asking price",
            "price_per_m2": 2427,
            "living_area_m2": 103,
            "plot_area_m2": null,
            "bedrooms": 2,
            "epc_label": "B",
            "epc_kwh_m2": 108.0,
            "epc_source": "as advertised",
            "year_built": 1980,
            "condition": "good condition",
            "building_type": "terraced",
            "new_build": false,
            "published": "2026-07-16",
            "days_online": 12,
            "last_seen": "2026-07-28",
            "status": "offline",
            "status_label": "offline",
            "source": "listing",
            "source_label": "listing",
            "features": {
              "garage": true,
              "parking_spaces": 1,
              "terrace": true,
              "terrace_m2": null,
              "garden": null,
              "garden_m2": null,
              "cellar": true,
              "attic": null,
              "floor": 2,
              "floors_count": 5,
              "elevator": false,
              "kitchen": "semi_equipped",
              "bathrooms": 1,
              "shower_rooms": null,
              "toilets": 1,
              "heating": "gas",
              "solar_panels": false,
              "double_glazing": true,
              "orientation_garden": null,
              "renovation_year": null,
              "inspections": {"electrical_compliant": null, "asbestos_certificate": null, "oil_tank": null},
              "flood_zone": "none"
            },
            "summary": "Apartment on the 2nd floor of 103 m² with garage, terrace and cellar, 2 bedrooms, EPC B, built in 1980.",
            "thumbnail": {"url": "https://taxonapi.be/api/v1/marketexplorer/foto/<token>?w=160", "valid_until": "2026-09-08T09:39:16Z"},
            "photo_count": 12,
            "history": [
              {"date": "2026-04-29", "price": 250000, "event": "published", "label": "published"},
              {"date": "2026-07-28", "price": null, "event": "offline", "label": "offline"}
            ],
            "photos": [
              {"url": "https://taxonapi.be/api/v1/marketexplorer/foto/<token>?w=640", "download_token": "b71c6e8f1c51a562f33d", "valid_until": "2026-09-08T09:39:16Z"},
              {"url": "https://taxonapi.be/api/v1/marketexplorer/foto/<token>?w=640", "download_token": "4bdfcfbd9ea0c282e886", "valid_until": "2026-09-08T09:39:16Z"}
            ]
          }
        ]
      },
      {
        "type": "apartment",
        "type_label": "apartment",
        "transaction": "rent",
        "transaction_label": "for rent",
        "address_mode": "house_number",
        "radius_m": 1000,
        "count": 25,
        "excluded_subject_property": 0,
        "max_age_months": 24,
        "items": ["…"]
      }
    ],
    "neighbourhood": {
      "sector": {"code": "34022A00-", "name": "KORTRIJK-CENTRUM", "level": "sector", "municipality": "Kortrijk"},
      "building_stock": {
        "level": "sector",
        "reference_date": "2026-01-01",
        "total": 2882,
        "distribution": [
          {"category": "residential", "label": "Residential", "count": 1908, "pct": 66.2},
          {"category": "commerce_services", "label": "Commerce & services", "count": 383, "pct": 13.3},
          {"category": "industry", "label": "Industry", "count": 7, "pct": 0.2},
          {"category": "agriculture", "label": "Agriculture", "count": 0, "pct": 0.0},
          {"category": "other", "label": "Other", "count": 584, "pct": 20.3}
        ],
        "source": "FPS Finance - open patrimonial data"
      },
      "price_level": {
        "type": "apartment",
        "radius_m": 2000,
        "sale_per_m2": {"n": 430, "p25": 2260.25, "median": 2856.5, "p75": 3747.0},
        "rent_per_m2_year": {"n": 346, "p25": 89.12, "median": 105.85, "p75": 126.7},
        "gross_yield_pct": 3.71,
        "gross_yield_p25_p75": [3.12, 4.44],
        "price_kind": "asking_price"
      },
      "epc_prices": {
        "type": "apartment",
        "radius_m": 5000,
        "labels": {
          "B": {"median_per_m2": 2578.1, "count": 132},
          "C": {"median_per_m2": 2441.6, "count": 56},
          "A": {"median_per_m2": 3849.2, "count": 83},
          "D": {"median_per_m2": 2208.5, "count": 16},
          "F": {"median_per_m2": 1645.3, "count": 10},
          "A+": {"median_per_m2": 5432.6, "count": 6},
          "E": {"median_per_m2": 2521.7, "count": 4}
        },
        "price_kind": "asking_price"
      },
      "safety": {
        "level": "municipality",
        "municipality": "Kortrijk",
        "year": 2025,
        "burglaries_per_1000": 2.7,
        "crimes_per_1000": 89.0,
        "region_burglaries_per_1000": 2.1,
        "region_crimes_per_1000": 63.3,
        "years": [
          {"year": 2025, "burglaries_per_1000": 2.7, "crimes_per_1000": 89.0},
          {"year": 2024, "burglaries_per_1000": 3.2, "crimes_per_1000": 100.1},
          {"year": 2023, "burglaries_per_1000": 3.3, "crimes_per_1000": 101.9}
        ],
        "source": "Federal Police - Police Crime Statistics (PCS)"
      }
    },
    "amenities": {
      "score": 9.3,
      "scale": "0-10",
      "radius_m": 1000,
      "sub_scores": {
        "public_transport": {"score": 9.2, "label": "Public transport", "count": 17},
        "healthcare": {"score": 9.2, "label": "Healthcare", "count": 7},
        "shops": {"score": 9.8, "label": "Shops and catering", "count": 87},
        "sport_culture": {"score": 9.3, "label": "Sport and culture", "count": 12},
        "education": {"score": 8.9, "label": "Education", "count": 9}
      },
      "poi_count": 158,
      "top_10": [
        {"name": "Muskat Pureebar", "type": "shops", "type_label": "Shops and catering", "distance_m": 52},
        {"name": "KBC", "type": "shops", "type_label": "Shops and catering", "distance_m": 66},
        {"name": "Vork", "type": "shops", "type_label": "Shops and catering", "distance_m": 79}
      ],
      "attribution": "© OpenStreetMap contributors (ODbL)"
    }
  },
  "parcel": {
    "capakey": "34022G0494/00E000",
    "region": "VL",
    "area_m2": 259.14,
    "cadastral_area_m2": 259.14,
    "width_m": 4.79,
    "depth_m": 53.61,
    "frontage_m": 7.31,
    "built_area_m2": 164.1,
    "buildings_count": 2,
    "garden_orientation": "SW",
    "garden_orientation_deg": 247,
    "zoning": {"category": "residential", "label": "woongebieden", "plan": "gewestplan"},
    "preemption_right": {"status": "none", "source": "RVV thematic layer, right of pre-emption (Flanders)"},
    "source": "CadGIS (FPS Finance) / GRB Gbg - building at ground level (Digitaal Vlaanderen)",
    "main_parcel": "34022G0494/00E000",
    "parcels": [
      {
        "capakey": "34022G0494/00E000",
        "area_m2": 259.14,
        "cadastral_area_m2": 259.14,
        "width_m": 4.79,
        "depth_m": 53.61,
        "built_area_m2": 164.1,
        "buildings_count": 2,
        "zoning": {"category": "residential", "label": "woongebieden", "plan": "gewestplan"},
        "preemption_right": {"status": "none", "source": "RVV thematic layer, right of pre-emption (Flanders)"},
        "source": "CadGIS (FPS Finance) / GRB Gbg - building at ground level (Digitaal Vlaanderen)",
        "is_main": true,
        "distance_to_address_m": 0
      }
    ],
    "parcels_count": 1,
    "total_area_m2": 259.14,
    "cadastral_total_area_m2": 259.14,
    "zoning_combined": {"category": "residential", "label": "woongebieden", "plan": "gewestplan"},
    "preemption_right_combined": {"status": "none", "parcels": []},
    "parcels_not_found": [],
    "plot_area_source": "cadastre_main_parcel",
    "parcel_candidates": [
      {"capakey": "34022G0495/00C000", "area_m2": 370.75, "direction": "S", "built": true, "distance_m": 7},
      {"capakey": "34022G0493/00L000", "area_m2": 1224.37, "direction": "W", "built": true, "distance_m": 12},
      {"capakey": "34022G0490/00C000", "area_m2": 249.56, "direction": "W", "built": true, "distance_m": 32}
    ],
    "parcel_candidates_source": "CadGIS (FPS Finance), adjacent within 0.5 m; built-up via the regional buildings layer",
    "parcel_candidates_remark": null
  },
  "avm": {
    "value": 243995,
    "range": [190804, 312014],
    "range_90": [162820, 365641],
    "rental_value": 885,
    "rental_value_range": [859, 954],
    "confidence": {"score": 72.7, "label": "low", "fsd_pct": 24.59},
    "comparables_count": 19,
    "comparables_count_500m": 19,
    "comparables_count_1km": 19,
    "inputs_used": {
      "type": "apartment",
      "living_area_m2": 95.0,
      "year_built": null,
      "epc_label": null,
      "condition": null,
      "bedrooms": null,
      "plot_area_m2": null,
      "plot_area_source": null
    },
    "price_basis": "asking_price_model",
    "model": "taxon-avm v3.1"
  },
  "billing": {
    "user_ref": "office-kortrijk-03",
    "case_ref": "DOS-2026-0452",
    "charged": true,
    "pilot": false,
    "free_reason": null,
    "price": {"package": 3.0, "avm": 2.0, "total": 5.0, "currency": "EUR", "excl_vat": true},
    "dedup_of": null,
    "dedup_valid_until": "2026-10-08T10:39:24+02:00",
    "month": "2026-09",
    "month_to_date": {"cases": 3, "amount": 10.0},
    "pilot_status": null,
    "today": {"client_today": 13, "user_today": 1}
  },
  "notices": [],
  "upstream_errors": {},
  "attribution": "References: Taxon (taxon.be)",
  "disclaimer": "Asking prices from listings, not notarial sale prices. Data for internal use per case only; building a derived database is prohibited. The valuer decides, the AVM is a support tool.",
  "generated_at": "2026-09-08T10:39:24+02:00"
}

5.Secties

Basispakket en AVM-optie (2.4.0). De secties basic, parcel en price_map vormen één basispakket per dossier: sections=basic levert de drie samen tegen één prijs (billing.price.package). De AVM is een aparte optie (sections=basic,avm, billing.price.avm). sections_delivered blijft de echte secties opsommen.

Bron van de perceelgegevens (2.4.2). De sectie parcel leest het actuele kadastraal percelenplan van de FOD Financiën (CadGIS PlanParcellaire, lopende fiscale toestand, vandaag 01-01-2027). De jaarlijkse INSPIRE-momentopname (01-01-2026) is enkel nog de terugval bij een storing of een leeg antwoord. Het veld fiscal_situation (op parcel, op elk item van parcels[] en op elk item van parcel_candidates[]) geeft de ISO-datum van de fiscale toestand waaruit het perceel komt; source vermeldt de laag. De datum is de fiscale toestand sinds dewelke de huidige versie van dit perceel geldt: een perceel dat al jaren ongewijzigd is, draagt een oudere datum (bv. 2019-01-01), terwijl het plan waaruit het gelezen wordt altijd de lopende fiscale toestand is. Een oudere datum betekent dus geen verouderde data; enkel 2026-01-01 samen met een INSPIRE-source wijst op de jaarlijkse momentopname als terugval. Een perceel dat na de laatste momentopname gesplitst of samengevoegd werd (bv. 45043C0460/00R000 in Kluisbergen: één perceel van 921 m² in de momentopname, 460R 392 m² + 460X 529 m² in het actuele plan) komt dus in zijn huidige vorm binnen.

Meerdere percelen per pand: eerst kandidaten, dan capakeys

Een rijwoning met een aparte garage of een tuinperceel, een hoeve met weiden, een villa op twee kadastrale percelen: het puntperceel op het adres is dan maar een deel van het pand. De API lost dit op in twee stappen.

• Stap 1: opvragen zonder capakeys. De parcel-sectie bevat het puntperceel (main_parcel, parcels[] met 1 item) en parcel_candidates[]: de aangrenzende percelen (maximaal 12), elk met capakey, kadastrale area_m2, direction ten opzichte van het hoofdperceel (altijd N, E, S of W, taalonafhankelijk), built (gewestelijke gebouwenlaag; null wanneer die laag niet beschikbaar was) en distance_m tussen de zwaartepunten. Enkel kadastrale basisinfo, geen eigenaarsgegevens. Toon die lijst aan de gebruiker (bijvoorbeeld "33011I0172/00G000, 40 m², zuid, bebouwd" = de garage) en laat hem aanvinken wat bij het pand hoort.
• Stap 2: opnieuw opvragen met capakeys (het hoofdperceel plus de aangevinkte percelen, kommagescheiden, maximaal 10). De sectie levert dan parcels[] (per perceel capakey, oppervlakte uit geometrie en kadaster, breedte/diepte, bebouwde oppervlakte, aantal gebouwen, planologische bestemming, voorkooprecht, distance_to_address_m, is_main) en de totalen total_area_m2, cadastral_total_area_m2, zoning_combined (één object wanneer alle percelen gelijk zijn, anders een lijst met parcels[] per bestemming), preemption_right_combined (yes zodra één perceel in een perimeter valt, met de betrokken capakeys), main_parcel (het perceel waarop het adres valt, anders het eerste, met melding main_parcel_not_in_capakeys) en parcels_not_found[]. De velden op sectieniveau blijven die van het hoofdperceel. De AVM (type house) gebruikt total_area_m2; avm.inputs_used.plot_area_source zegt cadastre_main_parcel, cadastre_<n>_parcels (n = aantal geleverde percelen, 2 tot 10) of partner; het sectieveld parcel.plot_area_source draagt enkel de twee kadasterwaarden. Voor een appartement gaat geen grondoppervlakte naar het model (ook niet met capakeys).
• Dedup. Zelfde gebruiker, zelfde adres: het in stap 1 geleverde basispakket wordt niet opnieuw aangerekend (melding dedup met section: basic; billing.free_reason is enkel dedup wanneer niets nieuws geleverd wordt, anders null (aangerekend), test of pilot), ook al wordt de parcel-sectie met de nieuwe percelen opnieuw opgebouwd. Voegt u in stap 2 de AVM-optie toe, dan betaalt u enkel die optie. Dezelfde capakeys opnieuw binnen 30 dagen = antwoord uit het grootboek (from_cache: true). Dezelfde Idempotency-Key met andere capakeys = 409 idempotency_conflict. parcel_candidates, parcel_candidates_source en parcel_candidates_remark zijn altijd aanwezig en null wanneer capakeys meegegeven werd. Een koude perceelanalyse kan tot 21 s duren; bij upstream_errors.parcel: timeout (melding section_missing; het basispakket wordt één keer aangerekend, de herhaling is gratis binnen het dedup-venster) vraagt u na enkele seconden opnieuw op met een nieuwe Idempotency-Key.
• Foutpaden. 422 capakey_invalid (verkeerde vorm of meer dan 10 sleutels; details[] noemt de foute delen); 422 capakey_too_far (een perceel verder dan 2 km van het adres; niets geleverd of aangerekend). De parcel-sectie zit in het basispakket, dus capakeys vereist geen extra sectie. Een capakey die niet in het percelenplan bestaat: melding capakey_not_found (sectie parcel) en parcels_not_found[]; de andere percelen worden geleverd. Faalt de perceelanalyse voor één perceel, dan telt enkel zijn kadastrale oppervlakte (melding parcel_analysis_incomplete).
• Belasting. Beperk u tot de percelen van het dossier. Elke aanvraag met capakeys doet één kadasterbevraging plus één perceelanalyse per perceel (tot 10); een hoeve met 3 percelen duurt 3 tot 12 s.

Uitgewerkt voorbeeld met echte antwoorden (Rijselstraat 62, Ieper): integratiegids, sectie 3.

Gronden (type=land) 2.5.0

type=land (aliassen grond, terrain, bouwgrond) vraagt de bundel voor een bouwgrond. Wat verandert tegenover een huis of appartement:

• Referentiepunten: één blok (type: land, transaction: sale, geen huurblok) met grondzoekertjes te koop (bouwgronden, projectgronden en gronden zonder nader subtype; landbouwgrond, weiden, bos, boomgaarden, industrie- en KMO-grond, staanplaatsen, garages en recreatiegrond worden op basis van het geadverteerde subtype uitgesloten), van alle publicatiejaren (2.5.1: geen leeftijdsgrens meer, zodat u de vraagprijzen van oudere zoekertjes binnen het dossier kunt aanpassen aan de marktevolutie (prijsindexering); de licentievoorwaarden blijven gelden: niet samenvoegen, indexeren of opslaan over dossiers heen), binnen 5 km van het adres; bij minder dan 10 in totaal wordt de straal eenmaal uitgebreid tot 10 km (radius_m). Rangorde: eerst de zoekertjes van de laatste 24 maanden (op afstand), daarna de oudere (op afstand), maximaal 25 per blok; elk item draagt age_months (hele kalendermaanden tussen published en vandaag) en het blokveld max_age_months is null voor grond. Nog altijd minder dan 10: blokveld low_sample: true en melding low_sample (sectie basic). Elk item draagt de gebruikelijke velden waar ze zinvol zijn (address, distance_m, price, price_kind, source, published, status, history, photos, thumbnail, photo_count) plus plot_area_m2 en price_per_m2_plot (vraagprijs per m² grond); de woningvelden (living_area_m2, price_per_m2, bedrooms, epc_label, year_built, condition, building_type, new_build) zijn null. features is beperkt tot {plot_area_m2, zoning, flood_zone, land_type} (zoning is momenteel altijd null: de bestemming van een zoekertje wordt niet opgezocht; die van het perceel van het pand staat in parcel.zoning; land_type is building_plot, project_land of other en bepaalt het eerste woord van summary: "Bouwgrond", "Projectgrond" of "Grond"). summary luidt bijvoorbeeld "Bouwgrond van 694 m² in Kluisbergen, aangeboden sinds 10-09-2026."
• Buurt: land_price_level (zie hierboven) uit dezelfde grondzoekertjes (zelfde uitsluitingen) van de laatste 24 maanden; een prijsniveau moet actueel zijn: bij minder dan 10 bruikbare zoekertjes binnen 24 maanden wordt het venster verruimd tot 60 maanden en zegt max_age_months welk venster gebruikt is (24 of 60; 2.5.1); enkel zoekertjes met een grondoppervlakte en een vraagprijs tussen 15 en 5.000 EUR per m² grond tellen mee in de kwartielen (count), zodat landbouwgrond die als bouwbaar geadverteerd staat en plaatshouder-oppervlakten het niveau niet vertekenen (items buiten die band blijven in de lijst met hun eigen price_per_m2_plot); price_level en epc_prices zijn null met melding housing_stats_not_available_for_land; building_stock, safety en amenities zoals gewoonlijk.
• Geen AVM: Taxon levert voor grond geen automatische waardebepaling en geen indicatieve grondwaarde. sections=basic,avm blijft HTTP 200: avm is null en staat niet in sections_delivered, melding {code: avm_not_available_for_land, section: avm}, de AVM-optie wordt niet aangerekend. living_area_m2 mag ontbreken.
• Perceel en prijskaart: ongewijzigd. De perceelsectie (bestemming, voorkooprecht, meerdere percelen via capakeys) is voor grond de kern; price_map blijft de woningkaart (vraagprijzen per m² van huizen en appartementen per wijk), geen grondprijskaart.
• Facturatie: het basispakket zoals gewoonlijk (één prijs per dossier, dedup 30 dagen, pilot en testsleutel zoals bij huizen); geen AVM-optie.

Dekking (15-09-2026, zoekertjes van de laatste 24 maanden met een prijs; op 16-09-2026 over alle publicatiejaren ongeveer 73.000 grondzoekertjes, waarvan ongeveer 38.200 binnen 24 maanden): Vlaanderen ongeveer 30.800 grondzoekertjes, Wallonië ongeveer 8.300, Brussel ongeveer 330; ongeveer 95 % draagt een grondoppervlakte. Sommige landelijke Waalse gemeenten hebben weinig grondzoekertjes (dan low_sample).

Voorbeeld: echt antwoord van 15-09-2026 met een testsleutel (Accept-Language: en, aanvraag f0c372798b3f285b66ab4b584819be57; de 2.5.1-velden age_months en max_age_months: null toegevoegd), ingekort tot één referentiepunt met één foto, de hoofdvelden van het perceel en de buurtblokken die voor grond veranderen; building_stock, safety, amenities, parcels, parcel_candidates en price_map zijn vervangen door "...":

{
  "request_id": "f0c372798b3f285b66ab4b584819be57",
  "environment": "test",
  "address": {
    "input": "Buissestraat 17, 9690 Kluisbergen",
    "normalized": "Buissestraat 17, 9690 Kluisbergen",
    "box": null,
    "postal_code": "9690",
    "municipality": "Kluisbergen",
    "lat": 50.76716,
    "lon": 3.484313,
    "region": "VL",
    "nis_code": "45060",
    "geocoder": "geo.api.vlaanderen.be",
    "geocode_score": 0.95,
    "precision": "house_number"
  },
  "sections_delivered": [
    "basic",
    "parcel",
    "price_map"
  ],
  "basic": {
    "comparables": [
      {
        "type": "land",
        "type_label": "land",
        "transaction": "sale",
        "transaction_label": "for sale",
        "address_mode": "house_number",
        "radius_m": 5000,
        "count": 25,
        "excluded_subject_property": 0,
        "max_age_months": null,
        "low_sample": false,
        "items": [
          {
            "ref": "r_9965f5493e",
            "address": "Buissestraat 19, 9690 Kluisbergen",
            "distance_m": 25,
            "type": "land",
            "transaction": "sale",
            "price": 80000,
            "price_kind": "asking_price",
            "price_kind_label": "asking price",
            "price_per_m2": null,
            "price_per_m2_plot": 115,
            "living_area_m2": null,
            "plot_area_m2": 694,
            "bedrooms": null,
            "epc_label": null,
            "epc_kwh_m2": null,
            "epc_source": null,
            "year_built": null,
            "condition": null,
            "building_type": null,
            "new_build": null,
            "published": "2026-09-10",
            "days_online": 4,
            "last_seen": "2026-09-14",
            "age_months": 0,
            "status": "online",
            "status_label": "online",
            "source": "listing",
            "source_label": "listing",
            "features": {
              "plot_area_m2": 694,
              "zoning": null,
              "flood_zone": null,
              "land_type": "building_plot"
            },
            "summary": "Building plot of 694 m² in Kluisbergen, listed since 10-09-2026.",
            "thumbnail": {
              "url": "https://taxonapi.be/api/v1/marketexplorer/foto/fp_WzI3NDc1OTEsIjAxYTA0NzM2LTE5OGUtN2Q3ZC1iZjNjLWYyZDQ2NzliOTI3ZSIsMTc4OTQ2MzYyNiwicCJd.QB9ILrzzIwQxlyOV?w=160",
              "valid_until": "2026-09-15T09:13:46Z"
            },
            "photo_count": 13,
            "history": [
              {
                "date": "2026-08-28",
                "price": 80000,
                "event": "published",
                "label": "published"
              }
            ],
            "photos": [
              {
                "url": "https://taxonapi.be/api/v1/marketexplorer/foto/fp_WzI3NDc1OTEsIjAxYTA0NzM2LTE5OGUtN2Q3ZC1iZjNjLWYyZDQ2NzliOTI3ZSIsMTc4OTQ2MzYyNiwicCJd.QB9ILrzzIwQxlyOV?w=640",
                "download_token": "b17f02c8feb98b013e60",
                "valid_until": "2026-09-15T09:13:46Z"
              }
            ]
          }
        ]
      }
    ],
    "neighbourhood": {
      "sector": {
        "code": "45060A010",
        "name": "BUISESTRAAT",
        "level": "sector",
        "municipality": "Kluisbergen"
      },
      "building_stock": "...",
      "price_level": null,
      "epc_prices": null,
      "safety": "...",
      "land_price_level": {
        "radius_m": 5000,
        "count": 116,
        "price_per_m2_plot": {
          "p25": 126,
          "median": 160,
          "p75": 224
        },
        "price_kind": "asking_price",
        "max_age_months": 24
      }
    },
    "amenities": "..."
  },
  "parcel": {
    "capakey": "45043C0460/00X000",
    "region": "VL",
    "area_m2": 528.79,
    "cadastral_area_m2": 528.78,
    "fiscal_situation": "2027-01-01",
    "zoning": {
      "category": "residential",
      "label": "woongebieden",
      "plan": "gewestplan"
    },
    "preemption_right": {
      "status": "none",
      "source": "RVV thematic layer, right of pre-emption (Flanders)"
    },
    "source": "CadGIS PlanParcellaire (FPS Finance) / GRB Gbg - building at ground level (Digitaal Vlaanderen)",
    "main_parcel": "45043C0460/00X000",
    "parcels_count": 1,
    "total_area_m2": 528.79,
    "plot_area_source": "cadastre_main_parcel",
    "parcels": "...",
    "parcel_candidates": "..."
  },
  "avm": null,
  "price_map": "...",
  "billing": {
    "user_ref": "office-oudenaarde-02",
    "case_ref": "DOS-2026-0518",
    "charged": false,
    "pilot": false,
    "free_reason": "test",
    "price": {
      "package": 0.0,
      "avm": 0.0,
      "total": 0.0,
      "currency": "EUR",
      "excl_vat": true
    },
    "dedup_of": null,
    "dedup_valid_until": "2026-10-15T10:13:47+02:00",
    "month": "2026-09",
    "month_to_date": {
      "cases": 0,
      "amount": 0.0
    },
    "pilot_status": {
      "active": true,
      "quota": 200,
      "used": 0,
      "remaining": 200,
      "ends": "2026-11-03",
      "expired": false
    },
    "today": {
      "client_today": 10,
      "user_today": 1
    }
  },
  "notices": [
    {
      "code": "avm_not_available_for_land",
      "section": "avm",
      "message": "AVM not delivered: Taxon does not provide an automated valuation for land (type land); not charged."
    },
    {
      "code": "housing_stats_not_available_for_land",
      "section": "basic",
      "message": "price_level and epc_prices are housing statistics and are not delivered for land; see neighbourhood.land_price_level."
    },
    {
      "code": "price_map_sparse",
      "section": "price_map",
      "message": "price map: fewer than 30 listings in the subject neighbourhood (small sample)."
    },
    {
      "code": "test_environment",
      "section": null,
      "message": "test key: not invoiced"
    }
  ],
  "upstream_errors": {},
  "attribution": "References: Taxon (taxon.be)",
  "disclaimer": "Asking prices from listings, not notarial sale prices. Data for internal use per case only; building a derived database is prohibited. The valuer decides, the AVM is a support tool.",
  "generated_at": "2026-09-15T10:13:47+02:00"
}

Prijskaart (sectie price_map) 2.0

Vraagprijsniveaus per buurt binnen radius_m (3.000 m) rond het adres, gesorteerd op afstand, maximaal 40 buurten (de buurt van het pand altijd inbegrepen), geleverd als data plus GeoJSON-geometrie. Taxon levert geen kaartbeelden of tegels: u tekent de polygonen zelf met uw eigen kaartbibliotheek en -licentie (bijvoorbeeld Leaflet, MapLibre of Mapbox) en kleurt ze op price_per_m2_house of price_per_m2_apartment. Zit sinds 2.4.0 in het basispakket: geen aparte prijs (de pakketprijs staat in billing.price.package); dedup volgt het pakket. Blokgrootte 20 tot 50 KB; warm antwoord onder 0,5 s, de eerste aanvraag na een herstart van de dienst kan tot 20 s duren. Live gemeten op 07-09-2026: Eigenbrakel 40 buurten, Ieper 38, Schaarbeek 40.

Melding price_map_sparse (sectie price_map) wanneer de buurt van het pand zelf minder dan 30 advertenties heeft; de sectie wordt wel geleverd. Ligt er binnen 3 km geen enkele buurt met prijzen, dan is de sectie null, wordt de melding price_map_unavailable toegevoegd, is upstream_errors.price_map gelijk aan no_coverage; dat is geen storing en het basispakket blijft aangerekend. Bewaar de geometrie niet buiten het dossier (gebruiksregels, sectie 11). Echt voorbeeld: live antwoord van 08-09-2026 (live-sleutel, sections=basic, Grote Markt 34, 8900 Ieper, aanvraag f5569dd2c231469abaa2536b1bc4dd61), 2 van de 38 buurten, geometrie van de buurt van het pand volledig:

"price_map": {
  "radius_m": 3000,
  "price_kind": "asking_price",
  "reference_period": "2026-03-30",
  "updated_at": "2026-07-09T10:26:08+00:00",
  "subject_neighbourhood": "7220",
  "source": "Taxon asking prices (advertised prices, not notarial sale prices)",
  "neighbourhoods": [
    {
      "id": "7220",
      "name": "Ieper-Centrum",
      "municipality": "Ieper",
      "postal_code": "8900",
      "distance_m": 0,
      "is_subject": true,
      "price_per_m2_house": 1937.91,
      "price_per_m2_apartment": 2693.77,
      "listings_count_house": 76,
      "listings_count_apartment": 59,
      "low_sample": false,
      "geometry": {
        "type": "Polygon",
        "coordinates": [[[2.89239, 50.84819], [2.89082, 50.84804], [2.88999, 50.84756], [2.88856, 50.84716], [2.88727, 50.84885], [2.88559, 50.84838], [2.88386, 50.84823], [2.88343, 50.84899], [2.88207, 50.8487], [2.88188, 50.84888], [2.88017, 50.8484], [2.87996, 50.84875], [2.87954, 50.84865], [2.87908, 50.84969], [2.87869, 50.84955], [2.87772, 50.85146], [2.88352, 50.85238], [2.88367, 50.85225], [2.88646, 50.85268], [2.88857, 50.85268], [2.89005, 50.85297], [2.89134, 50.853], [2.89214, 50.85059], [2.89239, 50.84819]]]
      }
    },
    {
      "id": "7226",
      "name": "Diksmuidse Poort",
      "municipality": "Ieper",
      "postal_code": "8900",
      "distance_m": 121,
      "is_subject": false,
      "price_per_m2_house": 1991.52,
      "price_per_m2_apartment": 2374.19,
      "listings_count_house": 41,
      "listings_count_apartment": 22,
      "low_sample": false,
      "geometry": {"type": "Polygon", "coordinates": ["…"]}
    }
  ]
}

Per gewest

De watertoets komt in een latere versie als extra veld in de parcel-sectie. Tot dan raadpleegt de schatter de overstromingsgegevens bij het gewest; de API doet er geen uitspraak over.

6.Dedup (gratis herhaling) en Idempotency-Key

De aanrekening gebeurt per gebruiker + pand. Het pand wordt bepaald door de geocode (afgerond op ongeveer 1 m), niet door de letterlijke spelling van het adres. Een aangerekende aanvraag blijft 30 dagen geldig voor dezelfde gebruiker. Een pand is het gegeocodeerde punt plus het busnummer; een ander type, andere AVM-parameters, andere capakeys of een andere taal maken geen ander pand: zo'n herhaling wordt met de nieuwe invoer opnieuw opgebouwd en blijft gratis voor de al geleverde secties (dedup bevriest niets).

Let op de waakhond: draagt één X-User-Ref een onnatuurlijk groot deel van het verkeer, of vertoont een gebruiker een raster-scanpatroon (opeenvolgende huisnummers of postcodes in korte tijd), dan wordt die gebruiker geschorst (403 user_suspended); de andere gebruikers blijven werken. De schorsing treft de gebruiker, niet de klant (uw sleutel); pas bij drie of meer geschorste gebruikers binnen 24 uur volgt 403 client_suspended. Gebruik dus altijd de echte gebruiker-id.

7.Plafonds en foutcodes

Plafonds

Elk 200-antwoord toont de dagstand in billing.today (client_today, user_today), zodat u een plafond kunt zien aankomen. Dedup-herhalingen tellen ook als verkeer.

Retry-advies. Bij 429: wacht de Retry-After af (of retry_after uit de body wanneer de header ontbreekt, de nginx-variant) en probeer opnieuw met dezelfde Idempotency-Key. Bij 502, 503, 504 of 500: maximaal 3 pogingen met exponentiële wachttijd (2, 4, 8 s; bij 503 de waarde van Retry-After), zelfde Idempotency-Key. Bij 403 quota_exceeded: wacht de Retry-After (tot middernacht) af. Bij andere 4xx: niet herhalen, de aanvraag zelf is fout.

Foutcodes

Uniforme foutbody: {"error": "...", "message": "...", "request_id": "...", "charged": false}, eventueel aangevuld met details[] ({field, issue}), retry_after, scope en limit, section, user_ref, reason, since of pilot. message volgt Accept-Language.

Een fout wordt nooit aangerekend (charged: false).

8.GET /usage

Uw eigen gebruik per kalendermaand: totaal, per gebruiker, per API-sleutel (2.4.1), per dag, per sectie en een kwaliteitsblok (foutpercentage, latentie p50/p95, aantal aanvragen met upstream-storingen). requests telt alle aanvragen, cases de aanvragen met HTTP 200, charged die met een prijs; sections telt aangerekende eenheden met de sleutels package (basispakket) en avm (AVM-optie); sections_delivered (sinds 2.4.0 ook in total) telt de vier echte secties basic, parcel, avm, price_map; per_section gebruikt package en avm. Bedoeld om zelf te controleren wat Taxon factureert en om door te factureren aan uw gebruikers. X-User-Ref is hier optioneel en werkt als filter. Het blok plan toont uw plan zonder prijzen: sections_allowed, max_per_minute, max_per_day, max_per_user_per_day, test_max_per_day, dedup_days, idempotency_hours, address_mode. requests telt dezelfde aanvragen als de dagplafonds (zie 7).

Onbekende parameters (ook de 1.x-namen maand, formaat, gebruiker_ref) geven 400 invalid_request met details[].field. Live antwoord van 08-09-2026 (live-sleutel, twee gebruikers, twee sleutels, vier aanvragen; de klantcode is vervangen door een plaatshouder):

GET /api/v1/partner/usage?month=2026-09 HTTP/1.1
X-Api-Key: tx_live_<32 hex>

{
  "client": "<client code>",
  "month": "2026-09",
  "environment": "live",
  "user_ref": null,
  "total": {
    "requests": 4,
    "cases": 4,
    "charged": 4,
    "free_dedup": 0,
    "free_pilot": 0,
    "free_error": 0,
    "sections": {"package": 3, "avm": 2},
    "sections_delivered": {"basic": 4, "parcel": 4, "avm": 2, "price_map": 4},
    "amount": 13.0,
    "currency": "EUR",
    "excl_vat": true,
    "duration_ms_avg": 3531
  },
  "per_user": [
    {
      "user_ref": "office-kortrijk-03",
      "requests": 2,
      "cases": 2,
      "charged": 2,
      "free_dedup": 0,
      "sections": {"package": 2, "avm": 1},
      "sections_delivered": {"basic": 2, "parcel": 2, "avm": 1, "price_map": 2},
      "amount": 8.0,
      "last_activity": "2026-09-08T10:39:27+02:00"
    },
    {
      "user_ref": "office-ieper-01",
      "requests": 2,
      "cases": 2,
      "charged": 2,
      "free_dedup": 0,
      "sections": {"package": 1, "avm": 1},
      "sections_delivered": {"basic": 2, "parcel": 2, "avm": 1, "price_map": 2},
      "amount": 5.0,
      "last_activity": "2026-09-08T10:39:16+02:00"
    }
  ],
  "per_day": [{"day": "2026-09-08", "requests": 4, "cases": 4, "charged": 4, "amount": 13.0}],
  "per_section": {"package": {"delivered": 4, "charged": 3, "amount": 9.0}, "avm": {"delivered": 2, "charged": 2, "amount": 4.0}},
  "quality": {"error_pct": 0.0, "latency_p50_ms": 3065, "latency_p95_ms": 7531, "upstream_errors": 0},
  "pilot": null,
  "generated_at": "2026-09-08T10:39:27+02:00",
  "plan": {
    "sections_allowed": ["basic", "parcel", "avm", "price_map"],
    "max_per_minute": 30,
    "max_per_day": 300,
    "max_per_user_per_day": 80,
    "test_max_per_day": 80,
    "dedup_days": 30,
    "idempotency_hours": 24,
    "address_mode": null
  },
  "request_id": "c535faa3301644c1af51f3901fea7e2c"
}

Het blok pilot (en billing.pilot_status) is enkel de pilotteller. De klantstatus uit het grootboek (pilot, actief, geschorst, beëindigd) wordt niet in het antwoord geleverd; een schorsing merkt u aan 403 client_suspended of 403 user_suspended. Met een live sleutel dragen sections en charged de aangerekende aantallen en amount de bedragen volgens uw overeenkomst.

Per API-sleutel 2.4.1

Sinds 2.4.1 draagt het antwoord ook het blok per_key (tussen per_user en per_day): het gebruik per API-sleutel, met dezelfde filters als de rest van het antwoord (maand, de omgeving van de aanroepende sleutel, user_ref). Per sleutel: prefix (de eerste 12 tekens, zoals in uw sleutellijst), label (null als leeg), environment, active, revoked_at (null zolang actief), requests, cases, charged, sections, sections_delivered, amount en last_activity; gesorteerd op amount, dan requests, aflopend. Sleutels zonder aanvragen in de maand staan er niet in; een ingetrokken sleutel met aanvragen in die maand wel (active: false, revoked_at ingevuld). De sommen over per_key zijn gelijk aan total. Voor het voorbeeld hierboven (drie aanvragen met de huidige live-sleutel, één met een vorige live-sleutel die intussen ingetrokken is):

"per_key": [
  {
    "prefix": "tx_live_3f9a",
    "label": "production",
    "environment": "live",
    "active": true,
    "revoked_at": null,
    "requests": 3,
    "cases": 3,
    "charged": 3,
    "sections": {"package": 2, "avm": 2},
    "sections_delivered": {"basic": 3, "parcel": 3, "avm": 2, "price_map": 3},
    "amount": 10.0,
    "last_activity": "2026-09-08T10:39:27+02:00"
  },
  {
    "prefix": "tx_live_b71c",
    "label": "old key",
    "environment": "live",
    "active": false,
    "revoked_at": "2026-09-08T10:39:20+02:00",
    "requests": 1,
    "cases": 1,
    "charged": 1,
    "sections": {"package": 1, "avm": 0},
    "sections_delivered": {"basic": 1, "parcel": 1, "avm": 0, "price_map": 1},
    "amount": 3.0,
    "last_activity": "2026-09-08T10:39:15+02:00"
  }
]

CSV

?format=csv levert één rij per aanvraag, UTF-8 met BOM, scheidingsteken ;, elk veld tussen dubbele aanhalingstekens, decimaal , (opent direct in Excel nl-BE/fr-BE), CRLF-regeleinden. Bestandsnaam taxon-usage-<client>-<month>.csv (Content-Disposition). Dit is dezelfde lijst als de gebruiksbijlage bij de maandfactuur. Secties worden gescheiden met |; charged is 0 of 1. Echte rijen van 08-09-2026 (de vier aanvragen uit het gebruiksvoorbeeld hierboven, 16 kolommen sinds 2.4.1): rij 1 is het basispakket voor Grote Markt 34 Ieper, rij 2 de AVM-optie die één seconde later voor hetzelfde dossier toegevoegd werd (dedup_of = rij 1, pakket 0), rij 3 het hoofdvoorbeeld van sectie 4, rij 4 een aanvraag met sections=parcel genormaliseerd naar het pakket:

"request_id";"timestamp";"user_ref";"case_ref";"address";"region";"sections_requested";"sections_delivered";"charged";"free_reason";"dedup_of";"price_package";"price_avm";"price_total";"status_code";"key_prefix"
"f5569dd2c231469abaa2536b1bc4dd61";"2026-09-08T10:39:15+02:00";"office-ieper-01";"DOS-2026-0451";"Grote Markt 34, 8900 Ieper";"VL";"basic|parcel|price_map";"basic|parcel|price_map";"1";"";"";"3,00";"0,00";"3,00";"200";"tx_live_b71c"
"76cddf8bb6fc4a299283f85aa2be799e";"2026-09-08T10:39:16+02:00";"office-ieper-01";"DOS-2026-0451";"Grote Markt 34, 8900 Ieper";"VL";"basic|parcel|avm|price_map";"basic|parcel|avm|price_map";"1";"";"f5569dd2c231469abaa2536b1bc4dd61";"0,00";"2,00";"2,00";"200";"tx_live_3f9a"
"cf514c7de2714c11806e2ebf053d0247";"2026-09-08T10:39:24+02:00";"office-kortrijk-03";"DOS-2026-0452";"Doorniksestraat 40, 8500 Kortrijk";"VL";"basic|parcel|avm|price_map";"basic|parcel|avm|price_map";"1";"";"";"3,00";"2,00";"5,00";"200";"tx_live_3f9a"
"3aa7ba378561487fad54fd5fbbe83f1e";"2026-09-08T10:39:27+02:00";"office-kortrijk-03";"";"Rijselstraat 20, 8900 Ieper";"VL";"basic|parcel|price_map";"basic|parcel|price_map";"1";"";"";"3,00";"0,00";"3,00";"200";"tx_live_3f9a"

free_reason is leeg (aangerekend) of dedup, pilot, pilot_exhausted (rij met status 403: de aanvraag kreeg pilot_exhausted), test, no_result (nul referentiepunten, of een adresfout: rijen met status 404 of 422), error, timeout. price_package is de prijs van het basispakket (basic + parcel + price_map), price_avm die van de AVM-optie (kolommen sinds 2.4.0; de drie vroegere prijskolommen per sectie zijn verdwenen). sections_requested is de genormaliseerde lijst: het pakket uitgeschreven als basic|parcel|price_map. key_prefix (laatste kolom, 2.4.1) is het voorvoegsel van de API-sleutel die de aanvraag deed, zoals in per_key[].prefix.

9.GET /health

Publiek, zonder sleutel, zonder gegevens. Geschikt voor uw monitoring. De sleutels van dit endpoint zijn bewust behouden uit 1.x (Nederlandse namen): versie = versie, tijd = tijdstip, bundel = bundelmodus, db = databank.

{"status": "ok", "service": "taxon-partner-api", "versie": "2.5.1", "tijd": "2026-09-16T10:47:16+02:00", "bundel": "live", "db": "ok"}

versie is de versie van de dienst (2.4.2 = contract 2.0 plus de sectie price_map, de kenmerken van de referentiepunten, de fixes van de eerste externe integratietest, het sleutelbeheer door de partner, het basispakket en het gebruik per sleutel), niet de versie van dit contract (2.0). bundel is live (echte secties) of stub (testopstelling); db is ok of fout. Bij een databankfout antwoordt het endpoint met HTTP 503 en "status": "degraded". Er is geen aparte onderhoudsvlag; gepland onderhoud wordt per e-mail aangekondigd.

10.Bronvermelding en disclaimer (verplicht)

Elk scherm, rapport of document waarin API-gegevens getoond worden, draagt zichtbaar en onlosmakelijk de bronvermelding en de disclaimer. De API levert beide letterlijk mee in de velden attribution en disclaimer, in de taal van Accept-Language. Ze mogen niet ingekort, naar een bijlage verplaatst of verwijderd worden.

Bronregels per gegevenslaag

Naast de algemene bronvermelding levert de API per laag een bronregel (source, attribution) die u eveneens overneemt naast die gegevens, ook in white-label:

• Perceel en gebouwenpark: Bron: FOD Financiën, kadastraal percelenplan (CadGIS) plus de gewestelijke gebouwenlaag die in parcel.source genoemd wordt
• Statistische sectoren en indexen: Bron: Statbel, CC BY 4.0
• Wallonië (planologische bestemming, geocoding): Bron: Service public de Wallonie
• Vlaanderen: Bron: Vlaamse overheid, Gratis Open Data Licentie v1.2
• Brussel: Bron: perspective.brussels / Leefmilieu Brussel, CC BY
• Veiligheid: Bron: Federale Politie, politiële criminaliteitsstatistieken (PCS)
• Voorzieningen: © OpenStreetMap-bijdragers (ODbL)
• Prijskaart: de source-regel van de sectie

Aanvullende kwalificaties die u letterlijk overneemt in uw rapportsjablonen: de referentiepunten zijn vraagprijzen uit publiek aanbod, geen transactieprijzen; de AVM-waarde is een indicatieve modeluitvoer met vork, geen expertise; perceel-, plan- en overheidsgegevens worden "as is" en louter ter informatie geleverd met hun peildatum; de gegevens bevatten geen energieprestatiegegevens (EPC/PEB).

11.Gebruiksregels

Samenvatting van de contractuele regels die de API ook technisch afdwingt. De overeenkomst primeert.

• Per dossier. Toon de gegevens enkel aan de schatter en neem ze enkel op in het expertiserapport van het dossier waarvoor de aanvraag gebeurde. Elke aanvraag hoort bij een concreet dossier en een geïdentificeerde gebruiker (X-User-Ref, bij voorkeur ook X-Case-Ref).
• Bewaring maximaal 30 dagen. Ruwe API-antwoorden verdwijnen uiterlijk 30 dagen na de aanvraag uit operationele systemen, logs en caches. Enkel het afgewerkte rapport (PDF) blijft in het wettelijke dossierarchief.
• Geen afgeleide databank. Gegevens uit meerdere aanvragen niet samenvoegen, indexeren of opslaan tot een eigen databank, kaartlaag, index of prijsmodel; dit geldt ook voor de geometrie van de prijskaart.
• Geen modelvoeding. De gegevens niet gebruiken om een algoritme, model of AI-systeem te trainen, te kalibreren, te valideren of te verbeteren.
• Geen doorverkoop of bulk. Niet doorverkopen, publiceren, exporteren of aan derden geven buiten het rapport; de API niet geautomatiseerd of systematisch bevragen buiten een dossier.
• Foto's (2.5.0). Haal foto's op binnen de geldigheid van de link (1 uur) en gebruik ze enkel voor het dossier waarvoor de aanvraag gebeurde. Ze inbedden in het schattingsrapport (PDF) van dat dossier mag, altijd met een zichtbare bronvermelding bij elke foto (attribution, zie 10), onder de voorwaarden van de partnerovereenkomst (de partner vrijwaart Taxon voor claims van portalen of makelaars over de foto's). Geen herpublicatie, geen bewaring buiten dat rapport, geen bulkdownload; de resolutie blijft maximaal 640 px.
• Bronvermelding zichtbaar in uw UI en in elk rapport (zie 10). White-label enkel via een apart addendum.
• EPC "zoals geadverteerd". Toon EPC-labels van referentiepunten nooit als een opgezochte of gecontroleerde waarde.
• Geen notariële prijzen. Communiceer nooit dat de gegevens van notarissen, VLABEL of transacties afkomstig zijn; het zijn vraagprijzen.
• Menselijke beslissing. Geen beslissing met rechtsgevolgen (krediet, fiscaal, verzekering) uitsluitend op basis van de API of de AVM zonder de eindverantwoordelijkheid van een expert.
• Sleutel geheim, een lek melden binnen 48 uur; op verzoek (maximaal tweemaal per jaar) een uittreksel van dossiernummers tegenover aanvragen leveren.
• Documentatie vertrouwelijk. Deze documentatie is bestemd voor uw technisch personeel; niet openbaar maken.

12.Changelog en 1.x-mapping

Wijzigingen aan bestaande velden worden minstens 30 dagen vooraf aangekondigd; nieuwe velden kunnen zonder aankondiging toegevoegd worden (uw parser moet onbekende velden negeren). Een nieuwe hoofdversie krijgt een nieuw pad (/api/v2/partner/).

Mapping 1.x (Nederlands) naar 2.0 (Engels)

Voor teams die de 1.x-documentatie gelezen hebben. De oude namen werken niet meer, behalve de drie header-aliassen. Niet-opgelijste sleutels (lat, lon, capakey, epc_label, score, label, plan, model, n, p25, p75, pct, ref, url, download_token, quota, code, status, type, request_id, pilot, details, top_10, comparables, parcel, avm, capakeys, epc, format) zijn ongewijzigd.

13.Contact