Valeur vénale succession : l'estimer par API DVF (2026)

Valeur vénale pour une succession : la réponse en 3 lignes

La valeur vénale d'un bien pour une succession est son prix de marché au jour du décès, déterminé par la méthode des comparables : on prend les ventes réelles de biens similaires dans le secteur, issues des données DVF, sur les mois précédant le décès.

L'administration fiscale s'appuie elle-même sur le DVF (via l'outil Patrim) pour contrôler les déclarations. Reproduire sa méthode par API permet de sécuriser l'estimation et d'éviter un redressement fiscal pour sous-évaluation. Cet article détaille la définition, la méthode, le code, et les pièges.

Qu'est-ce que la valeur vénale d'un bien dans une succession ?

La valeur vénale est le prix auquel un bien pourrait être vendu sur le marché libre, dans des conditions normales, au jour du fait générateur de l'impôt. Dans une succession, ce jour est la date du décès ; dans une donation, la date de l'acte. C'est cette valeur qui sert d'assiette aux droits de mutation à titre gratuit.

La valeur au jour du décès, pas le prix d'achat

Erreur classique : déclarer le prix payé jadis par le défunt, ou un prix « optimiste si on refait la cuisine ». La valeur vénale succession est le prix que le marché accepterait aujourd'hui pour ce bien, dans son état réel, à la date exacte du décès. Une estimation a une validité opérationnelle d'environ 6 mois : au-delà, le marché a bougé et la référence n'est plus défendable.

Le délai de 6 mois pour déclarer

Les héritiers disposent d'un délai de 6 mois après le décès pour déposer la déclaration de succession et donc fixer la valeur vénale de chaque bien. Ce délai impose de dater l'estimation : il faut sélectionner des ventes comparables antérieures au décès (idéalement sur les 6 à 12 mois précédant la date), et non des ventes postérieures qui refléteraient un autre état du marché.

Comment l'administration fiscale estime-t-elle la valeur vénale ?

Point décisif et trop souvent ignoré : pour contrôler une déclaration de succession, l'administration fiscale utilise exactement les mêmes données que celles accessibles par API. Elle s'appuie sur la base des Demandes de valeurs foncières (DVF), qui recense toutes les ventes des dernières années, exposée aux particuliers via l'outil Patrim (accessible depuis l'espace impots.gouv.fr).

La méthode officielle est la méthode par comparaison : l'agent du fisc recherche les ventes de biens similaires (même type, surface proche, même secteur) à une date proche du fait générateur, et en déduit un prix au m² de référence. Pour les biens loués, une méthode par capitalisation des revenus peut compléter l'analyse. En cas de désaccord, seuls des éléments comparatifs probants — des ventes réelles documentées — font foi face à l'administration. Reproduire cette méthode en amont, avec les mêmes données, est donc la meilleure défense.

Comment estimer la valeur vénale d'une succession via l'API DVF ?

La logique est celle de la méthode des comparables (AVM), mais calée sur une contrainte fiscale : la date du décès. On interroge l'API DVF pour récupérer les mutations comparables autour du bien, filtrées sur une fenêtre temporelle se terminant à la date du décès, puis on en déduit un prix au m² médian appliqué à la surface du bien.

Sélectionner les bonnes ventes comparables

La qualité de la valeur vénale succession dépend entièrement du choix des comparables. Les critères qui tiennent face à un contrôle :

Proximité géographique : même quartier, voire même section cadastrale ou code IRIS plutôt qu'un rayon large.
Similarité du bien : même type (maison/appartement), surface dans une fourchette de ±20 %, nombre de pièces proche.
Fenêtre temporelle : ventes des 6 à 12 mois précédant le décès, jamais postérieures.
Volume suffisant : viser au moins 5 à 10 ventes comparables ; en dessous, élargir le rayon plutôt que la période.
Médiane, pas moyenne : la médiane du prix au m² résiste aux ventes atypiques (viager, vente entre proches).

Code Python : valeur vénale par comparables à une date donnée

Le script interroge l'endpoint de mutations à proximité, filtre sur la période antérieure au décès, calcule la médiane du prix au m² et l'applique à la surface du bien :

import requests
import statistics
from datetime import date

BASE_URL = "https://api.immoapi.app/v1"
HEADERS = {"Authorization": "Bearer VOTRE_TOKEN"}

def valeur_venale(lat, lon, surface, type_local, date_deces, rayon=400):
    r = requests.get(f"{BASE_URL}/mutations/nearby",
        headers=HEADERS,
        params={
            "lat": lat,
            "lon": lon,
            "rayon": rayon,
            "type_local": type_local,
            "date_max": date_deces,          # ventes antérieures au décès
            "date_min": "2024-05-01",        # fenêtre ~12 mois
        })
    ventes = r.json().get("mutations", [])
    prix_m2 = [
        v["valeur_fonciere"] / v["surface_bati"]
        for v in ventes
        if v.get("surface_bati") and 0.8 * surface <= v["surface_bati"] <= 1.2 * surface
    ]
    if len(prix_m2) < 5:
        raise ValueError("Trop peu de comparables : élargir le rayon")
    median_m2 = statistics.median(prix_m2)
    return {
        "nb_comparables": len(prix_m2),
        "prix_m2_median": round(median_m2),
        "valeur_venale": round(median_m2 * surface),
    }

