Documentation
Référence API

Versions

Cette documentation décrit la version 1.0 de l'API open-connect, en cours de conception : les formes de réponse décrites ici sont le contrat visé, pas encore un service en ligne.
Une version vaut pour tous les pays : chaque pays a ses routes sous le même préfixe (/api/v1/fr/, /api/v1/ca/, /api/v1/be/), et chaque entrée de ce tableau nomme les pays qu'elle touche. Une version publiée ne change plus de forme : une clé ou une valeur nouvelle n'est servie qu'à partir de la version suivante, et un préfixe déjà en ligne ne reçoit que des corrections. Le numéro de correction suit le préfixe qui la sert : une 1.0.x est servie sous /api/v1/.

Version 1.0

Préfixe /api/v1/ · version de référence, en conception.
  • Tous les pays : rapport de localisation (une position ou une adresse, toutes les données disponibles par domaine, filtrables avec include), une route par domaine, indicateurs d'une zone sans position (/zones/…), catalogue (domaines, définitions des champs et leur couverture, catégories de lieux, types d'aléas)
  • France (/api/v1/fr/) : l'adresse, l'immeuble, le bien et sa vie, puis le quartier ; identifiants stables de l'immeuble, du bien et de chaque événement (/buildings/{id}, /properties/{id}) ; listes paginées des ventes, des autorisations d'urbanisme et des lieux
  • Canada, Québec (/api/v1/ca/) : l'adresse, l'immeuble et l'unité d'évaluation du rôle, puis le quartier ; identifiants stables (/buildings/{id}, /properties/{id}) ; listes paginées des permis et des lieux
  • Belgique (/api/v1/be/) : l'adresse, puis le quartier ; listes paginées des autorisations d'urbanisme et des lieux

Compatibilité

Un numéro de version s'écrit X.Y.Z. Le chiffre qui bouge dit ce que vous avez à faire.
Incrément Ce qui change Ce que vous avez à faire
X — refonte Nouveau modèle de ressources, d'authentification ou de pagination Une migration, annoncée en amont avec une date de fin de support
Y — rupture Une réponse change de forme : un champ ajouté, retiré, renommé, de type ou de valeur différente Rien dans l'immédiat : la nouvelle forme a sa propre URL, et la précédente continue de servir celle que vous connaissez
Z — ajout Une route ou un paramètre optionnel en plus. Rien de ce que vous lisez déjà Rien, l'URL ne change pas
Chaque rupture est publiée sous son propre préfixe d'URL, et un préfixe une fois publié ne change plus jamais de forme. Migrer se fait donc en changeant le préfixe dans vos appels, à votre rythme ; une intégration nouvelle part du préfixe le plus récent.
Un champ n'apparaît jamais dans une réponse servie par une URL que vous utilisez déjà : il attend la sienne.
Chaque réponse porte l'en-tête X-Api-Version avec la version effectivement servie : c'est le moyen le plus sûr de savoir quelle forme vous recevez.

Introduction

open-connect décrit ce qui entoure un bien immobilier, à partir d'une adresse : où il se trouve, puis son quartier (marché, risques, lieux, accès, urbanisme, habitants). Vous envoyez une adresse ou une position, open-connect vous renvoie tout ce qu'il sait à cet endroit, ou seulement les domaines que vous demandez.
open-connect rassemble les données publiques du pays (administrations fédérales et régionales, institut statistique, communes), les contrôle et les unifie dans une nomenclature unique : mêmes noms, mêmes unités, mêmes niveaux de zones, quelle que soit la donnée d'origine. Chaque valeur porte la période qu'elle décrit et la date de sa dernière mise à jour.
Cette documentation décrit l'API de la Belgique. Aucune donnée publique n'y est publiée au bien ni à l'immeuble : l'API sert l'adresse et le quartier. Chaque pays a sa documentation et ses routes, sous la même version de l'API ; une clé s'ouvre pays par pays.
Le même moteur sert les fiches biens d'immosquare : une donnée visible dans nos fiches est une donnée que l'API sait servir, avec la même forme.

Domaines

Une réponse est découpée en domaines : l'adresse, puis le quartier. Chacun a sa route, et le rapport complet les assemble.
Domaine Contenu
location Adresse retenue, position et précision, zones
risks Aléa d'inondation et sols pollués autour, en Région de Bruxelles-Capitale
market Prix médian des ventes dans la commune, autorisations d'urbanisme autour (Flandre)
places Écoles, santé et arrêts de transport autour, avec le temps à pied
access Gare, aéroport, accès autoroutier et école les plus proches
residents Qui vit dans le quartier : revenus, logements
urbanism Plan applicable et zone, en Flandre
La couverture exacte de chaque champ est servie par GET /catalog/fields.

Démarrage rapide

Tout ce que l'API sait d'une adresse à Ixelles :
curl "https://app.open-connect.io/api/v1/be/report?address=Chauss%C3%A9e%20d%27Ixelles%20168%201050%20Ixelles" \
  -H "Authorization: Bearer oc_live_7f3c…"
Seulement le marché et les habitants d'un point :
curl "https://app.open-connect.io/api/v1/be/report?lat=50.8329&lng=4.3664&include=market,residents" \
  -H "Authorization: Bearer oc_live_7f3c…"
La réponse porte toujours deux clés : data, les données par domaine, et meta, l'identifiant de la requête, la version servie et ce qui manque.
{
  "data": {
    "location":  { "…": "…" },
    "market":    { "status": "ok", "…": "…" },
    "residents": { "status": "ok", "…": "…" }
  },
  "meta": {
    "request_id": "req_01JA2Q8W6Y3K5V",
    "api_version": "1.0",
    "generated_at": "2026-10-12T08:12:44Z"
  }
}

Authentification

Chaque requête porte votre clé dans l'en-tête Authorization, au format Bearer :
GET /api/v1/be/report?lat=50.8329&lng=4.3664
Authorization: Bearer oc_live_7f3c9a1e5b2d4c6f8a0b1c2d3e4f5a6b
  • Une clé commence par oc_live_ (production) ou oc_test_ (bac à sable, mêmes données, quotas réduits, réponses marquées "sandbox": true dans meta).
  • La clé n'est montrée qu'une fois, à sa création : nous n'en gardons qu'une empreinte. Une clé perdue se révoque et se remplace depuis votre espace client.
  • Une clé est ouverte pays par pays, et peut être limitée à certains domaines. Un pays hors de votre clé répond 403 avec le code country_not_allowed ; un domaine hors de votre clé répond 403 avec le code domain_not_allowed, et un rapport complet l'omet en le signalant dans meta.warnings.
  • La clé ne doit jamais être exposée dans un navigateur ou une application mobile : appelez l'API depuis votre serveur.
Pour obtenir une clé : contact@immosquare.com.

Quotas et limites

