Documentation API

Achat vs Location

Comparez l'achat immobilier a la location sur un horizon donne. Integre le credit, les frais de notaire, la taxe fonciere, la revalorisation du bien et le rendement alternatif en bourse. Identifie le point de bascule.

GET/api/v1/simulateurs/achat-location

Parametres

Nom	Type	Requis	Min	Max	Defaut	Description
prix	number	oui	10000	100M	-	Prix du bien en euros
apport	number	oui	0	100M	-	Apport personnel en euros
taux_credit	number	oui	0	15	-	Taux du credit annuel (%)
duree_credit	integer	oui	1	30	-	Duree du credit en annees
loyer	number	oui	0	100k	-	Loyer mensuel equivalent en euros
charges	number	non	0	100k	200	Charges mensuelles copropriete
taxe_fonciere	number	non	0	100k	1500	Taxe fonciere annuelle
frais_notaire	number	non	0	20	7.5	Frais de notaire (%)
rendement_alternatif	number	non	0	30	5	Rendement investissement alternatif (%)
revalo_immo	number	non	-5	15	2	Revalorisation annuelle du bien (%)
horizon	integer	non	1	40	20	Horizon d'analyse en annees

Exemple de requete

curl "https://amwel.fr/api/v1/simulateurs/achat-location?prix=350000&apport=70000&taux_credit=3.5&duree_credit=20&loyer=1200"

Exemple de reponse (200)

{
  "data": {
    "resume": {
      "mensualiteCredit": 2028,
      "fraisNotaire": 26250,
      "coutTotalAchat": 742890,
      "coutTotalLocation": 288000,
      "patrimoineAchatFinal": 519868,
      "patrimoineLocationFinal": 329176,
      "pointBasculeAnnees": 8,
      "achatGagnant": true
    },
    "yearly": [
      { "annee": 2027, "coutAchat": 132586, "coutLocation": 14400, "patrimoineAchat": 98024, "patrimoineLocation": 83394 }
    ]
  },
  "meta": { "computedAt": "2026-03-26T...", "version": "1.0", "endpoint": "simulateurs/achat-location" },
  "disclaimer": "Simulation educative uniquement. Ne constitue pas un conseil en investissement personnalise."
}

Reponse en cas d'erreur (422)

{
  "errors": [
    { "field": "prix", "message": "prix est requis" },
    { "field": "duree_credit", "message": "duree_credit 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

Simulateur interactif

Utilisez la version interactive de ce simulateur avec une interface graphique complete :

Ouvrir le simulateur Achat vs Location

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.