---
title: "Optimisation de fin de carrière (menu classé des leviers)"
method: POST
path: "/api/fiscal/v1/calc/optimisation"
tags: ["retraite"]
---

# Optimisation de fin de carrière (menu classé des leviers)

`POST /api/fiscal/v1/calc/optimisation`

## Request

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

À partir d'une situation (âge, trimestres, SAM, statut, enfants…), renvoie le MENU CLASSÉ des leviers d'optimisation retraite avec gain/ROI/confiance/sources : rachat de trimestres (2 options), surcote parentale, retraite progressive, âge de départ optimal, cumul emploi-retraite, optimisation du SAM, PER fin de carrière. PAS de total sommé (les leviers ne s'additionnent pas naïvement) — chaque levier chiffré séparément, classé par pertinence. Chaque montant porte sa confiance et sa source (Legifrance/BOFiP/service-public). — palier optimiseur · 1.000000 USD (x402 v2, USDC/Base).

## Request body

- object
  - `age` number, required: Âge actuel (ans).
  - `age_legal` number: Âge légal de départ (défaut 64).
  - `date_naissance` string, date: Date de naissance (YYYY-MM-DD) — recale le gel LFSS 2026 et la fenêtre surcote parentale.
  - `statut` string: Statut (insensible à la casse/accents). Reconnus : "salarié" (défaut), "fonctionnaire", "profession libérale" / "TNS" / "indépendant".
  - `sam` number: Salaire annuel moyen (25 meilleures années) — active les gains chiffrés.
  - `trimestres_acquis` number
  - `trimestres_requis` number
  - `trim_manquants` number: Trimestres manquants pour le taux plein — active le levier rachat.
  - `pension_brute_annuelle` number: Pension de base brute annuelle — active les gains nets.
  - `pension_complementaire_annuelle` number
  - `nb_enfants` number: Nombre d'enfants — active surcote parentale (MDA) + majoration ≥3.
  - `mda_parentale` boolean: ≥1 trimestre de majoration de durée d'assurance pour enfant.
  - `tmi` number: TMI en FRACTION 0-1 (ex. 0,30 pour 30 %) — chiffre l'économie d'IR du rachat / PER. ⚠️ l'outil "tmi" RENVOIE un pourcentage (30) ; ici on attend la fraction (0,30).
  - `rfr` number: RFR — active le net (prélèvements sociaux).
  - `parts` number
  - `quotite_travail` number: Retraite progressive : quotité de temps partiel (0-1).
  - `salaires_annuels` object[]: Optionnel : carrière année par année pour l'optimisation du SAM.
    - `annee` number, required: Année civile (ex. 2018).
    - `salaire_brut` number, required: Salaire brut de cette année (€).

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