Chaque réponse annonce l'état de votre quota :
En-tête Valeur
X-RateLimit-Limit Requêtes autorisées par minute
X-RateLimit-Remaining Requêtes restantes dans la minute en cours
X-RateLimit-Reset Secondes avant la remise à zéro du compteur
X-Quota-Remaining Unités restantes sur la période de votre abonnement
X-Request-Id Identifiant de la requête, à nous transmettre en cas de besoin
X-Api-Version Version effectivement servie
Au-delà, l'API répond 429 avec un en-tête Retry-After en secondes. Un 429 est toujours temporaire : attendez le délai indiqué avant de renvoyer la requête.
Une route de domaine consomme une unité ; un rapport consomme une unité par domaine calculé. Une réponse servie depuis notre cache coûte la même chose qu'une réponse calculée : le cache sert à la vitesse, pas au décompte.

Erreurs

Une erreur répond avec un code HTTP et un corps stable, dont error.code ne change jamais d'une version à l'autre :
{
  "error": {
    "code": "invalid_parameter",
    "message": "lat doit être compris entre -90 et 90",
    "details": {
      "parameter": "lat",
      "value": "148.85"
    }
  },
  "meta": {
    "request_id": "req_01JA2Q8W6Y3K5V",
    "api_version": "1.0",
    "generated_at": "2026-10-11T08:12:44Z"
  }
}
HTTP error.code Cas
400 invalid_parameter Paramètre absent, mal formé ou hors bornes ; error.details.parameter le nomme
400 ambiguous_location lat/lng et address envoyés ensemble
401 unauthorized Clé absente, inconnue ou révoquée
403 country_not_allowed Pays hors de votre clé
403 domain_not_allowed Domaine hors de votre clé
404 address_not_found Adresse introuvable : renvoyez la requête avec des coordonnées
404 zone_not_found Zone inconnue (/zones/…)
422 outside_coverage Position hors du territoire que sert cette API : la Belgique
429 rate_limited Trop de requêtes : attendre Retry-After
429 quota_exceeded Quota de la période épuisé
500 internal_error Erreur interne, sans détail technique : la requête peut être renvoyée plus tard
503 maintenance Maintenance annoncée : Retry-After donne la durée estimée
Une donnée momentanément indisponible ne fait pas échouer la requête : le domaine concerné répond "status": "partial" ou "unavailable", et meta.warnings explique ce qui manque. Seule une erreur de votre requête ou de notre service répond par un code d'erreur.

Conventions

  • Format : JSON en UTF-8, clés en anglais et en snake_case.
  • Nombres : toujours des nombres JSON, jamais des chaînes. Un montant est un nombre accompagné de son unité.
  • Dates : AAAA-MM-JJ ; horodatages en ISO 8601, en UTC (2026-10-11T08:12:44Z).
  • Positions : latitude et longitude en degrés décimaux WGS84 (lat, lng en paramètres ; latitude, longitude en réponse).
  • Distances : en mètres, à vol d'oiseau, dans distance_m.
  • Surfaces : en mètres carrés.
  • Absence : un champ documenté est toujours présent ; il vaut null quand la donnée n'existe pas à cet endroit, et l'objet missing du domaine dit pourquoi (voir Absences). Une liste vide vaut [].
  • Codes et libellés : les valeurs énumérées sont des codes stables (apartment, flood, high) ; quand un libellé lisible est utile, il est servi à côté, dans la langue demandée.
  • Langue : fr (par défaut) ou en, par le paramètre locale ou l'en-tête Accept-Language. Les noms propres (rues, communes, établissements) restent dans leur langue d'origine.
  • Noms : un nom n'a qu'une définition. Les noms communs à tous les pays d'open-connect (les objets décrits ici, les niveaux de zones, latitude, price_per_m2) y veulent dire la même chose ; une donnée propre à ce pays porte un nom propre, documenté seulement ici.

Unités

unit Sens
EUR Montant en euros
EUR/year Montant annuel (revenu)
% Pourcentage (3.2 signifie 3,2 %)
count Nombre

Niveaux de zones

Les zones vont du plus large au plus fin. Les noms de niveaux sont ceux des composants d'adresse des géocodeurs, que reprennent les autres API d'immosquare et toutes les API d'open-connect :
level Zone Code
country Belgique BE
administrative_area_level1 Région Code officiel de la région
administrative_area_level2 Province Code officiel de la province
administrative_area_level3 Arrondissement administratif Code officiel de l'arrondissement
locality Commune Code officiel de la commune (21009)
sublocality_level1 Section (ancienne commune) Code officiel de la section
sublocality_level2 Secteur statistique Code du secteur (21009A101)
La Région de Bruxelles-Capitale n'a pas de province : administrative_area_level2 y vaut null.

Objets communs

Les domaines diffèrent, mais leurs valeurs sont toujours construites avec les mêmes objets, identiques dans tous les pays d'open-connect.

Zone

Une zone du découpage : son niveau, son code officiel et son nom.
{
  "level": "locality",
  "code": "21009",
  "name": "Ixelles"
}
Une valeur calculée autour du point, et non pour une zone (la médiane des ventes à moins de 500 m), porte une zone de niveau radius, dont le code est le rayon en mètres.

Mesure

Une valeur chiffrée, avec ce qu'il faut pour la lire honnêtement : son unité, sa période, la zone qu'elle décrit, sa fiabilité, sa définition et sa date de mise à jour.
{
  "value": 342000,
  "unit": "EUR",
  "period": {
    "start": "2025-01-01",
    "end": "2025-12-31"
  },
  "zone": {
    "level": "locality",
    "code": "21009",
    "name": "Ixelles"
  },
  "sample_size": 1023,
  "reliability": "high",
  "range": null,
  "definition": "sale_price_median",
  "updated_on": "2026-10-09",
  "stale": false
}
Champ Type Description
value nombre La valeur
unit chaîne Unité
period objet Période décrite, start et end inclus ; null pour une donnée sans période (un taux en vigueur)
zone Zone Zone décrite. Elle peut être plus large que le point : open-connect sert la zone la plus fine qui a une valeur fiable. Un rayon autour du point est une zone de niveau radius
sample_size entier Nombre d'observations derrière la valeur (ventes, logements, déclarations), quand il est connu
reliability chaîne high, medium ou low : voir Fiabilité
range objet Intervalle : {"low": …, "high": …} (premier et troisième quartiles, fourchette de loyers)
definition chaîne Définition open-connect de la valeur, décrite dans GET /catalog/fields
updated_on date Date de notre dernière mise à jour de la valeur
stale booléen true quand la valeur est en retard sur son rythme de mise à jour : voir Fraîcheur
Deux mesures qui ne mesurent pas la même chose portent deux noms, même quand elles se ressemblent : un revenu médian par unité de consommation et un revenu médian par déclaration sont deux champs distincts.

