Taxon Partner API

1.Aperçu

Une requête par adresse, un paquet de données pour le dossier d'expertise : le pack de base (points de référence, statistiques de quartier, équipements, parcelle et carte des prix) et, en option distincte, une estimation indicative (AVM). Destinée aux partenaires revendeurs qui affichent les données dans leur propre logiciel.

2.Authentification

Chaque requête porte l'en-tête X-Api-Key. La clé est de longue durée, liée à votre compte partenaire, et Taxon n'en conserve qu'un hachage. Elle ne vous est montrée qu'une seule fois, dans le tableau de bord partenaire (voir « Gérer vos clés » ci-dessous).

• Confidentialité. La clé reste dans votre backend. Jamais dans un navigateur, une application mobile ou un dépôt public. Appelez l'API de serveur à serveur.
• Rotation. Vous renouvelez vous-même une clé live dans le tableau de bord partenaire (voir « Gérer vos clés » ci-dessous) : la nouvelle clé est affichée une fois, l'ancienne continue de fonctionner 7 jours avec le message key_rotation_pending, puis répond 403 key_revoked.
• Liste d'adresses IP autorisées. En option, la clé peut être limitée aux adresses IP de vos serveurs (403 ip_not_allowed pour toute autre adresse).
• Fuite ou soupçon d'abus : renouvelez ou révoquez la clé vous-même sans attendre dans le tableau de bord et signalez-le dans les 48 heures ; Taxon révoque alors immédiatement l'ancienne clé si nécessaire.

Gérer vos clés 2.3.0

Depuis le 08-09-2026, vous gérez vos clés vous-même dans le tableau de bord partenaire sur taxon.be (taxon.be/api_partner, section « Gestion »). Chaque action y est journalisée (qui, quand, depuis quelle adresse IP) et signalée à Taxon ; la valeur d'une clé n'apparaît jamais dans un journal ni dans un e-mail.

Codes d'erreur des actions du tableau de bord (affichés en texte dans le tableau de bord, jamais sur /address ni /usage) : key_already_revealed, reveal_expired, not_revealable, key_limit_reached, live_key_not_allowed, not_self_revocable.

3.En-têtes

Chaque réponse (y compris une erreur) contient l'en-tête X-Request-ID et le champ request_id. Mentionnez-le dans toute demande de support.

4.GET /address

Fournit les sections demandées pour une adresse en Flandre, en Wallonie ou à Bruxelles. Traitement : validation, contrôle des plafonds, géocodage, contrôle de dédoublonnage, récupération parallèle des sections, facturation, réponse. Temps de réponse typique de 1 à 8 secondes (AVM et parcelle sont les plus lentes ; plusieurs parcelles : 3 à 12 secondes) ; réglez le délai d'attente de votre client à 60 secondes au minimum.

Paramètres de requête

Exemple de requête

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

Exemple de réponse (200)

Réponse réelle du 08-09-2026 (clé live, utilisateur office-kortrijk-03, requête cf514c7de2714c11806e2ebf053d0247), abrégée à un point de référence par bloc et trois équipements ; le bloc price_map (partie du pack de base) est omis ici, voir la section 5. Avec une clé live, environment vaut live, charged vaut true et free_reason vaut null ; les montants de billing.price sont ceux de la convention du client utilisé pour la capture, les vôtres suivent votre propre convention. Avec une clé de test, environment vaut test, charged vaut false, free_reason vaut test et chaque montant vaut 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.Sections

Pack de base et option AVM (2.4.0). Les sections basic, parcel et price_map forment un seul pack de base par dossier : sections=basic fournit les trois ensemble à un seul prix (billing.price.package). L'AVM est une option distincte (sections=basic,avm, billing.price.avm). sections_delivered continue de lister les sections réelles.

