---
title: "Pension totale consolidée (multi-régimes, le détail du RIS)"
method: POST
path: "/api/fiscal/v1/calc/pension_totale"
tags: ["retraite"]
---

# Pension totale consolidée (multi-régimes, le détail du RIS)

`POST /api/fiscal/v1/calc/pension_totale`

## Request

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

Somme les régimes EN POINTS d'un relevé (base CNAVPL + tous les complémentaires/ASV), splitte base/complémentaire, applique la couche brut→net (1 % maladie sur la seule part complémentaire). Les régimes qui ne sont pas en points se fournissent via pensions_fournies : fonction publique, régimes spéciaux et IEG → montant calculé par retraite_pension_annuites ; régime général CNAV → montant du RIS, ou à défaut retraite_estimation. Chaque jambe est vraisemblance-vérifiée ; la confiance globale suit la jambe la plus faible. Point d'ENTRÉE pour une carrière multi-régimes : un seul appel fait la somme — ne pas y ajouter ensuite les résultats de retraite_pension_regime pour les mêmes régimes. — palier etude · 0.250000 USD (x402 v2, USDC/Base).

## Request body

- object
  - `regimes` object[], required: Régimes en points du relevé. Chaque item : { code_regime, points, [age_depart, age_legal, trimestres_manquants, trimestres_acquis, trimestres_requis] }.
    - `code_regime` 'agirc_arrco' | 'ircantec' | 'rci' | 'rafp' | 'cipav_base' | 'carmf_base' | 'carpimko_base' | 'carcdsf_base' | 'cavec_base' | 'cavom_base' | 'cavamac_base' | 'carpv_base' | 'cprn_base' | 'cavp_base' | 'cipav_comp' | 'carmf_rcv' | 'carmf_asv' | 'carpimko_comp' | 'carpimko_asv' | 'carcdsf_comp' | 'cnbf_comp' | 'cavec_comp' | 'cavom_comp' | 'cavamac_comp' | 'carpv_comp' | 'cprn_b' | 'cprn_c' | 'ircec_raap', required
    - `points` number, required
    - `age_depart` number
    - `age_legal` number
    - `trimestres_manquants` number
    - `trimestres_acquis` number
    - `trimestres_requis` number
  - `pensions_fournies` object[]: Jambes NON calculées par nous (ex. CNAV base, fonction publique) : { label, montant_annuel, [etage:"base"|"complementaire"] }. Additionnées telles quelles, flaggées « fourni » (confiance non assertée par le hub).
    - `label` string
    - `montant_annuel` number, required
    - `etage` 'base' | 'complementaire'
  - `rfr` number: RFR 2024 du foyer — active le calcul du net (prélèvements sociaux). Sinon le total brut sert de proxy.
  - `parts` number: Parts fiscales du foyer.
  - `inclure_net` boolean: Calculer la pension nette après prélèvements sociaux (défaut true).

## 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)