Fiabilité

reliability Signification
high Assez d'observations, ou fiabilité publiée excellente ou très bonne
medium Utilisable avec prudence : échantillon réduit, fiabilité publiée « bonne »
low Indicatif seulement : petit échantillon, fiabilité publiée « passable »
open-connect ne sert jamais une valeur non publiée pour confidentialité ou manque de fiabilité : elle vaut alors null.

Aléa

Un risque naturel qui concerne le point, dans une nomenclature et une échelle communes à tous les pays d'open-connect :
{
  "type": "flood",
  "level": "low",
  "scope": "point",
  "label": "Aléa d'inondation faible"
}
| Champ | Description | | |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | |
| type | flood |
| level | very_low, low, moderate, high, very_high, ou present quand la carte dit seulement « dans la zone » | | |
| scope | building (exposition du bâtiment), point (zone cartographiée qui contient le point), locality (risque connu dans la commune, sans localisation) | | |
| label | Libellé lisible, dans la langue demandée | | |
Chaque type a une seule définition de ses niveaux, la même partout. Pour l'inondation, high est une crue fréquente (période de retour de 30 ans au plus), moderate une crue moyenne (de l'ordre de 100 ans), low une crue rare. Le détail est servi par GET /catalog/hazards.

Lieu

Un point d'intérêt, avec sa distance au point demandé :
{
  "id": "plc_76CD8B24",
  "category": "transport.bus",
  "name": "FERNAND COCQ",
  "address": null,
  "latitude": 50.833057,
  "longitude": 4.366481,
  "distance_m": 81,
  "walk_minutes": 1,
  "lines": [
    "54",
    "71",
    "N09",
    "N10"
  ]
}
Les catégories forment une hiérarchie stable à deux niveaux, un groupe et sa catégorie (school, school.primary, health.pharmacy…), la même dans tous les pays : voir GET /catalog/categories. walk_minutes est estimé à 80 m par minute, à vol d'oiseau ; lines ne concerne que les arrêts de transport. Un même lieu publié plusieurs fois n'est servi qu'une fois.

Statut d'un domaine

Chaque domaine ouvre sur son statut :
status Signification
ok Toutes les données du domaine ont répondu
partial Une partie des données est momentanément indisponible : les champs concernés valent null, meta.warnings les nomme
not_covered Le domaine n'a aucune donnée publiée à cet endroit : le catalogue donne les territoires couverts
unavailable Les données du domaine sont momentanément indisponibles ; la requête peut être renvoyée plus tard
insufficient_precision La position est trop imprécise pour ce domaine (adresse trouvée à la rue ou à la commune seulement) : les données au bâtiment ne sont pas servies, plutôt que de décrire le mauvais immeuble

Absences

Un champ à null peut vouloir dire des choses très différentes. Chaque domaine porte un objet missing, qui donne la raison de chaque champ absent :
"missing": {
  "last_sale": "not_found",
  "copro": "not_applicable"
}
Raison Signification
not_covered Donnée non publiée sur ce territoire
not_applicable La donnée n'a pas de sens ici (pas de copropriété pour une maison)
insufficient_sample Trop peu d'observations pour une valeur fiable
suppressed Valeur non publiée (secret statistique, fiabilité insuffisante)
not_found Rien trouvé ici (aucun diagnostic pour ce bien, aucune vente connue)
not_assessed Le point est hors des secteurs cartographiés : l'absence de zone ne veut pas dire absence de risque
unavailable Donnée momentanément indisponible
insufficient_precision Position trop imprécise pour une donnée au bâtiment

Localiser

Toutes les routes de données prennent un lieu, de l'une de ces deux façons :
Paramètre Type Description
lat nombre Latitude WGS84, avec lng
lng nombre Longitude WGS84, avec lat
address chaîne Adresse postale complète, à la place de lat/lng : numéro, rue, code postal, ville
Le pays est celui de l'API appelée : une adresse est toujours cherchée dans ce pays, et une position hors de son territoire répond 422 avec le code outside_coverage.
Une adresse est cherchée dans cet ordre :
  1. Les adresses officielles du pays, au numéro : la position est celle de l'adresse.
  2. Les adresses déjà résolues par open-connect, pour une adresse absente des listes officielles (une adresse trop récente, une graphie inhabituelle).
  3. Notre géocodeur, en dernier recours. Le résultat est enregistré : la même adresse, envoyée ensuite par vous ou par un autre client, est résolue immédiatement à l'étape 2.
data.location dit toujours ce qui a été retenu, comment, et avec quelle précision : vérifiez-le avant d'afficher des données « à l'adresse ».

Résoudre un lieu

Position, adresse et zones d'un lieu. Utile pour valider une adresse saisie.
Endpoint
GET https://app.open-connect.io/api/v1/be/location
Query Parameters
Parameter Type Description
lat, lng, address Voir Localiser
locale chaîne fr ou en
Réponse : data.location
Champ Type Description
latitude, longitude nombre Position retenue
precision chaîne input (vos coordonnées), building (au bâtiment), address (au numéro), street (à la rue), locality (à la commune seulement)
address objet \ null
geocoding objet \ null
zones objet Les zones du point, une clé par niveau ; null pour un niveau absent
{
  "data": {
    "location": {
      "latitude": 50.83263,
      "longitude": 4.36742,
      "precision": "address",
      "address": {
        "label": "Chaussée d'Ixelles 168, 1050 Ixelles",
        "street_number": "168",
        "street_name": "Chaussée d'Ixelles",
        "zipcode": "1050",
        "locality": "Ixelles"
      },
      "geocoding": {
        "query": "Chaussée d'Ixelles 168 1050 Ixelles",
        "matched": "Chaussée d'Ixelles 168, 1050 Ixelles",
        "method": "official_addresses",
        "alternatives": []
      },
      "zones": {
        "country": {
          "level": "country",
          "code": "BE",
          "name": "Belgique"
        },
        "administrative_area_level1": {
          "level": "administrative_area_level1",
          "code": "04000",
          "name": "Région de Bruxelles-Capitale"
        },
        "administrative_area_level2": null,
        "administrative_area_level3": {
          "level": "administrative_area_level3",
          "code": "21000",
          "name": "Arrondissement de Bruxelles-Capitale"
        },
        "locality": {
          "level": "locality",
          "code": "21009",
          "name": "Ixelles"
        },
        "sublocality_level1": {
          "level": "sublocality_level1",
          "code": "21009A",
          "name": "Ixelles"
        },
        "sublocality_level2": {
          "level": "sublocality_level2",
          "code": "21009A00-",
          "name": "21009A00-"
        }
      }
    }
  },
  "meta": {
    "request_id": "req_1RZ7H3MC5WQ8DK",
    "api_version": "1.0",
    "generated_at": "2026-10-12T09:06:02Z",
    "warnings": [],
    "sandbox": false
  }
}