print(valeur_venale(48.8566, 2.3522, 65, "Appartement", "2026-04-30"))

La gestion du token, la pagination et le détail des paramètres de l'endpoint sont décrits dans notre guide développeur d'utilisation de l'API DVF. Pour automatiser ce calcul dans vos propres outils sans coder ligne à ligne, une formation comme apprendre à intégrer des API avec Claude Code aide à industrialiser ce type de script.

Pour aller plus loin : la valeur vénale en vidéo

Pour bien cerner la notion avant de l'automatiser, cette vidéo explique ce qu'est la valeur vénale et pourquoi elle diffère du prix affiché :

Quels risques en cas de sous-évaluation (redressement fiscal) ?

Déclarer une valeur vénale juste est crucial car l'erreur se paie deux fois. Une sous-évaluation de la valeur vénale succession entraîne un redressement fiscal assorti de pénalités pouvant atteindre 40 % des droits éludés en cas de mauvaise foi, plus les intérêts de retard. Et même sans contrôle immédiat : une valeur déclarée trop basse augmente mécaniquement la plus-value imposable lors de la revente, puisque celle-ci se calcule sur l'écart entre prix de cession et valeur déclarée à la succession.

À l'inverse, une surévaluation fait payer des droits de succession excessifs. L'objectif n'est donc pas de minimiser, mais de viser le prix de marché réel, documenté par des comparables opposables — la même base que celle du contrôleur.

L'abattement de 20 % sur la résidence principale

Un levier légal souvent oublié : un abattement de 20 % s'applique sur la valeur vénale de la résidence principale du défunt, à deux conditions cumulatives — le bien était sa résidence principale au jour du décès, et il reste occupé à titre de résidence principale par le conjoint survivant, le partenaire de PACS, ou un ou plusieurs enfants (mineurs ou majeurs protégés) du défunt ou du conjoint. Cet abattement s'applique après détermination de la valeur vénale : il ne dispense en rien d'une estimation rigoureuse, il s'ajoute par-dessus.

FAQ — valeur vénale succession et donation

Comment estimer la valeur vénale d'une maison pour une succession ?

On applique la méthode des comparables : on relève les ventes réelles de biens similaires (même type, surface proche, même secteur) dans les 6 à 12 mois précédant le décès, via les données DVF accessibles par API ou via l'outil Patrim. La médiane du prix au m² appliquée à la surface du bien donne la valeur vénale, datée au jour du décès.

Quelle différence entre valeur vénale succession et valeur vénale donation ?

La méthode est identique (prix de marché par comparaison). Seule la date du fait générateur change : jour du décès pour une succession, date de l'acte pour une donation. Dans les deux cas, les comparables doivent être antérieurs et proches de cette date.

L'administration fiscale utilise-t-elle le DVF pour contrôler ?

Oui. Le fisc s'appuie sur la base DVF, exposée aux particuliers via l'outil Patrim, pour vérifier la cohérence des valeurs déclarées en succession ou donation. Reproduire cette méthode avec les mêmes données par API est la meilleure façon de sécuriser sa déclaration.

Que risque-t-on en cas de sous-évaluation ?

Un redressement fiscal avec rappel des droits, intérêts de retard, et pénalités jusqu'à 40 % en cas de mauvaise foi. La sous-évaluation augmente aussi la plus-value taxable à la revente. Une estimation documentée par comparables réduit fortement ce risque.

Faut-il un notaire ou un expert si on estime soi-même ?

Une estimation par comparables sécurise la fourchette, mais le notaire chargé de la succession valide la valeur et, pour un patrimoine élevé ou un bien atypique, un expert immobilier agréé produit un rapport opposable au fisc. L'estimation par API DVF sert de base solide et chiffrée à ces échanges.

Combien de ventes comparables faut-il pour une valeur vénale fiable ?

Viser au moins 5 à 10 ventes de biens réellement similaires dans le secteur. En dessous, mieux vaut élargir le rayon géographique que la période, pour rester calé sur la date du décès. Un volume suffisant limite l'écart avec la réalité du marché.

Pour aller plus loin

Conclusion : sécuriser sa valeur vénale avec les mêmes données que le fisc

La valeur vénale d'une succession ou d'une donation n'est ni le prix d'achat passé ni un prix d'espoir : c'est le prix de marché au jour du fait générateur, prouvé par des ventes comparables. Comme l'administration s'appuie sur le DVF via Patrim, reproduire sa méthode par API — comparables datés, médiane du prix au m², volume suffisant — transforme une zone de risque fiscal en estimation défendable. Pour brancher ce calcul sur vos dossiers, consultez la documentation Immo API et l'endpoint des mutations à proximité.