Documentation API

Droits de succession

Estimez les droits de succession selon le lien de parente (enfant, conjoint, frere/soeur, autre). Integre les abattements legaux, le bareme progressif et la fiscalite de l'assurance-vie.

GET/api/v1/simulateurs/succession

Parametres

Nom	Type	Requis	Min	Max	Defaut	Description
montant	number	oui	0	1G	-	Montant total de la succession en euros
lien	integer	oui	1	4	-	Lien de parente : 1=enfant, 2=conjoint, 3=frere/soeur, 4=autre
nb_enfants	integer	oui	0	20	-	Nombre d'enfants (pour partage en ligne directe)
assurance_vie	number	non	0	1G	0	Montant en assurance-vie (hors succession)

Exemple de requete

curl "https://amwel.fr/api/v1/simulateurs/succession?montant=500000&lien=1&nb_enfants=2&assurance_vie=150000"

Exemple de reponse (200)

{
  "data": {
    "resume": {
      "lien": "Ligne directe (enfant)",
      "montant_brut": 500000,
      "abattement_par_part": 100000,
      "base_imposable_par_part": 150000,
      "droits_par_part": 28194,
      "droits_total": 56388,
      "net_succession": 443612,
      "taux_effectif": 11.28
    },
    "assurance_vie": {
      "montant": 150000,
      "abattement": 305000,
      "taxe": 0,
      "net": 150000
    },
    "net_total": 593612,
    "detail_bareme": [
      { "tranche": "0 - 8072", "taux": 5, "montant": 404 },
      { "tranche": "8072 - 12109", "taux": 10, "montant": 404 }
    ]
  },
  "meta": { "computedAt": "2026-03-26T...", "version": "1.0", "endpoint": "simulateurs/succession" },
  "disclaimer": "Simulation educative uniquement. Ne constitue pas un conseil en investissement personnalise."
}

Reponse en cas d'erreur (422)

{
  "errors": [
    { "field": "montant", "message": "montant est requis" },
    { "field": "lien", "message": "lien doit etre un entier" }
  ]
}

Rate limiting

Limite

30 requetes / minute

Par

Adresse IP

Code HTTP si depasse

429 Too Many Requests

Codes de reponse

200Succes — donnees dans data

422Parametres invalides — details dans errors[]

429Trop de requetes — attendez 1 minute

204Preflight CORS (OPTIONS) — pas de body

Avertissement

Cette API est fournie a titre educatif uniquement. Les resultats sont des simulations basees sur les parametres fournis et ne constituent en aucun cas un conseil en investissement personnalise. Amwel n'est pas un conseiller en investissements financiers (CIF) et n'est pas enregistre aupres de l'AMF. Les performances passees ne prejugent pas des performances futures.