Rapport de localisation

Toutes les données d'un lieu en une requête, ou seulement les domaines demandés. Les domaines sont calculés en parallèle : un domaine lent ou indisponible n'empêche pas les autres de répondre.
Endpoint
GET https://app.open-connect.io/api/v1/be/report
Query Parameters
Parameter Type Description
lat, lng, address Voir Localiser
include chaîne Domaines à calculer, séparés par des virgules : market,residents. Un domaine peut être restreint à certains de ses champs : market.sale_price_median. Par défaut, tous ceux de votre clé. location est toujours servi
property_type chaîne apartment ou house : ne sert que les valeurs de ce type
radius entier Rayon en mètres des listes (lieux, autorisations, sols pollués), de 100 à 2000. Par défaut, celui de chaque domaine
locale chaîne fr ou en
Dans un rapport, les listes sont abrégées à leurs premiers éléments ; la route du domaine sert la liste complète, paginée.
Réponse
Champ Type Description
data.location objet Voir Résoudre un lieu
data.<domaine> objet Une clé par domaine calculé, décrite dans la section du domaine. Chacune ouvre sur son status
meta.request_id chaîne Identifiant de la requête
meta.api_version chaîne Version servie
meta.generated_at chaîne Horodatage UTC du calcul
meta.warnings liste Ce qui manque et pourquoi : {"domain": "urbanism", "code": "data_unavailable", "message": "…"}
meta.sandbox booléen true avec une clé de test
Exemple au 168 chaussée d'Ixelles, à Ixelles (abrégé) :
{
  "data": {
    "location": {
      "latitude": 50.83263,
      "longitude": 4.36742,
      "precision": "address",
      "address": {
        "label": "Chaussée d'Ixelles 168, 1050 Ixelles",
        "street_number": "168",
        "street_name": "Chaussée d'Ixelles",
        "zipcode": "1050",
        "locality": "Ixelles"
      },
      "geocoding": {
        "query": "Chaussée d'Ixelles 168 1050 Ixelles",
        "matched": "Chaussée d'Ixelles 168, 1050 Ixelles",
        "method": "official_addresses",
        "alternatives": []
      },
      "zones": {
        "country": {
          "level": "country",
          "code": "BE",
          "name": "Belgique"
        },
        "administrative_area_level1": {
          "level": "administrative_area_level1",
          "code": "04000",
          "name": "Région de Bruxelles-Capitale"
        },
        "administrative_area_level2": null,
        "administrative_area_level3": {
          "level": "administrative_area_level3",
          "code": "21000",
          "name": "Arrondissement de Bruxelles-Capitale"
        },
        "locality": {
          "level": "locality",
          "code": "21009",
          "name": "Ixelles"
        },
        "sublocality_level1": {
          "level": "sublocality_level1",
          "code": "21009A",
          "name": "Ixelles"
        },
        "sublocality_level2": {
          "level": "sublocality_level2",
          "code": "21009A00-",
          "name": "21009A00-"
        }
      }
    },
    "risks": {
      "status": "ok",
      "hazards": [],
      "not_assessed": [],
      "summary": {
        "highest_level": null,
        "notable": [],
        "assessed": [
          "flood"
        ],
        "not_assessed": []
      },
      "polluted_sites": {
        "inside": [
          {
            "type": "suspected_land",
            "status": "suspected",
            "distance_m": 0
          }
        ],
        "counts": {
          "suspected_land": 62,
          "contaminated_land": 88
        },
        "items": [
          {
            "type": "suspected_land",
            "status": "suspected",
            "distance_m": 0
          },
          {
            "type": "suspected_land",
            "status": "suspected",
            "distance_m": 58
          }
        ]
      },
      "missing": {}
    },
    "market": {
      "status": "ok",
      "sale_price_median": {
        "apartment": {
          "value": 342000,
          "unit": "EUR",
          "period": {
            "start": "2025-01-01",
            "end": "2025-12-31"
          },
          "zone": {
            "level": "locality",
            "code": "21009",
            "name": "Ixelles"
          },
          "sample_size": 1023,
          "reliability": "high",
          "range": null,
          "definition": "sale_price_median",
          "updated_on": "2026-10-09",
          "stale": false
        },
        "house": {
          "value": 785000,
          "unit": "EUR",
          "period": {
            "start": "2025-01-01",
            "end": "2025-12-31"
          },
          "zone": {
            "level": "locality",
            "code": "21009",
            "name": "Ixelles"
          },
          "sample_size": 116,
          "reliability": "high",
          "range": null,
          "definition": "sale_price_median",
          "updated_on": "2026-10-09",
          "stale": false
        }
      },
      "permits_nearby": null,
      "missing": {
        "permits_nearby": "not_covered"
      }
    },
    "places": {
      "status": "ok",
      "counts": {
        "transport": 33,
        "health": 26,
        "school": 30
      },
      "items": [
        {
          "id": "plc_76CD8B24",
          "category": "transport.bus",
          "name": "FERNAND COCQ",
          "address": null,
          "latitude": 50.833057,
          "longitude": 4.366481,
          "distance_m": 81,
          "walk_minutes": 1,
          "lines": [
            "54",
            "71",
            "N09",
            "N10"
          ]
        },
        {
          "id": "plc_34078A1B",
          "category": "school.kindergarten",
          "name": "GO! Basisschool De Wimpel Elsene",
          "address": "Cansstraat 14 - 1050 Elsene",
          "latitude": 50.833301,
          "longitude": 4.36861,
          "distance_m": 112,
          "walk_minutes": 1,
          "lines": null
        },
        {
          "id": "plc_69640666",
          "category": "health.pharmacy",
          "name": "Pharmacie",
          "address": "place Fernand Cocq 26 - 1050 Ixelles",
          "latitude": 50.8336107,
          "longitude": 4.3665379,
          "distance_m": 125,
          "walk_minutes": 2,
          "lines": null
        }
      ],
      "missing": {}
    },
    "residents": {
      "status": "ok",
      "income": {
        "taxable_median": {
          "value": 24361,
          "unit": "EUR/year",
          "period": {
            "start": "2023-01-01",
            "end": "2023-12-31"
          },
          "zone": {
            "level": "sublocality_level2",
            "code": "21009A00-",
            "name": "21009A00-"
          },
          "sample_size": 1566,
          "reliability": "high",
          "range": null,
          "definition": "taxable_income_median_per_return",
          "updated_on": "2026-10-09",
          "stale": false
        }
      },
      "housing": {
        "dwellings": {
          "value": 1732,
          "unit": "count",
          "period": {
            "start": "2021-01-01",
            "end": "2021-12-31"
          },
          "zone": {
            "level": "sublocality_level2",
            "code": "21009A00-",
            "name": "21009A00-"
          },
          "sample_size": null,
          "reliability": "high",
          "range": null,
          "definition": "dwellings_count",
          "updated_on": "2026-10-09",
          "stale": false
        },
        "houses_share": {
          "value": 3.2,
          "unit": "%",
          "period": {
            "start": "2021-01-01",
            "end": "2021-12-31"
          },
          "zone": {
            "level": "sublocality_level2",
            "code": "21009A00-",
            "name": "21009A00-"
          },
          "sample_size": 1732,
          "reliability": "high",
          "range": null,
          "definition": "houses_share",
          "updated_on": "2026-10-09",
          "stale": false
        }
      },
      "missing": {}
    }
  },
  "meta": {
    "request_id": "req_6WB1F8KD3QS9TN",
    "api_version": "1.0",
    "generated_at": "2026-10-12T09:08:12Z",
    "warnings": [],
    "sandbox": false
  }
}

