{"openapi":"3.1.0","info":{"title":"CADA — API Immobilier France","version":"1.0.0","description":"API de calcul immobilier français. 37 simulateurs couvrant la rentabilité, le financement, la fiscalité, la transmission et les dispositifs de défiscalisation.\n\n**Free tier :** 100 appels/mois sans carte bancaire.\n\n**Authentification :** Header `Authorization: Bearer cada_xxx`\n\n**Base URL :** `https://www.cadaimmo.com`","contact":{"name":"CADA","url":"https://www.cadaimmo.com","email":"api@cadaimmo.com"}},"servers":[{"url":"https://www.cadaimmo.com","description":"Production"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Rendement & Marché","description":"Outils de la catégorie rendement & marché."},{"name":"Financement","description":"Outils de la catégorie financement."},{"name":"Fiscalité","description":"Outils de la catégorie fiscalité."},{"name":"Transmission","description":"Outils de la catégorie transmission."},{"name":"Stratégie","description":"Outils de la catégorie stratégie."},{"name":"Dispositifs fiscaux","description":"Outils de la catégorie dispositifs fiscaux."},{"name":"Construction & DPE","description":"Outils de la catégorie construction & dpe."}],"paths":{"/api/v1/tools/rentabilite-locative":{"post":{"operationId":"rentabilite-locative","summary":"Rentabilité locative","description":"Calcule la rentabilité brute, nette et nette-nette d'un investissement locatif.","tags":["Rendement & Marché"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","description":"Mode de calcul : achat, donation ou succession","default":"achat"},"prix":{"type":"number","description":"Prix d'achat du bien (€)"},"fraisNotaire":{"type":"number","description":"Frais de notaire (€)","default":0},"fraisAgence":{"type":"number","description":"Frais d'agence (€)","default":0},"travaux":{"type":"number","description":"Budget travaux (€)","default":0},"loyerMensuel":{"type":"number","description":"Loyer mensuel hors charges (€)"},"chargesMensuelles":{"type":"number","description":"Charges mensuelles (€)","default":0},"taxeFonciere":{"type":"number","description":"Taxe foncière annuelle (€)","default":0},"vacance":{"type":"number","description":"Taux de vacance locative (%)","default":5},"tmi":{"type":"number","description":"Tranche marginale d'imposition (%)","default":30},"apport":{"type":"number","description":"Apport personnel (€)","default":0}},"required":["prix","loyerMensuel"]},"example":{"prix":200000,"loyerMensuel":900,"fraisNotaire":15000,"taxeFonciere":1200,"tmi":30}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"rendementBrut":{"type":"number","description":"Rendement brut (%)"},"rendementNet":{"type":"number","description":"Rendement net de charges (%)"},"rendementNetNet":{"type":"number","description":"Rendement net après impôt (%)"},"cashflowMensuel":{"type":"number","description":"Cashflow mensuel (€)"},"cashflowAnnuel":{"type":"number","description":"Cashflow annuel (€)"},"impotAnnuel":{"type":"number","description":"Impôt annuel estimé (€, négatif = économie via déficit foncier)"},"deficitFoncierImpute":{"type":"number","description":"Déficit foncier imputé sur le revenu global (€, ≤ 10 700/an)"},"deficitReportable":{"type":"number","description":"Déficit foncier reportable sur revenus fonciers (€, 10 ans)"},"coutTotal":{"type":"number","description":"Coût total d'acquisition (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"rendementBrut":5,"rendementNet":4.2,"rendementNetNet":3.1,"cashflowMensuel":120,"cashflowAnnuel":1440,"impotAnnuel":1800,"coutTotal":215000},"tool":"rentabilite-locative"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/estimation-loyer":{"post":{"operationId":"estimation-loyer","summary":"Estimation de loyer","description":"Estime le loyer de marché selon la localisation, la surface et le type de bien.","tags":["Rendement & Marché"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"codeInsee":{"type":"string","description":"Code INSEE de la commune"},"surface":{"type":"number","description":"Surface habitable (m²)"},"nbPieces":{"type":"number","description":"Nombre de pièces","default":2},"meuble":{"type":"boolean","description":"Meublé ?","default":false}},"required":["codeInsee","surface"]},"example":{"codeInsee":"75056","surface":35,"nbPieces":2,"meuble":false}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"loyerEstime":{"type":"number","description":"Loyer mensuel estimé (€)"},"loyerM2":{"type":"number","description":"Loyer au m² (€/m²)"},"fourchetteBasse":{"type":"number","description":"Fourchette basse (€)"},"fourchetteHaute":{"type":"number","description":"Fourchette haute (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"loyerEstime":980,"loyerM2":28,"fourchetteBasse":840,"fourchetteHaute":1120},"tool":"estimation-loyer"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/indexation-loyers":{"post":{"operationId":"indexation-loyers","summary":"Indexation des loyers","description":"Calcule le nouveau loyer après révision selon l'IRL, l'ILC ou l'ILAT.","tags":["Rendement & Marché"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"loyerActuel":{"type":"number","description":"Loyer actuel (€)"},"indiceBase":{"type":"number","description":"Indice de référence du bail"},"indiceActuel":{"type":"number","description":"Dernier indice publié"}},"required":["loyerActuel","indiceBase","indiceActuel"]},"example":{"loyerActuel":800,"indiceBase":138.61,"indiceActuel":145.47}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"nouveauLoyer":{"type":"number","description":"Loyer révisé (€)"},"variation":{"type":"number","description":"Variation en €"},"variationPct":{"type":"number","description":"Variation en %"}}},"tool":{"type":"string"}}},"example":{"data":{"nouveauLoyer":839,"variation":39,"variationPct":4.95},"tool":"indexation-loyers"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/capacite-emprunt":{"post":{"operationId":"capacite-emprunt","summary":"Capacité d'emprunt","description":"Calcule le montant maximum empruntable selon les revenus, charges et taux.","tags":["Financement"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"revenusMensuels":{"type":"number","description":"Revenus mensuels nets du foyer (€)"},"chargesExistantes":{"type":"number","description":"Charges de crédit existantes (€/mois)","default":0},"duree":{"type":"number","description":"Durée du prêt (années)","default":20},"taux":{"type":"number","description":"Taux annuel (%)","default":3.5}},"required":["revenusMensuels"]},"example":{"revenusMensuels":4000,"chargesExistantes":300,"duree":25,"taux":3.2}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"mensualiteMax":{"type":"number","description":"Mensualité max (€)"},"capaciteEmprunt":{"type":"number","description":"Montant empruntable (€)"},"tauxEndettement":{"type":"number","description":"Taux d'endettement (%)"},"resteAVivre":{"type":"number","description":"Reste à vivre (€/mois)"}}},"tool":{"type":"string"}}},"example":{"data":{"mensualiteMax":1100,"capaciteEmprunt":228000,"tauxEndettement":35,"resteAVivre":2600},"tool":"capacite-emprunt"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/mensualite-pret":{"post":{"operationId":"mensualite-pret","summary":"Mensualité de prêt","description":"Calcule la mensualité, le coût total du crédit et le TAEG.","tags":["Financement"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"capital":{"type":"number","description":"Capital emprunté (€)"},"taux":{"type":"number","description":"Taux annuel (%)"},"duree":{"type":"number","description":"Durée (années)"},"tauxAssurance":{"type":"number","description":"Taux ADI (%)","default":0.34}},"required":["capital","taux","duree"]},"example":{"capital":200000,"taux":3.5,"duree":20,"tauxAssurance":0.34}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"mensualiteHorsAssurance":{"type":"number","description":"Mensualité hors assurance (€)"},"mensualiteTotale":{"type":"number","description":"Mensualité avec assurance (€)"},"coutTotal":{"type":"number","description":"Coût total du crédit (€)"},"taeg":{"type":"number","description":"TAEG (%)"}}},"tool":{"type":"string"}}},"example":{"data":{"mensualiteHorsAssurance":1160,"mensualiteTotale":1217,"coutTotal":92000,"taeg":4.1},"tool":"mensualite-pret"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/endettement-hcsf":{"post":{"operationId":"endettement-hcsf","summary":"Endettement HCSF","description":"Calcule le taux d'endettement selon la méthode HCSF avec compensation locative à 70%.","tags":["Financement"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"revenusMensuels":{"type":"number","description":"Revenus mensuels nets (€)"},"mensualite":{"type":"number","description":"Mensualité du prêt (€)"},"adi":{"type":"number","description":"Assurance emprunteur mensuelle (€)","default":0},"autresCharges":{"type":"number","description":"Autres crédits en cours (€/mois)","default":0},"loyerPercu":{"type":"number","description":"Loyer perçu ou prévu (€/mois)","default":0}},"required":["revenusMensuels","mensualite"]},"example":{"revenusMensuels":4000,"mensualite":1200,"adi":57,"loyerPercu":900}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"tauxEndettement":{"type":"number","description":"Taux d'endettement (%)"},"conforme":{"type":"boolean","description":"Conforme HCSF (≤ 35%)"},"resteAVivre":{"type":"number","description":"Reste à vivre (€/mois)"}}},"tool":{"type":"string"}}},"example":{"data":{"tauxEndettement":27.5,"conforme":true,"resteAVivre":2743},"tool":"endettement-hcsf"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/ptz":{"post":{"operationId":"ptz","summary":"Prêt à Taux Zéro","description":"Vérifie l'éligibilité PTZ et calcule le montant selon la zone et les revenus.","tags":["Financement"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"zone":{"type":"string","description":"Zone géographique (A, Abis, B1, B2, C)"},"nbPersonnes":{"type":"number","description":"Nombre de personnes dans le foyer"},"revenuFiscal":{"type":"number","description":"Revenu fiscal de référence (€)"},"prixOperation":{"type":"number","description":"Prix total de l'opération (€)"},"neuf":{"type":"boolean","description":"Bien neuf ?","default":true}},"required":["zone","nbPersonnes","revenuFiscal","prixOperation"]},"example":{"zone":"B1","nbPersonnes":2,"revenuFiscal":35000,"prixOperation":250000,"neuf":true}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"eligible":{"type":"boolean","description":"Éligible au PTZ"},"montantPtz":{"type":"number","description":"Montant du PTZ (€)"},"dureeDiffere":{"type":"number","description":"Durée du différé (années)"},"dureeRemboursement":{"type":"number","description":"Durée totale de remboursement (années)"}}},"tool":{"type":"string"}}},"example":{"data":{"eligible":true,"montantPtz":100000,"dureeDiffere":5,"dureeRemboursement":20},"tool":"ptz"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/adi-delegation":{"post":{"operationId":"adi-delegation","summary":"ADI / Délégation d'assurance","description":"Compare l'assurance groupe bancaire vs délégation d'assurance (loi Lemoine).","tags":["Financement"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"capital":{"type":"number","description":"Capital emprunté (€)"},"duree":{"type":"number","description":"Durée du prêt (années)"},"tauxGroupe":{"type":"number","description":"Taux assurance groupe (%)"},"tauxDelegation":{"type":"number","description":"Taux assurance déléguée (%)"}},"required":["capital","duree","tauxGroupe","tauxDelegation"]},"example":{"capital":200000,"duree":20,"tauxGroupe":0.36,"tauxDelegation":0.12}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"coutGroupe":{"type":"number","description":"Coût total assurance groupe (€)"},"coutDelegation":{"type":"number","description":"Coût total délégation (€)"},"economie":{"type":"number","description":"Économie réalisée (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"coutGroupe":14400,"coutDelegation":4800,"economie":9600},"tool":"adi-delegation"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/stress-test":{"post":{"operationId":"stress-test","summary":"Stress test","description":"Teste la résistance d'un investissement face à 3 scénarios adverses : taux +1pt, loyer -10%, vacance x2.","tags":["Financement"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mensualite":{"type":"number","description":"Mensualité actuelle (€)"},"loyer":{"type":"number","description":"Loyer mensuel (€)"},"charges":{"type":"number","description":"Charges mensuelles (€)"},"tauxActuel":{"type":"number","description":"Taux d'intérêt actuel (%)"},"capitalRestant":{"type":"number","description":"Capital restant dû (€)"},"dureeRestante":{"type":"number","description":"Durée restante (années)"},"vacanceActuelle":{"type":"number","description":"Taux de vacance actuel (%)","default":5}},"required":["mensualite","loyer","charges","tauxActuel","capitalRestant","dureeRestante"]},"example":{"mensualite":1100,"loyer":900,"charges":250,"tauxActuel":3.5,"capitalRestant":180000,"dureeRestante":18,"vacanceActuelle":5}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"stressTaux":{"type":"object","description":"Scénario taux +1pt : { mensualite, cashflow, resiste }"},"stressLoyer":{"type":"object","description":"Scénario loyer -10% : { loyer, cashflow, resiste }"},"stressVacance":{"type":"object","description":"Scénario vacance x2 : { vacance, cashflow, resiste }"},"score":{"type":"number","description":"Score de résilience (0-3)"}}},"tool":{"type":"string"}}},"example":{"data":{"stressTaux":{"mensualite":1200,"cashflow":-550,"resiste":false},"stressLoyer":{"loyer":810,"cashflow":-540,"resiste":false},"stressVacance":{"vacance":10,"cashflow":-495,"resiste":false},"score":0},"tool":"stress-test"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/credit-lombard":{"post":{"operationId":"credit-lombard","summary":"Crédit lombard","description":"Simule un nantissement d'assurance-vie pour financer un achat immobilier.","tags":["Financement"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"capitalAV":{"type":"number","description":"Capital assurance-vie nanti (€)"},"quotiteNantie":{"type":"number","description":"Quotité nantie (%)","default":80},"tauxCredit":{"type":"number","description":"Taux du crédit lombard (%)"},"duree":{"type":"number","description":"Durée (années)"},"rendementAV":{"type":"number","description":"Rendement net de l'AV (%)","default":3}},"required":["capitalAV","tauxCredit","duree"]},"example":{"capitalAV":500000,"quotiteNantie":80,"tauxCredit":2.5,"duree":15,"rendementAV":3}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"montantFinancable":{"type":"number","description":"Montant finançable (€)"},"mensualite":{"type":"number","description":"Mensualité (€)"},"coutCredit":{"type":"number","description":"Coût total du crédit (€)"},"gainAV":{"type":"number","description":"Gain AV pendant la durée (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"montantFinancable":400000,"mensualite":2667,"coutCredit":80000,"gainAV":270000},"tool":"credit-lombard"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/frais-notaire":{"post":{"operationId":"frais-notaire","summary":"Frais de notaire","description":"Estimation détaillée des frais d'acquisition : DMTO, émoluments, débours, CSI.","tags":["Fiscalité"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prix":{"type":"number","description":"Prix d'achat (€)"},"type":{"type":"string","description":"ancien ou neuf","default":"ancien"},"tauxDepartement":{"type":"number","description":"Taux DMTO départemental (%)","default":4.5}},"required":["prix"]},"example":{"prix":200000,"type":"ancien"}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"total":{"type":"number","description":"Frais totaux (€)"},"pourcentage":{"type":"number","description":"Frais en % du prix"},"dmto":{"type":"number","description":"Droits de mutation (€)"},"emolumentsTTC":{"type":"number","description":"Émoluments TTC (€)"},"debours":{"type":"number","description":"Débours (€)"},"csi":{"type":"number","description":"Contribution sécurité immobilière (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"total":15200,"pourcentage":7.6,"dmto":11600,"emolumentsTTC":2400,"debours":1000,"csi":200},"tool":"frais-notaire"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/frais-encheres":{"post":{"operationId":"frais-encheres","summary":"Frais d'enchères immobilières","description":"Frais d'acquisition aux enchères (vente judiciaire ou notariale) : émoluments avocat/notaire, DMTO, CSI, frais préalables.","tags":["Fiscalité"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prixAdjudication":{"type":"number","description":"Montant d'adjudication (prix de vente final, €)"},"auctionType":{"type":"string","description":"Type de vente : judiciaire ou notariale"},"acquirerStatus":{"type":"string","description":"Statut de l'acheteur : particulier, mdb ou sci"},"engagementRevente":{"type":"boolean","description":"Engagement de revente sous 5 ans (DMTO réduit MdB, art. 1115 CGI)","default":false},"fraisPrealablesTTC":{"type":"number","description":"Frais préalables TTC (vente judiciaire)","default":0},"surenchere":{"type":"boolean","description":"Surenchère du dixième en cours (+10%)","default":false},"dmtoMajore":{"type":"boolean","description":"Département ayant relevé le DMTO de +0,5pt (6,32% au lieu de 5,81%)","default":false}},"required":["prixAdjudication","auctionType","acquirerStatus"]},"example":{"prixAdjudication":200000,"auctionType":"judiciaire","acquirerStatus":"particulier"}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"emolumentsTTC":{"type":"number","description":"Émoluments avocat/notaire TTC (€)"},"dmtoMontant":{"type":"number","description":"Droits de mutation (€)"},"contributionSecuriteImmo":{"type":"number","description":"Contribution de sécurité immobilière (€)"},"totalFraisTTC":{"type":"number","description":"Total des frais (€)"},"totalAcquisition":{"type":"number","description":"Coût total d'acquisition (€)"},"fraisRapportPct":{"type":"number","description":"Frais en % du prix d'adjudication"}}},"tool":{"type":"string"}}},"example":{"data":{"emolumentsTTC":4575,"dmtoMontant":11620,"contributionSecuriteImmo":200,"totalFraisTTC":16395,"totalAcquisition":216395,"fraisRapportPct":8.2},"tool":"frais-encheres"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/jeanbrun-simulation":{"post":{"operationId":"jeanbrun-simulation","summary":"Simulation statut bailleur privé (Jeanbrun 2026)","description":"Simule le dispositif Jeanbrun 2026 (statut du bailleur privé) : amortissement déductible, loyer plafond et rentabilité à 9/15/20 ans.","tags":["Dispositifs fiscaux"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prix":{"type":"number","description":"Prix d'acquisition (€)"},"surfaceHabitable":{"type":"number","description":"Surface habitable / Carrez (m²)"},"surfaceAnnexes":{"type":"number","description":"Surfaces annexes brutes (m², comptées /2 plafonné à 8)","default":0},"zone":{"type":"string","description":"Zone du bien : Abis, A, B1, B2 ou C"},"nature":{"type":"string","description":"neuf (VEFA/DPE A-B) ou ancien (rénové, travaux ≥ 30% du prix)"},"typeAmort":{"type":"string","description":"Niveau social : lli (intermédiaire), social ou tres_social"},"dureeEngagement":{"type":"number","description":"Durée d'engagement de location (9, 12, 15, 16 ou 20 ans)"},"apport":{"type":"number","description":"Apport personnel (€)","default":0},"fraisAcquisitionPct":{"type":"number","description":"Frais d'acquisition (% du prix)","default":7.5},"tauxEmprunt":{"type":"number","description":"Taux du prêt (décimal, 0.035 = 3,5%)","default":0.035},"dureeEmprunt":{"type":"number","description":"Durée du prêt (années)","default":20},"tmi":{"type":"number","description":"Tranche marginale d'imposition (décimal, 0.30 = 30%)"},"revenuNetImposable":{"type":"number","description":"Revenu net imposable hors fonciers (€)","default":0},"partsFiscales":{"type":"number","description":"Nombre de parts fiscales","default":1}},"required":["prix","surfaceHabitable","zone","nature","typeAmort","dureeEngagement","tmi"]},"example":{"prix":250000,"surfaceHabitable":50,"surfaceAnnexes":0,"zone":"A","nature":"neuf","typeAmort":"social","dureeEngagement":15,"apport":30000,"tmi":0.3}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"loyerMensuel":{"type":"number","description":"Loyer mensuel plafond Jeanbrun (€)"},"amortissementAnnuel":{"type":"number","description":"Amortissement annuel déductible (€)"},"mensualite":{"type":"number","description":"Mensualité du prêt (€)"},"coutTotal":{"type":"number","description":"Coût total d'acquisition (€)"},"horizon9":{"type":"object","description":"Synthèse à 9 ans (TRI, cashflow cumulé, plus-value nette)"},"horizon15":{"type":"object","description":"Synthèse à 15 ans"},"horizon20":{"type":"object","description":"Synthèse à 20 ans"}}},"tool":{"type":"string"}}},"example":{"data":{"loyerMensuel":603,"amortissementAnnuel":9000,"mensualite":1100,"coutTotal":268750,"horizon9":{"tri":4.2},"horizon15":{"tri":5.1},"horizon20":{"tri":5.8}},"tool":"jeanbrun-simulation"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/comparateur-fiscal":{"post":{"operationId":"comparateur-fiscal","summary":"Comparateur fiscal","description":"Compare les 7 régimes fiscaux immobiliers français : micro-foncier, réel, LMNP micro/réel, LMP, SCI IR/IS.","tags":["Fiscalité"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"loyerMensuel":{"type":"number","description":"Loyer mensuel HC (€)"},"purchasePrice":{"type":"number","description":"Prix d'achat (€)"},"fraisNotaire":{"type":"number","description":"Frais de notaire (€)","default":0},"travaux":{"type":"number","description":"Travaux (€)","default":0},"taxeFonciere":{"type":"number","description":"Taxe foncière annuelle (€)","default":0},"copro":{"type":"number","description":"Charges copropriété annuelles (€)","default":0},"tmi":{"type":"number","description":"Tranche marginale d'imposition (%)"},"tauxEmprunt":{"type":"number","description":"Taux du prêt (%)","default":3.5},"duree":{"type":"number","description":"Durée du prêt (années)","default":20}},"required":["loyerMensuel","purchasePrice","tmi"]},"example":{"loyerMensuel":900,"purchasePrice":200000,"fraisNotaire":15000,"taxeFonciere":1200,"copro":600,"tmi":30,"tauxEmprunt":3.5,"duree":20}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"regimes":{"type":"array","description":"Liste des 7 régimes avec impôt annuel et cashflow net"},"bestRegime":{"type":"string","description":"Slug du régime le plus avantageux"},"rent":{"type":"number","description":"Loyer annuel brut (€)"},"totalCharges":{"type":"number","description":"Charges annuelles totales (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"bestRegime":"lmnpReel","rent":10800,"totalCharges":3600,"regimes":[{"regime":"lmnpReel","totalTax":0,"netCashFlow":7200}]},"tool":"comparateur-fiscal"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/plus-value":{"post":{"operationId":"plus-value","summary":"Plus-value immobilière","description":"Calcule la plus-value imposable avec abattements IR/PS pour durée de détention et surtaxe.","tags":["Fiscalité"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prixAchat":{"type":"number","description":"Prix d'achat (€)"},"prixVente":{"type":"number","description":"Prix de vente (€)"},"fraisNotaire":{"type":"number","description":"Frais d'acquisition (€)","default":0},"travaux":{"type":"number","description":"Travaux déductibles (€)","default":0},"dureeDetention":{"type":"number","description":"Durée de détention (années)"},"regime":{"type":"string","description":"ir ou sci_is","default":"ir"}},"required":["prixAchat","prixVente","dureeDetention"]},"example":{"prixAchat":200000,"prixVente":350000,"fraisNotaire":15000,"dureeDetention":10,"regime":"ir"}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"plusValueBrute":{"type":"number","description":"Plus-value brute (€)"},"impotIR":{"type":"number","description":"Impôt sur le revenu (€)"},"prelevementsSociaux":{"type":"number","description":"Prélèvements sociaux (€)"},"surtaxe":{"type":"number","description":"Surtaxe PV élevées (€)"},"impotTotal":{"type":"number","description":"Impôt total (€)"},"netVendeur":{"type":"number","description":"Net vendeur (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"plusValueBrute":135000,"impotIR":15390,"prelevementsSociaux":20588,"surtaxe":2700,"impotTotal":38678,"netVendeur":311322},"tool":"plus-value"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/amortissement-lmnp":{"post":{"operationId":"amortissement-lmnp","summary":"Amortissement LMNP","description":"Tableau d'amortissement comptable LMNP par composants (gros œuvre, toiture, etc.).","tags":["Fiscalité"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prixAchat":{"type":"number","description":"Prix d'achat hors terrain (€)"},"travaux":{"type":"number","description":"Travaux amortissables (€)","default":0},"mobilier":{"type":"number","description":"Mobilier amortissable (€)","default":0}},"required":["prixAchat"]},"example":{"prixAchat":200000,"mobilier":5000}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"amortissementAnnuel":{"type":"number","description":"Amortissement total annuel (€)"},"composants":{"type":"array","description":"Détail par composant"}}},"tool":{"type":"string"}}},"example":{"data":{"amortissementAnnuel":6950,"composants":[{"nom":"Gros oeuvre","montant":120000,"duree":80,"annuel":1500}]},"tool":"amortissement-lmnp"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/deficit-foncier":{"post":{"operationId":"deficit-foncier","summary":"Déficit foncier","description":"Simule le mécanisme de déficit foncier (déduction des travaux sur le revenu global, plafond 10 700 €).","tags":["Fiscalité"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"loyerAnnuel":{"type":"number","description":"Revenus fonciers annuels (€)"},"chargesAnnuelles":{"type":"number","description":"Charges déductibles hors travaux (€)"},"travaux":{"type":"number","description":"Montant des travaux (€)"},"interetsEmprunt":{"type":"number","description":"Intérêts d'emprunt annuels (€)","default":0},"revenuGlobal":{"type":"number","description":"Revenu global imposable (€)"},"tmi":{"type":"number","description":"TMI (%)"}},"required":["loyerAnnuel","chargesAnnuelles","travaux","revenuGlobal","tmi"]},"example":{"loyerAnnuel":8000,"chargesAnnuelles":2000,"travaux":30000,"revenuGlobal":50000,"tmi":30}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"deficitImputable":{"type":"number","description":"Déficit imputable sur revenu global (€, max 10 700)"},"deficitReportable":{"type":"number","description":"Déficit reportable sur revenus fonciers futurs (€)"},"economieImpot":{"type":"number","description":"Économie d'impôt (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"deficitImputable":10700,"deficitReportable":13300,"economieImpot":5136},"tool":"deficit-foncier"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/impot-revenu":{"post":{"operationId":"impot-revenu","summary":"Impôt sur le revenu","description":"Simulation IR avec intégration des revenus fonciers ou BIC meublés.","tags":["Fiscalité"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"revenuNet":{"type":"number","description":"Revenu net imposable (€)"},"nbParts":{"type":"number","description":"Nombre de parts fiscales","default":1},"revenusFonciers":{"type":"number","description":"Revenus fonciers nets (€)","default":0}},"required":["revenuNet"]},"example":{"revenuNet":45000,"nbParts":2,"revenusFonciers":6000}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"impotBrut":{"type":"number","description":"Impôt brut (€)"},"tmi":{"type":"number","description":"TMI (%)"},"tauxMoyen":{"type":"number","description":"Taux moyen d'imposition (%)"}}},"tool":{"type":"string"}}},"example":{"data":{"impotBrut":3200,"tmi":30,"tauxMoyen":6.3},"tool":"impot-revenu"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/simulateur-ifi":{"post":{"operationId":"simulateur-ifi","summary":"Simulateur IFI","description":"Calcul de l'Impôt sur la Fortune Immobilière (seuil 1,3M€).","tags":["Fiscalité"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"patrimoineImmobilier":{"type":"number","description":"Valeur nette du patrimoine immobilier (€)"}},"required":["patrimoineImmobilier"]},"example":{"patrimoineImmobilier":2000000}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"assujetti":{"type":"boolean","description":"Assujetti à l'IFI"},"montantIfi":{"type":"number","description":"Montant IFI dû (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"assujetti":true,"montantIfi":5200},"tool":"simulateur-ifi"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/frais-donation":{"post":{"operationId":"frais-donation","summary":"Frais de donation","description":"Calcule les droits de donation avec abattements par lien de parenté.","tags":["Transmission"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"montant":{"type":"number","description":"Montant de la donation (€)"},"lienParente":{"type":"string","description":"Lien de parenté (enfant, conjoint, frere, neveu, tiers)"},"donationAnterieure":{"type":"number","description":"Donations antérieures < 15 ans (€)","default":0}},"required":["montant","lienParente"]},"example":{"montant":300000,"lienParente":"enfant"}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"abattement":{"type":"number","description":"Abattement applicable (€)"},"baseImposable":{"type":"number","description":"Base imposable après abattement (€)"},"droits":{"type":"number","description":"Droits de donation (€)"},"tauxEffectif":{"type":"number","description":"Taux effectif (%)"}}},"tool":{"type":"string"}}},"example":{"data":{"abattement":100000,"baseImposable":200000,"droits":31194,"tauxEffectif":10.4},"tool":"frais-donation"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/frais-succession":{"post":{"operationId":"frais-succession","summary":"Frais de succession","description":"Calcule les droits de succession avec barème progressif par lien familial.","tags":["Transmission"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"montant":{"type":"number","description":"Montant hérité (€)"},"lienParente":{"type":"string","description":"Lien de parenté"}},"required":["montant","lienParente"]},"example":{"montant":500000,"lienParente":"enfant"}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"abattement":{"type":"number","description":"Abattement applicable (€)"},"droits":{"type":"number","description":"Droits de succession (€)"},"tauxEffectif":{"type":"number","description":"Taux effectif (%)"}}},"tool":{"type":"string"}}},"example":{"data":{"abattement":100000,"droits":78194,"tauxEffectif":15.6},"tool":"frais-succession"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/location-vs-achat":{"post":{"operationId":"location-vs-achat","summary":"Location vs achat","description":"Comparaison financière sur N années : continuer à louer ou acheter sa résidence principale.","tags":["Stratégie"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"loyerActuel":{"type":"number","description":"Loyer mensuel actuel (€)"},"prixAchat":{"type":"number","description":"Prix d'achat du bien (€)"},"apport":{"type":"number","description":"Apport personnel (€)","default":0},"taux":{"type":"number","description":"Taux du prêt (%)","default":3.5},"duree":{"type":"number","description":"Durée (années)","default":20},"horizon":{"type":"number","description":"Horizon de comparaison (années)","default":10}},"required":["loyerActuel","prixAchat"]},"example":{"loyerActuel":1000,"prixAchat":250000,"apport":30000,"taux":3.5,"duree":25,"horizon":10}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"coutLocation":{"type":"number","description":"Coût total de la location sur l'horizon (€)"},"coutAchat":{"type":"number","description":"Coût net de l'achat sur l'horizon (€)"},"avantageAchat":{"type":"number","description":"Avantage de l'achat (€, négatif si location plus avantageuse)"}}},"tool":{"type":"string"}}},"example":{"data":{"coutLocation":120000,"coutAchat":95000,"avantageAchat":25000},"tool":"location-vs-achat"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/bilan-marchand-de-biens":{"post":{"operationId":"bilan-marchand-de-biens","summary":"Bilan marchand de biens","description":"Calcule la rentabilité d'une opération d'achat-revente : TVA sur marge, IS/IR, frais réduits MDB.","tags":["Stratégie"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prixAchat":{"type":"number","description":"Prix d'achat (€)"},"prixVente":{"type":"number","description":"Prix de revente prévu (€)"},"travaux":{"type":"number","description":"Budget travaux (€)","default":0},"regime":{"type":"string","description":"is ou ir","default":"is"},"tvaMode":{"type":"string","description":"marge ou prixTotal","default":"marge"}},"required":["prixAchat","prixVente"]},"example":{"prixAchat":150000,"prixVente":250000,"travaux":40000,"regime":"is","tvaMode":"marge"}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"margeBrute":{"type":"number","description":"Marge brute (€)"},"tva":{"type":"number","description":"TVA due (€)"},"impot":{"type":"number","description":"Impôt (€)"},"beneficeNet":{"type":"number","description":"Bénéfice net (€)"},"rentabilite":{"type":"number","description":"Rentabilité (%)"}}},"tool":{"type":"string"}}},"example":{"data":{"margeBrute":60000,"tva":10000,"impot":9000,"beneficeNet":41000,"rentabilite":21.6},"tool":"bilan-marchand-de-biens"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/offre-achat":{"post":{"operationId":"offre-achat","summary":"Offre d'achat optimale","description":"Calcule le prix d'achat max pour atteindre un objectif de rentabilité ou de cashflow.","tags":["Stratégie"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"loyerMensuel":{"type":"number","description":"Loyer mensuel prévu (€)"},"rendementCible":{"type":"number","description":"Rendement brut cible (%)","default":7},"regime":{"type":"string","description":"Régime fiscal","default":"lmnpReel"},"tmi":{"type":"number","description":"TMI (%)","default":30}},"required":["loyerMensuel"]},"example":{"loyerMensuel":800,"rendementCible":7}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"prixMax":{"type":"number","description":"Prix d'achat maximum (€)"},"prixMaxAvecFrais":{"type":"number","description":"Budget total max avec frais (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"prixMax":137000,"prixMaxAvecFrais":148000},"tool":"offre-achat"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/loi-malraux":{"post":{"operationId":"loi-malraux","summary":"Loi Malraux","description":"Simulation de la réduction d'impôt Malraux (22% ou 30% des travaux, plafond 400k€ sur 4 ans).","tags":["Dispositifs fiscaux"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"montantTravaux":{"type":"number","description":"Montant des travaux (€)"},"zone":{"type":"string","description":"sppr (30%) ou pvap (22%)"}},"required":["montantTravaux","zone"]},"example":{"montantTravaux":200000,"zone":"sppr"}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"reductionImpot":{"type":"number","description":"Réduction d'impôt totale (€)"},"taux":{"type":"number","description":"Taux de réduction (%)"}}},"tool":{"type":"string"}}},"example":{"data":{"reductionImpot":60000,"taux":30},"tool":"loi-malraux"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/denormandie":{"post":{"operationId":"denormandie","summary":"Denormandie","description":"Simulation de la réduction Denormandie (12/18/21% du prix selon la durée d'engagement).","tags":["Dispositifs fiscaux"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prixAchat":{"type":"number","description":"Prix d'achat (€)"},"travaux":{"type":"number","description":"Montant des travaux (€, min 25% du prix)"},"dureeEngagement":{"type":"number","description":"Durée d'engagement (6, 9 ou 12 ans)"}},"required":["prixAchat","travaux","dureeEngagement"]},"example":{"prixAchat":200000,"travaux":60000,"dureeEngagement":9}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"eligible":{"type":"boolean","description":"Éligible Denormandie"},"reductionTotale":{"type":"number","description":"Réduction d'impôt totale (€)"},"reductionAnnuelle":{"type":"number","description":"Réduction annuelle (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"eligible":true,"reductionTotale":46800,"reductionAnnuelle":5200},"tool":"denormandie"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/monuments-historiques":{"post":{"operationId":"monuments-historiques","summary":"Monuments historiques","description":"Déduction intégrale des travaux sur le revenu global (sans plafond) pour les monuments classés.","tags":["Dispositifs fiscaux"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"travaux":{"type":"number","description":"Montant des travaux (€)"},"tmi":{"type":"number","description":"TMI (%)"}},"required":["travaux","tmi"]},"example":{"travaux":500000,"tmi":45}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"deductionTotale":{"type":"number","description":"Déduction totale (€)"},"economieImpot":{"type":"number","description":"Économie d'impôt (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"deductionTotale":500000,"economieImpot":225000},"tool":"monuments-historiques"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/girardin":{"post":{"operationId":"girardin","summary":"Girardin industriel","description":"Simulation de la réduction Girardin pour investissements en outre-mer.","tags":["Dispositifs fiscaux"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"montantInvesti":{"type":"number","description":"Montant investi (€)"},"tauxReduction":{"type":"number","description":"Taux de réduction (%)","default":110}},"required":["montantInvesti"]},"example":{"montantInvesti":10000,"tauxReduction":110}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"reductionImpot":{"type":"number","description":"Réduction d'impôt (€)"},"gainNet":{"type":"number","description":"Gain net (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"reductionImpot":11000,"gainNet":1000},"tool":"girardin"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/lmp-statut":{"post":{"operationId":"lmp-statut","summary":"Statut LMP","description":"Vérifie les conditions du statut LMP (loyers > 23k€ et > revenus) et calcule les cotisations SSI.","tags":["Dispositifs fiscaux"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"loyersAnnuels":{"type":"number","description":"Loyers meublés annuels (€)"},"revenusActivite":{"type":"number","description":"Revenus d'activité du foyer (€)"}},"required":["loyersAnnuels","revenusActivite"]},"example":{"loyersAnnuels":35000,"revenusActivite":30000}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"isLMP":{"type":"boolean","description":"Statut LMP atteint"},"cotisationsSSI":{"type":"number","description":"Cotisations SSI estimées (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"isLMP":true,"cotisationsSSI":11550},"tool":"lmp-statut"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/estimation-travaux":{"post":{"operationId":"estimation-travaux","summary":"Estimation travaux","description":"Budget travaux détaillé par poste et par surface (rafraîchissement, rénovation, énergie).","tags":["Construction & DPE"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"surface":{"type":"number","description":"Surface (m²)"},"type":{"type":"string","description":"Type : rafraichissement, renovation, energetique, lourde","default":"renovation"}},"required":["surface"]},"example":{"surface":60,"type":"renovation"}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"budgetTotal":{"type":"number","description":"Budget total estimé (€)"},"budgetM2":{"type":"number","description":"Budget au m² (€)"},"postes":{"type":"array","description":"Détail par poste"}}},"tool":{"type":"string"}}},"example":{"data":{"budgetTotal":48000,"budgetM2":800,"postes":[{"nom":"Plomberie","montant":8000}]},"tool":"estimation-travaux"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/taxe-amenagement":{"post":{"operationId":"taxe-amenagement","summary":"Taxe d'aménagement","description":"Calcul de la taxe d'aménagement pour constructions et extensions.","tags":["Construction & DPE"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"surface":{"type":"number","description":"Surface taxable (m²)"},"tauxCommunal":{"type":"number","description":"Taux communal (%)","default":5},"tauxDepartemental":{"type":"number","description":"Taux départemental (%)","default":2.5}},"required":["surface"]},"example":{"surface":120,"tauxCommunal":5,"tauxDepartemental":2.5}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"taxeTotal":{"type":"number","description":"Taxe totale (€)"},"partCommunale":{"type":"number","description":"Part communale (€)"},"partDepartementale":{"type":"number","description":"Part départementale (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"taxeTotal":8100,"partCommunale":5400,"partDepartementale":2700},"tool":"taxe-amenagement"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/simulateur-dpe":{"post":{"operationId":"simulateur-dpe","summary":"Simulateur DPE","description":"Estime le DPE (double étiquette énergie + climat, classe A-G) et la consommation à partir des caractéristiques du bâti — moteur 3CL-DPE 2021 simplifié (non opposable).","tags":["Construction & DPE"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"surface":{"type":"number","description":"Surface habitable (m²)"},"anneeConstruction":{"type":"number","description":"Année de construction (détermine le coefficient G de base)"},"typeChauffage":{"type":"string","description":"electrique, gaz, fioul, bois, pac, reseau-chaleur"},"isolation":{"type":"string","description":"aucune, partielle, bonne, complete","default":"partielle"},"zoneClimatique":{"type":"string","description":"H1 (froid), H2 (tempéré), H3 (doux)","default":"H2"},"typeBien":{"type":"string","description":"maison ou appartement","default":"maison"},"menuiseries":{"type":"string","description":"simple, double, triple","default":"double"},"ventilation":{"type":"string","description":"naturelle, vmc-simple, vmc-double","default":"vmc-simple"},"hauteurSousPlafond":{"type":"number","description":"Hauteur sous plafond (m)","default":2.5},"energyCostPerKwh":{"type":"number","description":"Coût de l'énergie (€/kWh)"}},"required":["surface","anneeConstruction","typeChauffage"]},"example":{"surface":70,"anneeConstruction":1975,"typeChauffage":"gaz","isolation":"partielle"}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"classeDpe":{"type":"string","description":"Classe DPE finale (pire des deux étiquettes)"},"classeEnergie":{"type":"string","description":"Étiquette énergie (kWhEP/m²/an)"},"classeClimat":{"type":"string","description":"Étiquette climat (kgCO₂/m²/an)"},"consommation":{"type":"number","description":"Consommation d'énergie primaire (kWhEP/m²/an)"},"emissionsGes":{"type":"number","description":"Émissions de GES (kgCO₂/m²/an)"},"coutAnnuel":{"type":"number","description":"Coût énergétique annuel estimé (€)"}}},"tool":{"type":"string"}}},"example":{"data":{"classeDpe":"D","classeEnergie":"C","classeClimat":"D","consommation":175,"emissionsGes":38,"coutAnnuel":1475},"tool":"simulateur-dpe"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/simulateur-viager":{"post":{"operationId":"simulateur-viager","summary":"Simulateur viager","description":"Calcule le bouquet et la rente viagère selon l'âge du vendeur et la valeur du bien.","tags":["Stratégie"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"valeurBien":{"type":"number","description":"Valeur vénale du bien (€)"},"ageCedirent":{"type":"number","description":"Âge du crédirentier (vendeur)"},"bouquetPct":{"type":"number","description":"Bouquet en % de la valeur","default":30},"occupe":{"type":"boolean","description":"Viager occupé ?","default":true}},"required":["valeurBien","ageCedirent"]},"example":{"valeurBien":300000,"ageCedirent":75,"bouquetPct":30,"occupe":true}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"bouquet":{"type":"number","description":"Bouquet (€)"},"renteMensuelle":{"type":"number","description":"Rente mensuelle (€)"},"esperanceVie":{"type":"number","description":"Espérance de vie (années)"}}},"tool":{"type":"string"}}},"example":{"data":{"bouquet":90000,"renteMensuelle":750,"esperanceVie":12},"tool":"simulateur-viager"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/simulateur-demembrement":{"post":{"operationId":"simulateur-demembrement","summary":"Simulateur démembrement","description":"Calcule la valeur de la nue-propriété et de l'usufruit selon le barème fiscal.","tags":["Stratégie"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"valeurBien":{"type":"number","description":"Valeur en pleine propriété (€)"},"ageUsufruitier":{"type":"number","description":"Âge de l'usufruitier"}},"required":["valeurBien","ageUsufruitier"]},"example":{"valeurBien":400000,"ageUsufruitier":65}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"valeurUsufruit":{"type":"number","description":"Valeur usufruit (€)"},"valeurNuePropriete":{"type":"number","description":"Valeur nue-propriété (€)"},"pourcentageUsufruit":{"type":"number","description":"Part usufruit (%)"}}},"tool":{"type":"string"}}},"example":{"data":{"valeurUsufruit":160000,"valeurNuePropriete":240000,"pourcentageUsufruit":40},"tool":"simulateur-demembrement"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/simulateur-scpi":{"post":{"operationId":"simulateur-scpi","summary":"Simulateur SCPI","description":"Projection de rendement d'un investissement en SCPI avec fiscalité.","tags":["Stratégie"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"montantInvesti":{"type":"number","description":"Capital investi (€)"},"rendement":{"type":"number","description":"Taux de distribution (%)","default":4.5},"tmi":{"type":"number","description":"TMI (%)","default":30},"duree":{"type":"number","description":"Durée de détention (années)","default":10}},"required":["montantInvesti"]},"example":{"montantInvesti":100000,"rendement":4.5,"tmi":30}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"revenusAnnuels":{"type":"number","description":"Revenus annuels bruts (€)"},"impotAnnuel":{"type":"number","description":"Impôt annuel (€)"},"rendementNet":{"type":"number","description":"Rendement net d'impôt (%)"}}},"tool":{"type":"string"}}},"example":{"data":{"revenusAnnuels":4500,"impotAnnuel":2124,"rendementNet":2.38},"tool":"simulateur-scpi"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/simulateur-airbnb":{"post":{"operationId":"simulateur-airbnb","summary":"Simulateur Airbnb","description":"Estime les revenus d'une location courte durée avec saisonnalité et charges.","tags":["Stratégie"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prixNuit":{"type":"number","description":"Prix moyen par nuit (€)"},"tauxOccupation":{"type":"number","description":"Taux d'occupation (%)","default":65},"chargesMensuelles":{"type":"number","description":"Charges mensuelles (€)","default":0},"commissionPlateforme":{"type":"number","description":"Commission plateforme (%)","default":3}},"required":["prixNuit"]},"example":{"prixNuit":80,"tauxOccupation":65,"chargesMensuelles":200,"commissionPlateforme":3}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"revenuAnnuel":{"type":"number","description":"Revenu annuel brut (€)"},"revenuNet":{"type":"number","description":"Revenu annuel net (€)"},"nuitsLouees":{"type":"number","description":"Nuits louées par an"}}},"tool":{"type":"string"}}},"example":{"data":{"revenuAnnuel":18980,"revenuNet":16580,"nuitsLouees":237},"tool":"simulateur-airbnb"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}},"/api/v1/tools/bilan-promoteur":{"post":{"operationId":"bilan-promoteur","summary":"Bilan promoteur","description":"Bilan financier d'une opération de promotion immobilière.","tags":["Stratégie"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prixTerrain":{"type":"number","description":"Prix du foncier (€)"},"coutConstruction":{"type":"number","description":"Coût de construction (€)"},"prixVenteTotal":{"type":"number","description":"Prix de vente total des lots (€)"}},"required":["prixTerrain","coutConstruction","prixVenteTotal"]},"example":{"prixTerrain":500000,"coutConstruction":2000000,"prixVenteTotal":3500000}}}},"responses":{"200":{"description":"Calcul réussi","headers":{"X-Usage-Remaining":{"description":"Appels restants ce mois","schema":{"type":"integer"}},"X-Usage-Limit":{"description":"Quota mensuel inclus","schema":{"type":"integer"}},"X-Api-Tier":{"description":"Tier de l'utilisateur","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"margePromotion":{"type":"number","description":"Marge de promotion (€)"},"rentabilite":{"type":"number","description":"Rentabilité (%)"}}},"tool":{"type":"string"}}},"example":{"data":{"margePromotion":1000000,"rentabilite":40},"tool":"bilan-promoteur"}}}},"401":{"description":"Clé API manquante ou invalide","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}},"example":{"error":"Clé API invalide ou manquante. Format : Authorization: Bearer cada_xxx"}}}},"429":{"description":"Quota dépassé ou rate limit atteint","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"tier":{"type":"string"},"usage":{"type":"integer"},"limit":{"type":"integer"},"upgrade_url":{"type":"string"}}}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key (cada_xxx)","description":"Clé API CADA. Créez-en une sur https://www.cadaimmo.com/api-keys"}}}}