Documentation API

Rendement locatif

Calculez le rendement locatif brut et net d'un investissement immobilier. Integre le credit, les charges, la taxe fonciere, le cashflow mensuel et l'effet de levier.

GET/api/v1/simulateurs/immobilier

Parametres

Nom	Type	Requis	Min	Max	Defaut	Description
prix	number	oui	1000	100M	-	Prix d'achat du bien en euros
apport	number	oui	0	100M	-	Apport personnel en euros
taux_credit	number	oui	0	15	-	Taux annuel du credit (%)
duree_credit	integer	oui	1	30	-	Duree du credit en annees
loyer_mensuel	number	oui	0	1M	-	Loyer mensuel en euros
charges	number	non	0	100k	0	Charges mensuelles en euros
taxe_fonciere	number	non	0	100k	0	Taxe fonciere annuelle en euros

Exemple de requete

curl "https://amwel.fr/api/v1/simulateurs/immobilier?prix=200000&apport=40000&taux_credit=3.5&duree_credit=20&loyer_mensuel=800&charges=100&taxe_fonciere=1200"

Exemple de reponse (200)

{
  "data": {
    "resume": {
      "rendement_brut": 4.80,
      "rendement_net": 3.00,
      "cashflow_mensuel": -262,
      "total_interets": 66840,
      "effet_levier": 5.0,
      "rendement_capitaux_propres": -7.86
    },
    "detail": {
      "prix": 200000,
      "apport": 40000,
      "emprunt": 160000,
      "mensualite_credit": 962.16,
      "loyer_annuel": 9600,
      "charges_annuelles": 2400,
      "revenu_net_annuel": -4345
    }
  },
  "meta": { "computedAt": "2026-03-26T...", "version": "1.0", "endpoint": "simulateurs/immobilier" },
  "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

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.