Risques

Les aléas au point et les sols pollués autour, en Région de Bruxelles-Capitale.
Endpoint
GET https://app.open-connect.io/api/v1/be/risks
Query Parameters
Parameter Type Description
lat, lng, address Voir Localiser
radius entier Rayon des sols pollués, en mètres, de 100 à 2000 ; 500 par défaut
locale chaîne fr ou en
Réponse : data.risks
Champ Type Description
hazards[] liste d'Aléas Aléa d'inondation au point, en Région de Bruxelles-Capitale
not_assessed[] liste Types d'aléas que nous ne savons pas évaluer ici, ou dont le point est hors des secteurs cartographiés
summary objet highest_level, notable[] (aléas de niveau moderate ou plus), assessed[], not_assessed[]. Hors de Bruxelles, le domaine répond not_covered
polluted_sites.inside[] liste Parcelles polluées ou suspectées de l'être qui contiennent le point : à signaler à l'acheteur
polluted_sites.counts objet Nombre de parcelles par type dans le rayon
polluted_sites.items[] liste Les plus proches : type (contaminated_land, suspected_land), status (suspected : pollution présumée ; confirmed : pollution constatée ; under_treatment : pollution en cours d'étude ou de traitement), distance_m
Une parcelle reconnue non polluée n'est pas un site pollué : elle n'est pas servie.
{
  "data": {
    "risks": {
      "status": "ok",
      "hazards": [],
      "not_assessed": [],
      "summary": {
        "highest_level": null,
        "notable": [],
        "assessed": [
          "flood"
        ],
        "not_assessed": []
      },
      "polluted_sites": {
        "inside": [
          {
            "type": "suspected_land",
            "status": "suspected",
            "distance_m": 0
          }
        ],
        "counts": {
          "suspected_land": 62,
          "contaminated_land": 88
        },
        "items": [
          {
            "type": "suspected_land",
            "status": "suspected",
            "distance_m": 0
          },
          {
            "type": "suspected_land",
            "status": "suspected",
            "distance_m": 58
          },
          {
            "type": "contaminated_land",
            "status": "under_treatment",
            "distance_m": 70
          },
          {
            "type": "contaminated_land",
            "status": "confirmed",
            "distance_m": 76
          },
          {
            "type": "suspected_land",
            "status": "suspected",
            "distance_m": 77
          },
          {
            "type": "contaminated_land",
            "status": "confirmed",
            "distance_m": 90
          }
        ]
      },
      "missing": {}
    }
  },
  "meta": {
    "request_id": "req_5DP8T1KV3NM6QX",
    "api_version": "1.0",
    "generated_at": "2026-10-12T09:06:31Z",
    "warnings": [],
    "sandbox": false
  }
}

Marché

Le prix médian des ventes dans la commune, et ce qui se construit autour. Le prix d'une vente une à une n'est pas publié : le marché se lit à la commune.
Endpoints
GET https://app.open-connect.io/api/v1/be/market
GET https://app.open-connect.io/api/v1/be/market/permits
La seconde route sert la liste complète, paginée, des autorisations d'urbanisme autour du point, en Flandre (page, per_page jusqu'à 100).
Query Parameters
Parameter Type Description
lat, lng, address Voir Localiser
property_type chaîne apartment ou house : ne sert que le prix de ce type
radius entier Rayon des autorisations, de 100 à 2000 ; 500 par défaut
locale chaîne fr ou en
Réponse : data.market
Champ Type Description
sale_price_median objet \ null
permits_nearby objet \ null
{
  "data": {
    "market": {
      "status": "ok",
      "sale_price_median": {
        "apartment": {
          "value": 342000,
          "unit": "EUR",
          "period": {
            "start": "2025-01-01",
            "end": "2025-12-31"
          },
          "zone": {
            "level": "locality",
            "code": "21009",
            "name": "Ixelles"
          },
          "sample_size": 1023,
          "reliability": "high",
          "range": null,
          "definition": "sale_price_median",
          "updated_on": "2026-10-09",
          "stale": false
        },
        "house": {
          "value": 785000,
          "unit": "EUR",
          "period": {
            "start": "2025-01-01",
            "end": "2025-12-31"
          },
          "zone": {
            "level": "locality",
            "code": "21009",
            "name": "Ixelles"
          },
          "sample_size": 116,
          "reliability": "high",
          "range": null,
          "definition": "sale_price_median",
          "updated_on": "2026-10-09",
          "stale": false
        }
      },
      "permits_nearby": null,
      "missing": {
        "permits_nearby": "not_covered"
      }
    }
  },
  "meta": {
    "request_id": "req_W8RQ2D6KNV3TJX",
    "api_version": "1.0",
    "generated_at": "2026-10-11T05:16:02Z",
    "warnings": [],
    "sandbox": false
  }
}

Lieux