Source des données parcellaires (2.4.2). La section parcel lit le plan parcellaire cadastral actuel du SPF Finances (CadGIS PlanParcellaire, situation fiscale courante, aujourd'hui 01-01-2027). L'extrait annuel INSPIRE (01-01-2026) n'est plus que la solution de repli en cas de panne ou de réponse vide. Le champ fiscal_situation (sur parcel, sur chaque élément de parcels[] et sur chaque élément de parcel_candidates[]) donne la date ISO de la situation fiscale dont provient la parcelle ; source mentionne la couche. La date est la situation fiscale depuis laquelle la version actuelle de cette parcelle s'applique : une parcelle inchangée depuis des années porte une date plus ancienne (p. ex. 2019-01-01), alors que le plan dont elle est lue est toujours la situation fiscale courante. Une date plus ancienne ne signifie donc pas des données obsolètes ; seul 2026-01-01 combiné à un source INSPIRE indique le repli sur l'extrait annuel. Une parcelle divisée ou fusionnée après le dernier extrait (p. ex. 45043C0460/00R000 à Kluisbergen : une parcelle de 921 m² dans l'extrait, 460R 392 m² + 460X 529 m² dans le plan actuel) est donc livrée sous sa forme actuelle.

Plusieurs parcelles par bien : d'abord les candidates, puis les capakeys

Une maison mitoyenne avec un garage ou une parcelle de jardin séparés, une ferme avec des prairies, une villa sur deux parcelles cadastrales : la parcelle du point à l'adresse n'est alors qu'une partie du bien. L'API résout cela en deux étapes.

