---
title: "Estimation de pension (données partielles)"
method: POST
path: "/api/fiscal/v1/calc/estimation"
tags: ["retraite"]
---

# Estimation de pension (données partielles)

`POST /api/fiscal/v1/calc/estimation`

## Request

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

Pension approchée à partir du statut, du revenu, de l'âge et de l'âge de départ : carrière reconstituée, SAM plafonné au PASS, décote. Rend un point central, une fourchette et un niveau de confiance. Ce N'est PAS un calcul certain — il remplace un relevé de carrière (RIS) manquant, pas l'inverse. Si le relevé de carrière ou de caisse est connu, préférer le calcul exact : régime en points → retraite_pension_regime ; fonction publique, régimes spéciaux, IEG → retraite_pension_annuites ; plusieurs régimes → retraite_pension_totale. — palier etude · 0.250000 USD (x402 v2, USDC/Base).

## Request body

- object
  - `statut` string, required: Statut (insensible à la casse et aux accents). Valeurs reconnues : "salarié cadre", "salarié non-cadre" (ou "salarié" seul = non-cadre), "fonctionnaire", "profession libérale" / "TNS" / "indépendant" (= libéral).
  - `revenu_net_imposable` number, required: Revenu net imposable annuel actuel (€).
  - `age` number, required: Âge actuel (ans).
  - `age_depart` number: Âge de départ souhaité (défaut 64).
  - `annee_debut_carriere` number: Année de début de carrière — resserre la fourchette si fournie.
  - `trimestres_acquis` number: Trimestres déjà acquis (RIS) — resserre la fourchette si fourni.
  - `traitement_indiciaire` number: Fonctionnaire uniquement : dernier traitement indiciaire brut annuel, hors primes.

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