Les lieux du quotidien et les arrêts de transport autour du point, rangés dans la taxonomie d'open-connect : écoles, santé et transports.
Endpoint
GET https://app.open-connect.io/api/v1/be/places
Query Parameters
Parameter Type Description
lat, lng, address Voir Localiser
radius entier Rayon en mètres, de 100 à 2000 ; 1000 par défaut
category chaîne Un groupe ou une catégorie de la taxonomie : school, transport.tram
page, per_page entier Pagination de items ; per_page jusqu'à 100
locale chaîne fr ou en
Réponse : data.places
Champ Type Description
counts objet Lieux dans le rayon par groupe : transport, health, school
items[] liste de Lieux Du plus proche au plus loin
{
  "data": {
    "places": {
      "status": "ok",
      "counts": {
        "transport": 33,
        "health": 26,
        "school": 30
      },
      "items": [
        {
          "id": "plc_76CD8B24",
          "category": "transport.bus",
          "name": "FERNAND COCQ",
          "address": null,
          "latitude": 50.833057,
          "longitude": 4.366481,
          "distance_m": 81,
          "walk_minutes": 1,
          "lines": [
            "54",
            "71",
            "N09",
            "N10"
          ]
        },
        {
          "id": "plc_34078A1B",
          "category": "school.kindergarten",
          "name": "GO! Basisschool De Wimpel Elsene",
          "address": "Cansstraat 14 - 1050 Elsene",
          "latitude": 50.833301,
          "longitude": 4.36861,
          "distance_m": 112,
          "walk_minutes": 1,
          "lines": null
        },
        {
          "id": "plc_69640666",
          "category": "health.pharmacy",
          "name": "Pharmacie",
          "address": "place Fernand Cocq 26 - 1050 Ixelles",
          "latitude": 50.8336107,
          "longitude": 4.3665379,
          "distance_m": 125,
          "walk_minutes": 2,
          "lines": null
        },
        {
          "id": "plc_7E17E225",
          "category": "school.kindergarten",
          "name": "Ecole fondamentale libre Le Jardin des Ecoliers",
          "address": "Rue de la Croix 37 - 1050 Ixelles",
          "latitude": 50.8311939,
          "longitude": 4.3656009,
          "distance_m": 205,
          "walk_minutes": 3,
          "lines": null
        },
        {
          "id": "plc_5DE011C6",
          "category": "health.pharmacy",
          "name": "Pharmacie",
          "address": "rue du Conseil 44 - 1050 Ixelles",
          "latitude": 50.8344834,
          "longitude": 4.3690492,
          "distance_m": 236,
          "walk_minutes": 3,
          "lines": null
        },
        {
          "id": "plc_CFD5E93E",
          "category": "school.primary",
          "name": "Ecole d'enseignement primaire spécialisé libre \"Etoile du Berger\"",
          "address": "Rue de la Croix 39 - 1050 Ixelles",
          "latitude": 50.8309702,
          "longitude": 4.3653059,
          "distance_m": 237,
          "walk_minutes": 3,
          "lines": null
        },
        {
          "id": "plc_44B8AD0E",
          "category": "school.training",
          "name": "Centre Scolaire Eperonniers-Mercelis",
          "address": "Rue Mercelis 36-38 - 1050 Ixelles",
          "latitude": 50.8314141,
          "longitude": 4.3644583,
          "distance_m": 248,
          "walk_minutes": 3,
          "lines": null
        },
        {
          "id": "plc_08196E42",
          "category": "school.high_school",
          "name": "Centre Scolaire Eperonniers-Mercelis",
          "address": "Rue Mercelis 36-38 - 1050 Ixelles",
          "latitude": 50.8314141,
          "longitude": 4.3644583,
          "distance_m": 248,
          "walk_minutes": 3,
          "lines": null
        }
      ],
      "missing": {}
    }
  },
  "meta": {
    "request_id": "req_2KW6Q9FB4TC1HM",
    "api_version": "1.0",
    "generated_at": "2026-10-12T09:06:58Z",
    "warnings": [],
    "sandbox": false
  }
}

Accès

Se déplacer depuis le bien : la gare, l'aéroport, l'accès autoroutier et l'école les plus proches, à vol d'oiseau, et les listes autour.
Endpoint
GET https://app.open-connect.io/api/v1/be/access
Réponse : data.access
Champ Type Description
nearest.station Lieu \ null
nearest.airport Lieu \ null
nearest.highway_access Lieu \ null
nearest.school Lieu \ null
stations[], airports[], highway_accesses[], fuel_stations[], charging_stations[] listes de Lieux Les plus proches de chaque sorte
{
  "data": {
    "access": {
      "status": "ok",
      "nearest": {
        "station": {
          "id": "plc_FC211F1C",
          "category": "transport.train_station",
          "name": "Bruxelles-Luxembourg - Brussel-Luxemburg",
          "address": null,
          "latitude": 50.8381995,
          "longitude": 4.3736537,
          "distance_m": 758,
          "walk_minutes": 9,
          "lines": null
        },
        "airport": {
          "id": "plc_596ABE8B",
          "category": "transport.airport",
          "name": "Brussels Airport",
          "address": null,
          "latitude": 50.9008694,
          "longitude": 4.4887587,
          "distance_m": 11406,
          "walk_minutes": 143,
          "lines": null
        },
        "highway_access": {
          "id": "plc_F7F7871E",
          "category": "transport.highway_access",
          "name": "Anderlecht-Industrie",
          "address": null,
          "latitude": 50.8078012,
          "longitude": 4.3020968,
          "distance_m": 5355,
          "walk_minutes": 67,
          "lines": null
        },
        "school": {
          "id": "plc_7B898E3C",
          "category": "school.kindergarten",
          "name": "GO! Basisschool De Wimpel Elsene",
          "address": "Cansstraat 14 - 1050 Elsene",
          "latitude": 50.833301,
          "longitude": 4.36861,
          "distance_m": 112,
          "walk_minutes": 1,
          "lines": null
        }
      },
      "stations": [
        {
          "id": "plc_FC211F1C",
          "category": "transport.train_station",
          "name": "Bruxelles-Luxembourg - Brussel-Luxemburg",
          "address": null,
          "latitude": 50.8381995,
          "longitude": 4.3736537,
          "distance_m": 758,
          "walk_minutes": 9,
          "lines": null
        },
        {
          "id": "plc_1AE36478",
          "category": "transport.train_station",
          "name": "Germoir - Mouterij",
          "address": null,
          "latitude": 50.8302302,
          "longitude": 4.3795264,
          "distance_m": 891,
          "walk_minutes": 11,
          "lines": null
        }
      ],
      "airports": [
        {
          "id": "plc_596ABE8B",
          "category": "transport.airport",
          "name": "Brussels Airport",
          "address": null,
          "latitude": 50.9008694,
          "longitude": 4.4887587,
          "distance_m": 11406,
          "walk_minutes": 143,
          "lines": null
        },
        {
          "id": "plc_592AB221",
          "category": "transport.airport",
          "name": "Internationale Luchthaven Antwerpen",
          "address": null,
          "latitude": 51.1888737,
          "longitude": 4.4626453,
          "distance_m": 40169,
          "walk_minutes": 502,
          "lines": null
        }
      ],
      "highway_accesses": [
        {
          "id": "plc_F7F7871E",
          "category": "transport.highway_access",
          "name": "Anderlecht-Industrie",
          "address": null,
          "latitude": 50.8078012,
          "longitude": 4.3020968,
          "distance_m": 5355,
          "walk_minutes": 67,
          "lines": null
        },
        {
          "id": "plc_39286FD1",
          "category": "transport.highway_access",
          "name": "Anderlecht-Industrie",
          "address": null,
          "latitude": 50.8111107,
          "longitude": 4.2973685,
          "distance_m": 5472,
          "walk_minutes": 68,
          "lines": null
        }
      ],
      "fuel_stations": [
        {
          "id": "plc_C12F75F9",
          "category": "transport.fuel",
          "name": "Cado",
          "address": null,
          "latitude": 50.8308488,
          "longitude": 4.3714941,
          "distance_m": 348,
          "walk_minutes": 4,
          "lines": null
        },
        {
          "id": "plc_48323DE5",
          "category": "transport.fuel",
          "name": "Shell",
          "address": null,
          "latitude": 50.8275445,
          "longitude": 4.374124,
          "distance_m": 736,
          "walk_minutes": 9,
          "lines": null
        }
      ],
      "charging_stations": [
        {
          "id": "plc_9361C42A",
          "category": "transport.charging_station",
          "name": "Borne de recharge",
          "address": null,
          "latitude": 50.830367,
          "longitude": 4.3692804,
          "distance_m": 284,
          "walk_minutes": 4,
          "lines": null
        },
        {
          "id": "plc_3824F06D",
          "category": "transport.charging_station",
          "name": "Borne de recharge",
          "address": null,
          "latitude": 50.8313191,
          "longitude": 4.3718441,
          "distance_m": 343,
          "walk_minutes": 4,
          "lines": null
        }
      ],
      "missing": {}
    }
  },
  "meta": {
    "request_id": "req_3HD8W5KQ1ZT6NB",
    "api_version": "1.0",
    "generated_at": "2026-10-12T06:41:09Z",
    "warnings": [],
    "sandbox": false
  }
}