• Étape 1 : requête sans capakeys. La section parcel contient la parcelle du point (main_parcel, parcels[] avec 1 élément) et parcel_candidates[] : les parcelles contiguës (au plus 12), chacune avec capakey, area_m2 cadastrale, direction par rapport à la parcelle principale (toujours N, E, S ou W, indépendant de la langue), built (couche régionale des bâtiments ; null si cette couche n'était pas disponible) et distance_m entre les centroïdes. Uniquement des données cadastrales de base, aucune donnée de propriétaire. Affichez cette liste à l'utilisateur (par exemple « 33011I0172/00G000, 40 m², sud, bâtie » = le garage) et laissez-le cocher ce qui appartient au bien.
• Étape 2 : nouvelle requête avec capakeys (la parcelle principale plus les parcelles cochées, séparées par des virgules, au plus 10). La section fournit alors parcels[] (par parcelle : capakey, superficie issue de la géométrie et du cadastre, largeur/profondeur, surface bâtie, nombre de bâtiments, affectation, droit de préemption, distance_to_address_m, is_main) et les totaux total_area_m2, cadastral_total_area_m2, zoning_combined (un objet si toutes les parcelles sont identiques, sinon une liste avec parcels[] par affectation), preemption_right_combined (yes dès qu'une parcelle tombe dans un périmètre, avec les capakeys concernées), main_parcel (la parcelle sur laquelle se trouve l'adresse, sinon la première, avec le message main_parcel_not_in_capakeys) et parcels_not_found[]. Les champs au niveau de la section restent ceux de la parcelle principale. L'AVM (type house) utilise total_area_m2 ; avm.inputs_used.plot_area_source indique cadastre_main_parcel, cadastre_<n>_parcels (n = nombre de parcelles fournies, 2 à 10) ou partner ; le champ de section parcel.plot_area_source ne porte que les deux valeurs cadastre. Pour un appartement, aucune superficie de terrain n'est transmise au modèle (même avec capakeys).
• Dédoublonnage. Même utilisateur, même adresse : le pack de base fourni à l'étape 1 n'est pas refacturé (message dedup avec section: basic ; billing.free_reason ne vaut dedup que lorsque rien de nouveau n'est fourni, sinon null (facturé), test ou pilot), même si la section parcel est reconstruite avec les nouvelles parcelles. Si vous ajoutez l'option AVM à l'étape 2, vous ne payez que cette option. Les mêmes capakeys à nouveau dans les 30 jours = réponse issue du grand livre (from_cache: true). La même Idempotency-Key avec d'autres capakeys = 409 idempotency_conflict. parcel_candidates, parcel_candidates_source et parcel_candidates_remark sont toujours présents et valent null lorsque capakeys a été donné. Une analyse parcellaire à froid peut prendre jusqu'à 21 s ; sur upstream_errors.parcel: timeout (message section_missing ; le pack de base est facturé une fois, la répétition est gratuite dans la fenêtre de dédoublonnage), redemandez après quelques secondes avec une nouvelle Idempotency-Key.
• Chemins d'erreur. 422 capakey_invalid (format erroné ou plus de 10 clés ; details[] nomme les parties erronées) ; 422 capakey_too_far (une parcelle à plus de 2 km de l'adresse ; rien n'est fourni ni facturé). La section parcel fait partie du pack de base, capakeys ne requiert donc aucune section supplémentaire. Une capakey qui n'existe pas dans le plan parcellaire : message capakey_not_found (section parcel) et parcels_not_found[] ; les autres parcelles sont fournies. Si l'analyse parcellaire échoue pour une parcelle, seule sa superficie cadastrale compte (message parcel_analysis_incomplete).
• Charge. Limitez-vous aux parcelles du dossier. Chaque requête avec capakeys effectue une consultation du cadastre plus une analyse parcellaire par parcelle (jusqu'à 10) ; une ferme avec 3 parcelles prend 3 à 12 s.

Exemple complet avec des réponses réelles (Rijselstraat 62, Ieper) : guide d'intégration, section 3.

Terrains (type=land) 2.5.0

type=land (alias grond, terrain, bouwgrond) demande le paquet pour un terrain à bâtir. Ce qui change par rapport à une maison ou un appartement :

• Points de référence : un seul bloc (type: land, transaction: sale, pas de bloc location) avec des annonces de terrains à vendre (terrains à bâtir, terrains à projet et terrains sans sous-type plus précis ; les terres agricoles, prairies, bois, vergers, terrains industriels et PME, emplacements de parking, garages et terrains récréatifs sont exclus sur la base du sous-type annoncé) de toutes les années de publication (2.5.1 : plus de limite d'âge, pour que vous puissiez actualiser les prix demandés des annonces plus anciennes selon l'évolution du marché dans le cadre du dossier (indexation des prix) ; les conditions de licence restent inchangées : pas de fusion, d'indexation ni de conservation entre dossiers), dans un rayon de 5 km autour de l'adresse ; s'il y en a moins de 10 au total, le rayon est étendu une fois à 10 km (radius_m). Classement : d'abord les annonces des 24 derniers mois (triées par distance), puis les plus anciennes (triées par distance), 25 au plus par bloc ; chaque élément porte age_months (mois civils entiers entre published et aujourd'hui) et le champ de bloc max_age_months vaut null pour un terrain. Toujours moins de 10 : champ de bloc low_sample: true et message low_sample (section basic). Chaque élément porte les champs habituels lorsqu'ils ont un sens (address, distance_m, price, price_kind, source, published, status, history, photos, thumbnail, photo_count) plus plot_area_m2 et price_per_m2_plot (prix demandé par m² de terrain) ; les champs de logement (living_area_m2, price_per_m2, bedrooms, epc_label, year_built, condition, building_type, new_build) valent null. features se limite à {plot_area_m2, zoning, flood_zone, land_type} (zoning vaut actuellement toujours null : l'affectation d'une annonce n'est pas consultée ; celle de la parcelle du bien se trouve dans parcel.zoning ; land_type vaut building_plot, project_land ou other et détermine le premier mot de summary : « Terrain à bâtir », « Terrain à projet » ou « Terrain »). summary donne par exemple « Terrain à bâtir de 694 m² à Kluisbergen, proposé depuis le 10-09-2026. »
• Quartier : land_price_level (voir ci-dessus) à partir des mêmes annonces de terrains (mêmes exclusions) des 24 derniers mois ; un niveau de prix doit être actuel : avec moins de 10 annonces utilisables dans les 24 mois, la fenêtre est élargie à 60 mois et max_age_months indique la fenêtre utilisée (24 ou 60 ; 2.5.1) ; seules les annonces avec une superficie et un prix demandé entre 15 et 5 000 EUR par m² de terrain entrent dans les quartiles (count), afin que les terres agricoles annoncées comme constructibles et les superficies fictives ne faussent pas le niveau (les éléments hors de cette bande restent dans la liste avec leur propre price_per_m2_plot) ; price_level et epc_prices valent null avec le message housing_stats_not_available_for_land ; building_stock, safety et amenities comme d'habitude.
• Pas d'AVM : Taxon ne fournit ni évaluation automatique ni valeur indicative du terrain. sections=basic,avm reste HTTP 200 : avm vaut null et n'est pas dans sections_delivered, message {code: avm_not_available_for_land, section: avm}, l'option AVM n'est pas facturée. living_area_m2 peut être omis.
• Parcelle et carte des prix : inchangées. La section parcelle (affectation, droit de préemption, plusieurs parcelles via capakeys) est l'essentiel pour un terrain ; price_map reste la carte des logements (prix demandés au m² des maisons et appartements par quartier), pas une carte des prix des terrains.
• Facturation : le pack de base comme d'habitude (un prix par dossier, dédoublonnage 30 jours, pilote et clé de test comme pour les maisons) ; pas d'option AVM.

Couverture (15-09-2026, annonces des 24 derniers mois avec un prix ; au 16-09-2026, sur toutes les années de publication, environ 73 000 annonces de terrains, dont environ 38 200 dans les 24 mois) : Flandre environ 30 800 annonces de terrains, Wallonie environ 8 300, Bruxelles environ 330 ; environ 95 % portent une superficie. Certaines communes rurales wallonnes ont peu d'annonces de terrains (alors low_sample).

Exemple : réponse réelle du 15-09-2026 avec une clé de test (Accept-Language: en, requête f0c372798b3f285b66ab4b584819be57 ; champs 2.5.1 age_months et max_age_months: null ajoutés), raccourcie à un point de référence avec une photo, les champs principaux de la parcelle et les blocs de quartier qui changent pour un terrain ; building_stock, safety, amenities, parcels, parcel_candidates et price_map sont remplacés par "..." :

{
  "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"
}

Carte des prix (section price_map) 2.0

Niveaux des prix demandés par quartier dans un rayon de radius_m (3 000 m) autour de l'adresse, triés par distance, au plus 40 quartiers (le quartier du bien toujours inclus), fournis sous forme de données plus géométrie GeoJSON. Taxon ne fournit ni images ni tuiles cartographiques : vous dessinez les polygones vous-même avec votre propre bibliothèque et licence cartographiques (par exemple Leaflet, MapLibre ou Mapbox) et les colorez selon price_per_m2_house ou price_per_m2_apartment. Fait partie du pack de base depuis la 2.4.0 : pas de prix distinct (le prix du pack figure dans billing.price.package) ; le dédoublonnage suit le pack. Taille du bloc de 20 à 50 Ko ; réponse à chaud sous 0,5 s, la première requête après un redémarrage du service peut prendre jusqu'à 20 s. Mesuré en réel le 07-09-2026 : Braine-l'Alleud 40 quartiers, Ieper 38, Schaerbeek 40.

Message price_map_sparse (section price_map) lorsque le quartier du bien lui-même compte moins de 30 annonces ; la section est tout de même fournie. Lorsqu'aucun quartier avec des prix ne se trouve dans un rayon de 3 km, la section vaut null, le message price_map_unavailable est ajouté, upstream_errors.price_map vaut no_coverage ; ce n'est pas une panne et le pack de base reste facturé. Ne conservez pas la géométrie au-delà du dossier (règles d'utilisation, section 11). Exemple réel : réponse réelle du 08-09-2026 (clé live, sections=basic, Grote Markt 34, 8900 Ieper, requête f5569dd2c231469abaa2536b1bc4dd61), 2 des 38 quartiers, géométrie du quartier du bien complète :

"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": ["…"]}
    }
  ]
}

Par région

Les données d'inondation arriveront dans une version ultérieure comme champ supplémentaire de la section parcel. D'ici là, l'expert consulte lui-même les données d'inondation auprès de la région ; l'API ne se prononce pas à ce sujet.

6.Dédoublonnage (répétition gratuite) et Idempotency-Key

La facturation se fait par utilisateur + bien. Le bien est déterminé par le géocodage (arrondi à environ 1 m), pas par l'orthographe littérale de l'adresse. Une requête facturée reste valable 30 jours pour le même utilisateur. Un bien est le point géocodé plus le numéro de boîte ; un autre type, d'autres paramètres AVM, d'autres capakeys ou une autre langue ne font pas un autre bien : une telle répétition est reconstruite avec la nouvelle entrée et reste gratuite pour les sections déjà fournies (le dédoublonnage ne fige rien).

Attention au chien de garde : si un seul X-User-Ref porte une part anormalement élevée du trafic, ou si un utilisateur présente un schéma de balayage systématique (numéros de maison ou codes postaux consécutifs en peu de temps), cet utilisateur est suspendu (403 user_suspended) ; les autres utilisateurs continuent de fonctionner. La suspension frappe l'utilisateur, pas le client (votre clé) ; ce n'est qu'à partir de trois utilisateurs suspendus ou plus en 24 heures que suit 403 client_suspended. Utilisez donc toujours le véritable identifiant de l'utilisateur.

7.Plafonds et codes d'erreur

Plafonds

Chaque réponse 200 indique le compteur du jour dans billing.today (client_today, user_today), pour voir venir un plafond. Les répétitions en dédoublonnage comptent aussi comme trafic.

Conseil pour les nouvelles tentatives. En cas de 429 : attendez le délai Retry-After (ou retry_after du corps si l'en-tête manque, variante nginx), puis réessayez avec la même Idempotency-Key. En cas de 502, 503, 504 ou 500 : maximum 3 tentatives avec attente exponentielle (2, 4, 8 s ; pour 503, la valeur de Retry-After), même Idempotency-Key. En cas de 403 quota_exceeded : attendez le délai Retry-After (jusqu'à minuit). Pour les autres 4xx : ne pas réessayer, la requête elle-même est erronée.

Codes d'erreur

Corps d'erreur uniforme : {"error": "...", "message": "...", "request_id": "...", "charged": false}, éventuellement complété par details[] ({field, issue}), retry_after, scope et limit, section, user_ref, reason, since ou pilot. message suit Accept-Language.

Aucune erreur n'est jamais facturée (charged: false).

8.GET /usage

Votre propre consommation par mois civil : total, par utilisateur, par clé API (2.4.1), par jour, par section et un bloc qualité (taux d'erreur, latence p50/p95, nombre de requêtes avec pannes en amont). requests compte toutes les requêtes, cases celles en HTTP 200, charged celles avec un prix ; sections compte les unités facturées avec les clés package (pack de base) et avm (option AVM) ; sections_delivered (depuis la 2.4.0 aussi dans total) compte les quatre sections réelles basic, parcel, avm, price_map ; per_section utilise package et avm. Sert à vérifier vous-même ce que Taxon facture et à refacturer vos utilisateurs. X-User-Ref est ici optionnel et fait office de filtre. Le bloc plan montre votre plan sans prix : sections_allowed, max_per_minute, max_per_day, max_per_user_per_day, test_max_per_day, dedup_days, idempotency_hours, address_mode. requests compte les mêmes requêtes que les plafonds journaliers (voir 7).

Les paramètres inconnus (y compris les noms 1.x maand, formaat, gebruiker_ref) donnent 400 invalid_request avec details[].field. Réponse réelle du 08-09-2026 (clé live, deux utilisateurs, deux clés, quatre requêtes ; le code client est remplacé par un espace réservé) :

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"
}

Le bloc pilot (et billing.pilot_status) n'est que le compteur du pilote. Le statut du client dans le grand livre (pilote, actif, suspendu, terminé) n'est pas fourni dans la réponse ; une suspension se manifeste par 403 client_suspended ou 403 user_suspended. Avec une clé de production, sections et charged portent les nombres facturés et amount les montants selon votre convention.

Par clé API 2.4.1

Depuis la 2.4.1, la réponse porte aussi le bloc per_key (entre per_user et per_day) : la consommation par clé API, avec les mêmes filtres que le reste de la réponse (mois, l'environnement de la clé appelante, user_ref). Par clé : prefix (les 12 premiers caractères, comme dans votre liste de clés), label (null si vide), environment, active, revoked_at (null tant que la clé est active), requests, cases, charged, sections, sections_delivered, amount et last_activity ; triées par amount, puis requests, par ordre décroissant. Les clés sans requête dans le mois ne sont pas listées ; une clé révoquée avec des requêtes dans ce mois l'est (active: false, revoked_at renseigné). Les sommes sur per_key sont égales à total. Pour l'exemple ci-dessus (trois requêtes avec la clé live actuelle, une avec une clé live précédente révoquée depuis) :

"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 fournit une ligne par requête, UTF-8 avec BOM, séparateur ;, chaque champ entre guillemets doubles, décimale , (s'ouvre directement dans Excel nl-BE/fr-BE), fins de ligne CRLF. Nom de fichier taxon-usage-<client>-<month>.csv (Content-Disposition). C'est la même liste que l'annexe de consommation jointe à la facture mensuelle. Les sections sont séparées par | ; charged vaut 0 ou 1. Lignes réelles du 08-09-2026 (les quatre requêtes de l'exemple de consommation ci-dessus, 16 colonnes depuis la 2.4.1) : la ligne 1 est le pack de base pour Grote Markt 34 Ieper, la ligne 2 l'option AVM ajoutée une seconde plus tard pour le même dossier (dedup_of = ligne 1, pack à 0), la ligne 3 l'exemple principal de la section 4, la ligne 4 une requête avec sections=parcel normalisée vers le pack :

"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 est vide (facturé) ou vaut dedup, pilot, pilot_exhausted (ligne en statut 403 : la requête a reçu pilot_exhausted), test, no_result (zéro point de référence, ou une erreur d'adresse : lignes en statut 404 ou 422), error, timeout. price_package est le prix du pack de base (basic + parcel + price_map), price_avm celui de l'option AVM (colonnes depuis la 2.4.0 ; les trois anciennes colonnes de prix par section ont disparu). sections_requested est la liste normalisée : le pack écrit en toutes lettres, basic|parcel|price_map. key_prefix (dernière colonne, 2.4.1) est le préfixe de la clé API qui a fait la requête, comme dans per_key[].prefix.

9.GET /health

Public, sans clé, sans données. Adapté à votre monitoring. Les clés de cet endpoint sont volontairement conservées de la 1.x (noms néerlandais) : versie = version, tijd = heure, bundel = mode du paquet, db = base de données.

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

versie est la version du service (2.4.2 = contrat 2.0 plus la section price_map, les caractéristiques des points de référence, les corrections du premier test d'intégration externe, la gestion des clés par le partenaire, le pack de base et la consommation par clé), pas la version de ce contrat (2.0). bundel vaut live (sections réelles) ou stub (montage de test) ; db vaut ok ou fout (erreur). En cas d'erreur de base de données, l'endpoint répond HTTP 503 avec "status": "degraded". Il n'y a pas de drapeau de maintenance distinct ; les maintenances planifiées sont annoncées par e-mail.

10.Mention de la source et clause de non-responsabilité (obligatoires)

Tout écran, rapport ou document affichant des données de l'API porte de manière visible et indissociable la mention de la source et la clause de non-responsabilité. L'API fournit les deux textuellement dans les champs attribution et disclaimer, dans la langue d'Accept-Language. Ils ne peuvent être ni abrégés, ni déplacés en annexe, ni supprimés.

Lignes de source par couche de données

Outre la mention générale de la source, l'API fournit par couche une ligne de source (source, attribution) que vous reprenez également à côté de ces données, y compris en marque blanche :

• Parcelle et parc immobilier : Source : SPF Finances, plan parcellaire cadastral (CadGIS) plus la couche régionale des bâtiments nommée dans parcel.source
• Secteurs statistiques et indices : Source : Statbel, CC BY 4.0
• Wallonie (affectation, géocodage) : Source : Service public de Wallonie
• Flandre : Source : Autorité flamande, Gratis Open Data Licentie v1.2
• Bruxelles : Source : perspective.brussels / Bruxelles Environnement, CC BY
• Sécurité : Source : Police fédérale, statistiques policières de criminalité (PCS)
• Équipements : © OpenStreetMap contributors (ODbL)
• Carte des prix : la ligne source de la section

Qualifications complémentaires à reprendre textuellement dans vos modèles de rapport : les points de référence sont des prix demandés issus de l'offre publique, pas des prix de transaction ; la valeur AVM est une sortie de modèle indicative avec fourchette, pas une expertise ; les données parcellaires, planologiques et publiques sont fournies « en l'état » et à titre informatif, avec leur date de référence ; les données ne contiennent aucune donnée de performance énergétique (EPC/PEB).

11.Règles d'utilisation

Résumé des règles contractuelles également appliquées techniquement par l'API. La convention prime.

• Par dossier. Les données ne sont montrées qu'à l'expert et reprises uniquement dans le rapport d'expertise du dossier pour lequel la requête a été faite. Chaque requête appartient à un dossier concret et à un utilisateur identifié (X-User-Ref, de préférence aussi X-Case-Ref).
• Conservation 30 jours maximum. Les réponses brutes de l'API disparaissent des systèmes opérationnels, journaux et caches au plus tard 30 jours après la requête. Seul le rapport finalisé (PDF) reste dans l'archive légale du dossier.
• Pas de base de données dérivée. Ne pas agréger, indexer ou stocker les données de plusieurs requêtes dans une base de données, couche cartographique, index ou modèle de prix propre ; cela inclut la géométrie de la carte des prix.
• Pas d'alimentation de modèle. Ne pas utiliser les données pour entraîner, calibrer, valider ou améliorer un algorithme, un modèle ou un système d'IA.
• Pas de revente ni d'extraction en masse. Ne pas revendre, publier, exporter ou transmettre à des tiers en dehors du rapport ; ne pas interroger l'API de manière automatisée ou systématique en dehors d'un dossier.
• Photos (2.5.0). Récupérez les photos pendant la validité du lien (1 heure) et ne les utilisez que pour le dossier pour lequel la requête a été faite. Les intégrer dans le rapport d'expertise (PDF) de ce dossier est autorisé, toujours avec une mention de source visible à côté de chaque photo (attribution, voir 10), sous réserve de la convention de partenariat (le partenaire garantit Taxon contre les réclamations de portails ou d'agents immobiliers concernant les photos). Pas de republication, pas de conservation en dehors de ce rapport, pas de téléchargement en masse ; la résolution reste limitée à 640 px.
• Mention de la source visible dans votre interface et dans chaque rapport (voir 10). Marque blanche uniquement via un avenant distinct.
• PEB « tel qu'annoncé ». Ne jamais présenter les labels PEB des points de référence comme une valeur consultée ou vérifiée.
• Pas de prix notariés. Ne jamais communiquer que les données proviennent de notaires, de VLABEL ou de transactions ; ce sont des prix demandés.
• Décision humaine. Aucune décision produisant des effets juridiques (crédit, fiscalité, assurance) fondée exclusivement sur l'API ou l'AVM sans la responsabilité finale d'un expert.
• Clé secrète, fuite à signaler dans les 48 heures ; sur demande (au plus deux fois par an), fournir un extrait des numéros de dossier en regard des requêtes.
• Documentation confidentielle. Cette documentation est destinée à votre personnel technique ; ne pas la publier.

12.Changelog et correspondance 1.x

Les modifications de champs existants sont annoncées au moins 30 jours à l'avance ; de nouveaux champs peuvent être ajoutés sans préavis (votre analyseur doit ignorer les champs inconnus). Une nouvelle version majeure reçoit un nouveau chemin (/api/v2/partner/).

Correspondance 1.x (néerlandais) vers 2.0 (anglais)

Pour les équipes qui lisent la documentation 1.x. Les anciens noms ne fonctionnent plus, à l'exception des trois alias d'en-tête. Les clés non reprises (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) sont inchangées.

13.Contact