Ship France without owning the national data plumbing.Lancez la France sans maintenir toute la plomberie nationale des données.

1. Quickstart

Use the direct PropData production edge and explicitly scope France requests with country=FR. REST credentials belong only in the x-api-key header.Utilisez l’edge de production PropData et définissez explicitement country=FR. Les identifiants REST doivent uniquement être transmis dans l’en-tête x-api-key.

Node.js / server-side fetch

2. Authentication

Direct REST uses a static PropData API credential in the x-api-key header. Keep production keys in a trusted backend, Worker, server or edge secret. Never place them in URLs, browser bundles, repositories, screenshots or analytics.REST direct utilise une clé PropData dans l’en-tête x-api-key. Conservez les clés en secret côté serveur, Worker ou edge. Ne les placez jamais dans les URL, bundles navigateur, dépôts, captures ou analytics.

3. Country scope

country=FR selects the France adapter. That adapter is responsible for France-native identity, source routing, coverage semantics and provenance rather than forcing French property data into a U.S.-specific model.sélectionne l’adaptateur France. Celui-ci conserve l’identité, le routage des sources, la couverture et la provenance propres à la France.

4. France data model

France is not modeled as one giant flat table. The operating graph keeps identifiers and evidence domains distinct so an address can resolve a parcel without becoming the parcel identifier, and a DVF mutation can attach to a property without being mistaken for current ownership.La France n’est pas modélisée comme une table plate. Le graphe conserve les domaines d’identifiants et de preuves séparés : une adresse peut résoudre une parcelle sans devenir son identifiant, et une mutation DVF peut être rattachée sans être confondue avec la propriété actuelle.

5. Cadastral parcel identity

French cadastral identity is hierarchical. A useful integration preserves department/commune/section/parcel semantics rather than collapsing them into an opaque vendor ID. Official IGN documentation describes the national cadastral fabric at roughly 100 million parcels.L’identité cadastrale française est hiérarchique. Une intégration utile conserve département/commune/section/parcelle plutôt que de les remplacer par un identifiant fournisseur opaque. La documentation IGN décrit un parcellaire national d’environ 100 millions de parcelles.

• Do not treat a street address as the canonical parcel identifier.Ne traitez pas une adresse comme identifiant parcellaire canonique.
• Do not promote a fuzzy/nearby parcel candidate as an exact match.Ne promouvez pas une parcelle proche ou approximative comme match exact.
• Preserve source-native components so downstream systems can trace the parcel back to the cadastral system.Conservez les composants natifs pour assurer la traçabilité vers le cadastre.

6. BAN address intelligence

The Base Adresse Nationale is the national address system. Current public deployment pages report 26.11 million addresses, with certification and local-address-base coverage varying by commune. PropData should preserve that distinction: address presence, local-source status and certification are not the same signal.La Base Adresse Nationale est le système national d’adresse. Les pages publiques actuelles indiquent 26,11 millions d’adresses ; la certification et la couverture par Bases Adresses Locales varient selon les communes. PropData conserve ces états séparément.

7. Buildings / RNB / BD TOPO

France’s national building reference adds a durable building-level identity above the parcel layer. IGN’s 2026 publication notes that the national building-reference identifier was added across 49 million buildings in BD TOPO. This gives property applications a built-environment join surface beyond parcel boundaries.Le référentiel national des bâtiments ajoute une identité durable au niveau bâtiment. Une publication IGN 2026 indique l’ajout de l’identifiant du référentiel sur 49 millions de bâtiments dans BD TOPO. Cela crée une couche de jointure bâtie au-delà de la limite parcellaire.

• A parcel can contain zero, one or multiple building objects.Une parcelle peut contenir zéro, un ou plusieurs bâtiments.
• Building identity and parcel identity must remain separate.Identité bâtiment et identité parcelle doivent rester distinctes.
• If the building layer is unavailable, return unavailable/null rather than synthesizing a building from the address.Si la couche bâtiment est indisponible, retournez indisponible/nul plutôt que de la déduire de l’adresse.

8. DVF transaction evidence

Demandes de valeurs foncières (DVF) publishes real-estate transactions from notarial acts and cadastral information. The public explorer covers the previous five years and was updated in April 2026. Current explorer totals surface about 4.49 million apartment/house sales.Les Demandes de valeurs foncières (DVF) publient les mutations immobilières issues des actes notariés et informations cadastrales. L’explorateur public couvre les cinq dernières années et a été mis à jour en avril 2026. Il affiche actuellement environ 4,49 millions de ventes appartements/maisons.

DVF is not a current-ownership registerDVF n’est pas un registre de propriété actuelle

A mutation proves a recorded transaction event. It should not be presented as proof of current ownership unless a separate lawful ownership source supports that conclusion.Une mutation prouve un événement de transaction enregistré. Elle ne doit pas être présentée comme preuve de propriété actuelle sans source légale distincte.

9. Geometry & coordinates

