---
title: "SCPI à crédit — effort d'épargne et TRI"
method: POST
path: "/api/fiscal/v1/calc/scpi_credit"
tags: ["simulateurs"]
---

# SCPI à crédit — effort d'épargne et TRI

`POST /api/fiscal/v1/calc/scpi_credit`

## Request

- Base URL: `https://app.qotien.fr`
- URL: `https://app.qotien.fr/api/fiscal/v1/calc/scpi_credit`
- Auth: none declared

Projette une SCPI financée à crédit : mensualité, effort d'épargne, fonds propres et TRI à terme (intérêts + assurance déductibles). Résultat ESTIMÉ (hypothèses de rendement/revalorisation/taux). Achat au comptant → simulateurs_scpi ; nue-propriété ou usufruit → simulateurs_demembrement_scpi. — palier etude · 0.250000 USD (x402 v2, USDC/Base).

## Request body

- object
  - `duree_annees` number: Durée du crédit (années).
  - `apport` number: Apport initial (€).
  - `montant_credit` number, required: Montant emprunté (€).
  - `taux_credit` number: Taux du crédit (% annuel).
  - `taux_assurance` number: Taux d'assurance emprunteur (% du capital / an).
  - `taux_revenu` number: Taux de distribution SCPI (% annuel).
  - `taux_revalorisation` number: Revalorisation annuelle (%).
  - `taux_imposition` number: Taux d'imposition des revenus (%).

## Response `200`

Résultat sourcé — enveloppe commune (ok/confiance/sources/millesime), jamais un chiffre nu.

- Envelope
  - `ok` boolean, required: true = succès ; false = erreur (champ "error" présent à la place de result).
  - `domaine` 'fiscal' | 'retraite' | 'referentiel' | 'qotien', required: Domaine de la capacité.
  - `capability` string, required: Nom de la capacité appelée.
  - `result` object, required: Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime.
    - `value` number: Valeur principale (quand le résultat est scalaire).
    - `unit` string: Unité de value (EUR, PERCENT, RATE…).
    - `label` string: Libellé lisible du résultat.
    - `confiance` 'fiable' | 'estime' | 'partiel' | 'non_calculable' | 'sourcee' | 'variable': Confiance propre au résultat retraite (prime sur la confiance de capacité).
  - `confiance` 'fiable' | 'estime' | 'partiel' | 'non_calculable' | 'sourcee' | 'variable', required: Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable).
  - `sources` string[], required: Sources primaires/légales du calcul.
  - `referentiel` string: Version du référentiel sourcé utilisé.
  - `millesime_fiscal` string, required: Millésime fiscal (année des barèmes appliqués).
  - `annee_revenus` number: Année des revenus concernés.
  - `avertissement` string: Avertissement d'usage (résultat brut, pas un conseil personnalisé).

## Other responses

- `400`: Entrée invalide.
- `402`: Paiement requis (x402 v2, USDC/Base) — 0.250000 USD.
- `429`: Rate limit dépassé.

---

[API](https://skmtc.dev/qotien/apis/qotien-api-fiscale-retraite-sourcee-datee.md) · [All operations](https://skmtc.dev/qotien/apis/qotien-api-fiscale-retraite-sourcee-datee/llms.txt) · [OpenAPI document](https://skmtc.dev/qotien/apis/qotien-api-fiscale-retraite-sourcee-datee/revisions/c130d35543dd?raw)