Habitants

Qui vit dans le quartier, au secteur statistique (sublocality_level2).
Endpoint
GET https://app.open-connect.io/api/v1/be/residents
Réponse : data.residents
Champ Type Description
income.taxable_median Mesure Revenu imposable médian par déclaration fiscale, en EUR par an
housing.dwellings Mesure Logements recensés
housing.houses_share Mesure Part des maisons parmi les logements, en %
{
  "data": {
    "residents": {
      "status": "ok",
      "income": {
        "taxable_median": {
          "value": 24361,
          "unit": "EUR/year",
          "period": {
            "start": "2023-01-01",
            "end": "2023-12-31"
          },
          "zone": {
            "level": "sublocality_level2",
            "code": "21009A00-",
            "name": "21009A00-"
          },
          "sample_size": 1566,
          "reliability": "high",
          "range": null,
          "definition": "taxable_income_median_per_return",
          "updated_on": "2026-10-09",
          "stale": false
        }
      },
      "housing": {
        "dwellings": {
          "value": 1732,
          "unit": "count",
          "period": {
            "start": "2021-01-01",
            "end": "2021-12-31"
          },
          "zone": {
            "level": "sublocality_level2",
            "code": "21009A00-",
            "name": "21009A00-"
          },
          "sample_size": null,
          "reliability": "high",
          "range": null,
          "definition": "dwellings_count",
          "updated_on": "2026-10-09",
          "stale": false
        },
        "houses_share": {
          "value": 3.2,
          "unit": "%",
          "period": {
            "start": "2021-01-01",
            "end": "2021-12-31"
          },
          "zone": {
            "level": "sublocality_level2",
            "code": "21009A00-",
            "name": "21009A00-"
          },
          "sample_size": 1732,
          "reliability": "high",
          "range": null,
          "definition": "houses_share",
          "updated_on": "2026-10-09",
          "stale": false
        }
      },
      "missing": {}
    }
  },
  "meta": {
    "request_id": "req_7MT2C5XJ8RD4WP",
    "api_version": "1.0",
    "generated_at": "2026-10-12T09:07:20Z",
    "warnings": [],
    "sandbox": false
  }
}

Urbanisme

Ce que dit la règle d'urbanisme au point : le document applicable, la zone, et ce qui s'y ajoute.
Endpoint
GET https://app.open-connect.io/api/v1/be/urbanism
Query Parameters
Parameter Type Description
lat, lng, address Voir Localiser
geometry booléen true : sert le contour de la zone et de la parcelle en GeoJSON. Par défaut false
locale chaîne fr ou en
Réponse : data.urbanism
Champ Type Description
document objet \ null
zone objet \ null
Ces informations sont indicatives : seul le certificat d'urbanisme engage la commune.

Zones

Le marché et les habitants d'une zone, sans position : les prix d'une commune, les revenus d'un secteur statistique.
Endpoint
GET https://app.open-connect.io/api/v1/be/zones/{level}/{code}
Paramètre de chemin Description
level Un niveau de zone
code Le code de la zone, tel que le sert data.location.zones
Par exemple, la commune d'Ixelles : GET /zones/locality/21009 ; un de ses secteurs statistiques : GET /zones/sublocality_level2/21009A101.
Query Parameters
Parameter Type Description
include chaîne market, residents, ou les deux (par défaut)
geometry booléen true : sert le contour de la zone en GeoJSON, simplifié
locale chaîne fr ou en
La réponse porte la zone, ses zones parentes et les valeurs publiées pour elle, avec la même forme que les domaines. Seules les valeurs publiées pour ce niveau sont servies : une zone ne reçoit pas la valeur d'une zone plus large. Le revenu médian n'est publié qu'au secteur statistique : la commune ne le reçoit pas.
{
  "data": {
    "zone": {
      "level": "locality",
      "code": "21009",
      "name": "Ixelles"
    },
    "parents": [
      {
        "level": "country",
        "code": "BE",
        "name": "Belgique"
      },
      {
        "level": "administrative_area_level1",
        "code": "04000",
        "name": "Région de Bruxelles-Capitale"
      },
      {
        "level": "administrative_area_level3",
        "code": "21000",
        "name": "Arrondissement de Bruxelles-Capitale"
      }
    ],
    "market": {
      "status": "ok",
      "sale_price_median": {
        "apartment": {
          "value": 342000,
          "unit": "EUR",
          "period": {
            "start": "2025-01-01",
            "end": "2025-12-31"
          },
          "zone": {
            "level": "locality",
            "code": "21009",
            "name": "Ixelles"
          },
          "sample_size": 1023,
          "reliability": "high",
          "range": null,
          "definition": "sale_price_median",
          "updated_on": "2026-10-09",
          "stale": false
        },
        "house": {
          "value": 785000,
          "unit": "EUR",
          "period": {
            "start": "2025-01-01",
            "end": "2025-12-31"
          },
          "zone": {
            "level": "locality",
            "code": "21009",
            "name": "Ixelles"
          },
          "sample_size": 116,
          "reliability": "high",
          "range": null,
          "definition": "sale_price_median",
          "updated_on": "2026-10-09",
          "stale": false
        }
      },
      "missing": {}
    },
    "residents": {
      "status": "ok",
      "housing": {
        "dwellings": {
          "value": 58445,
          "unit": "count",
          "period": {
            "start": "2021-01-01",
            "end": "2021-12-31"
          },
          "zone": {
            "level": "locality",
            "code": "21009",
            "name": "Ixelles"
          },
          "sample_size": null,
          "reliability": "high",
          "range": null,
          "definition": "dwellings_count",
          "updated_on": "2026-10-09",
          "stale": false
        },
        "houses_share": {
          "value": 6.3,
          "unit": "%",
          "period": {
            "start": "2021-01-01",
            "end": "2021-12-31"
          },
          "zone": {
            "level": "locality",
            "code": "21009",
            "name": "Ixelles"
          },
          "sample_size": 58445,
          "reliability": "high",
          "range": null,
          "definition": "houses_share",
          "updated_on": "2026-10-09",
          "stale": false
        }
      },
      "missing": {
        "income": "not_covered"
      }
    }
  },
  "meta": {
    "request_id": "req_9HQ4N7VZ2LB5XF",
    "api_version": "1.0",
    "generated_at": "2026-10-12T09:07:45Z",
    "warnings": [],
    "sandbox": false
  }
}
Les zones enfants d'une zone (les secteurs statistiques d'une commune, les communes d'un arrondissement) :
GET https://app.open-connect.io/api/v1/be/zones/{level}/{code}/children