Coordinate workflows use WGS84 at the API boundary. A coordinate-to-property request should only resolve when promoted parcel geometry supports deterministic containment. A point-in-polygon result is spatial evidence, not proof of an exact postal address.Les workflows coordonnées utilisent WGS84 à l’API. Une requête coordonnée → propriété ne doit résoudre que lorsque la géométrie parcellaire promue permet un containment déterministe. Un résultat point-dans-polygone est une preuve spatiale, pas une preuve d’adresse postale exacte.

• Use latitude/longitude in WGS84.
• Probe coverage before depending on coordinate resolution at scale.
• Do not invent a parcel polygon when geometry is not promoted.
• Persist source/revision context when storing geometry downstream.

10. Coverage contract

“France coverage” is not one boolean. Cadastre, BAN certification, building context and DVF transaction coverage have different publication rules and refresh cycles. PropData makes each layer’s availability explicit.La « couverture France » n’est pas un booléen unique. Cadastre, certification BAN, bâtiment et DVF ont des règles et cycles différents. PropData rend la disponibilité de chaque couche explicite.

11. Provenance & freshness

PropData’s country contract is designed to carry enough evidence to explain why a fact exists: producer, source family, geographic scope, revision/release context and coverage state where exposed. Preserve those fields when they matter to your audit or update logic.Le contrat pays PropData est conçu pour conserver suffisamment de preuves : producteur, famille source, portée géographique, révision/version et état de couverture lorsque disponibles. Conservez ces champs lorsqu’ils sont nécessaires à l’audit ou aux mises à jour.

12. Response semantics

A successful property response may still contain unavailable layers. Missing building context, transaction evidence or geometry must remain unavailable/null—not converted to zero, false or “none exists.”Une réponse propriété réussie peut contenir des couches indisponibles. Bâtiment, transaction ou géométrie absents doivent rester indisponibles/nuls, et non devenir zéro, faux ou « inexistant ».

13. Route catalog

These existing PropData routes participate in the country-aware framework. The France adapter uses country=FR; exact France layer availability remains governed by the response coverage contract.Ces routes PropData existantes participent au framework multi-pays. L’adaptateur France utilise country=FR ; la disponibilité exacte des couches reste gouvernée par la couverture retournée.

14. Errors, limits & retries

Separate authentication, entitlement, validation, not-found/coverage, rate-limit and transient-upstream failures. Do not blindly retry every non-2xx response.Séparez les échecs d’authentification, droits, validation, couverture/not-found, rate-limit et upstream transitoire. Ne retryez pas aveuglément chaque non-2xx.

15. Account usage

Use GET /v1/auth/usage as the authoritative account contract. Marketing-plan limits are not a substitute because contracted or legacy accounts can differ.Utilisez GET /v1/auth/usage comme contrat autoritatif du compte. Les quotas marketing ne remplacent pas cette route car certains comptes peuvent avoir des contrats différents.

16. OAuth MCP

PropData MCP uses OAuth in compatible AI clients and is distinct from direct REST authentication. Never paste a static REST key into an MCP authorization flow.PropData MCP utilise OAuth dans les clients IA compatibles et reste distinct de l’authentification REST directe. Ne collez jamais une clé REST statique dans un flux MCP.

17. France Dashboard

The France Dashboard is a local country operating surface—not a redirect. It validates a connected PropData credential against live /v1/auth/usage, runs France-locked requests, displays raw responses, exposes coverage/source guidance and keeps France plans inside the country product.Le Dashboard France est une surface opérationnelle locale, pas une redirection. Il valide la clé PropData via /v1/auth/usage, exécute des requêtes bloquées sur la France, affiche les réponses brutes, la couverture/sources et les plans France.

18. Official sources & licences

Cadastre / DGFiP / IGN distribution

The cadastral parcel fabric is the land-identity foundation. IGN’s official cadastral documentation describes the national system at roughly 100 million parcels and documents the geometry/reference products built from DGFiP cadastral plans.Le parcellaire cadastral est la fondation d’identité foncière. La documentation officielle IGN décrit environ 100 millions de parcelles et les produits géométriques issus des plans DGFiP.

Base Adresse Nationale

BAN is the national address source system. Certification/local-source state varies geographically and should remain visible in downstream quality semantics.BAN est la source nationale d’adresse. La certification et l’origine locale varient géographiquement et doivent rester visibles dans les sémantiques qualité.

RNB / BD TOPO

The national building reference creates a durable building identity, while BD TOPO provides the broader built-environment context used by many geospatial workflows.Le RNB crée une identité durable du bâtiment tandis que BD TOPO fournit le contexte bâti plus large.

DVF

DVF is produced/published by DGFiP and derives from notarial acts and cadastral information. Public files cover five years and are updated semi-annually. Published geographic exclusions must be honored.DVF est produit/publié par la DGFiP à partir d’actes notariés et d’informations cadastrales. Les fichiers publics couvrent cinq ans et sont mis à jour semestriellement. Les exclusions géographiques publiées doivent être respectées.

cadastre.data.gouv.fr → · adresse.data.gouv.fr → · RNB → · DVF explorer →

19. Production checklist