Catalogue

Ce que l'API de ce pays sait servir, la définition de chaque champ, les territoires qu'il couvre et son rythme de mise à jour. Ces routes ne consomment pas d'unité.

Liste des domaines

Les domaines, leurs routes et leurs champs.
GET https://app.open-connect.io/api/v1/be/catalog/domains
{
  "data": {
    "domains": [
      {
        "id": "location",
        "label": "Adresse et position",
        "routes": [
          "/api/v1/be/location"
        ],
        "fields": [
          "latitude",
          "longitude",
          "precision",
          "address",
          "geocoding",
          "zones"
        ]
      },
      {
        "id": "risks",
        "label": "Risques",
        "routes": [
          "/api/v1/be/risks"
        ],
        "fields": [
          "hazards",
          "not_assessed",
          "summary",
          "polluted_sites"
        ]
      },
      {
        "id": "market",
        "label": "Marché",
        "routes": [
          "/api/v1/be/market",
          "/api/v1/be/market/permits"
        ],
        "fields": [
          "sale_price_median",
          "permits_nearby"
        ]
      },
      {
        "id": "places",
        "label": "Lieux",
        "routes": [
          "/api/v1/be/places"
        ],
        "fields": [
          "counts",
          "items"
        ]
      },
      {
        "id": "access",
        "label": "Accès",
        "routes": [
          "/api/v1/be/access"
        ],
        "fields": [
          "nearest",
          "stations",
          "airports",
          "highway_accesses",
          "fuel_stations",
          "charging_stations"
        ]
      },
      {
        "id": "residents",
        "label": "Habitants",
        "routes": [
          "/api/v1/be/residents"
        ],
        "fields": [
          "income",
          "housing"
        ]
      },
      {
        "id": "urbanism",
        "label": "Urbanisme",
        "routes": [
          "/api/v1/be/urbanism"
        ],
        "fields": [
          "document",
          "zone"
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_T7KC1V5MQX9DWB",
    "api_version": "1.0",
    "generated_at": "2026-10-12T08:17:03Z",
    "warnings": [],
    "sandbox": false
  }
}

Définitions des champs

La définition de chaque champ : ce qu'il mesure, son unité, son rythme de mise à jour, et sa couverture quand elle ne s'étend pas à tout le pays (coverage : available, ou partial avec les territoires couverts).
GET https://app.open-connect.io/api/v1/be/catalog/fields
{
  "data": {
    "fields": [
      {
        "definition": "sale_price_median",
        "label": "Prix médian d'une vente sur l'année, pour le type de bien du champ",
        "unit": "EUR",
        "update_frequency": "yearly",
        "coverage": {
          "status": "available"
        }
      },
      {
        "definition": "taxable_income_median_per_return",
        "label": "Revenu imposable médian par déclaration fiscale",
        "unit": "EUR/year",
        "update_frequency": "yearly",
        "coverage": {
          "status": "available"
        }
      },
      {
        "definition": "dwellings_count",
        "label": "Logements recensés",
        "unit": "count",
        "update_frequency": "yearly",
        "coverage": {
          "status": "available"
        }
      },
      {
        "definition": "houses_share",
        "label": "Part des maisons parmi les logements",
        "unit": "%",
        "update_frequency": "yearly",
        "coverage": {
          "status": "available"
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_N4DQ8T2WXK6HVZ",
    "api_version": "1.0",
    "generated_at": "2026-10-12T08:17:20Z",
    "warnings": [],
    "sandbox": false
  }
}

Catégories de lieux

La taxonomie des lieux : groupes, catégories et libellés.
GET https://app.open-connect.io/api/v1/be/catalog/categories?locale=fr

Liste des aléas

Les types d'aléas servis dans ce pays, et pour chacun ce que veut dire chaque niveau.
GET https://app.open-connect.io/api/v1/be/catalog/hazards?locale=fr

Conditions d'utilisation des données

Les données servies proviennent de sources publiques réutilisables sous licences ouvertes, rassemblées, contrôlées et unifiées par open-connect. open-connect facture ce service (collecte, contrôle, unification, disponibilité), pas la donnée elle-même.
  • Mention : là où vous affichez des données d'open-connect, affichez la mention « Données open-connect, d'après des sources publiques », avec un lien vers la page de crédits qui recense les producteurs et leurs licences.
  • Personnes : ne cherchez pas à identifier une personne à partir des données servies, ni à les croiser avec des données nominatives. open-connect ne sert aucune donnée qui désigne un particulier : ni nom de propriétaire, ni demandeur d'autorisation d'urbanisme, ni entrepreneur individuel, ni praticien de santé libéral (servi par sa catégorie et son adresse, sans son nom), ni coordonnées personnelles. Les entreprises sont servies sous leur dénomination sociale.
  • Rediffusion : les données servies ne peuvent pas être rediffusées en masse, ni servir à constituer une base de données mise à la disposition de tiers.

Fraîcheur

Chaque indicateur a son rythme de mise à jour : quotidien pour certains, annuel pour la plupart des statistiques ; le catalogue des champs le donne (update_frequency). open-connect vérifie chaque donnée au moins à ce rythme et publie une nouvelle valeur dans les jours qui suivent sa parution.
  • updated_on de chaque mesure : date de notre dernière mise à jour de la valeur.
  • stale de chaque mesure : true quand la valeur n'a pas été vérifiée depuis plus longtemps que son rythme le prévoit ; elle reste servie, mais il est prudent de le signaler.
  • period de chaque mesure : la période réellement décrite. Une statistique publiée en 2026 peut décrire 2023.