# Qotien Pension Annuities Calculator (French Special Regimes)

> Qotien Pension Annuities Calculator (French Special Regimes) is a paid API for AI agents from app.qotien.fr, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Calculates annual pension amounts for French annuity-based retirement regimes (fonction publique, SNCF, RATP, IEG, etc.) given age, service duration, and reference salary.

## Facts

- Endpoint: POST https://app.qotien.fr/api/fiscal/v1/calc/pension_annuites
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/qotien-pension-annuities-calculator-french-special-regimes-eb1e0dfa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m2glYMnRJELc9q-bPjmeB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability qotien-pension-annuities-calculator-french-special-regimes-eb1e0dfa -d '<json body>'
```

Example prompt: Can you calculate the annual pension for a French civil servant (fonction_publique) with a reference salary of €42,000, retiring at age 64 with 168 liquidable quarters out of 172 required?

## When to prefer this

Use this endpoint when you need to compute pension amounts specifically for French annuity-based retirement regimes (fonction publique, SNCF, RATP, Banque de France, IEG, CRPCEN, Opéra, Comédie-Française, FSPOEIE). It applies the correct prorata formula (liquidable quarters ÷ required quarters × accrual rate × reference salary) and automatically handles early-departure penalties. Prefer it over generic retirement calculators when the user falls under one of these 9 special regimes rather than the standard CNAV/AGIRC-ARRCO general regime.

## Known failure modes

- Invalid code_regime value returns validation error — must be one of the 9 supported enum values
- age_depart below minimum of 50 triggers schema validation failure
- salaire_reference of 0 returns a pension of 0 with no error
- Missing required fields returns error with ok:false and error description
- Ambiguous trimestres_liquidables exceeding trimestres_requis may produce unexpected prorata results
- Network timeout or payment failure returns HTTP 402 if x402 payment not completed

## How this service works

Simulateur IFI, PER, IR et retraite (32 régimes). Logiciel CGP : bilan patrimonial, déclaration 2042, LMNP. Chiffres sourcés Légifrance et BOFiP. 14 jours d'essai.

## Output

Returns a JSON object with ok status, a result object containing the computed annual pension value in EUR with a human-readable label, a confidence level (fiable/estime/partiel/variable), an array of official legal sources (Légifrance, BOFiP), the fiscal vintage used, and any applicable usage warnings. Early departure penalties (1.25%/quarter, capped at 20%) are automatically applied when departure age is below the full-rate cancellation age.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "age_legal": {
   "type": "number",
   "default": 64,
   "minimum": 60,
   "description": "Âge légal du régime (ancre du temps). Défaut 64."
  },
  "age_depart": {
   "type": "number",
   "minimum": 50,
   "description": "Âge de liquidation (ans). Défaut = taux plein (aucune décote). Un départ avant l'âge d'annulation applique la décote 1,25 %/trim (plafond 20)."
  },
  "code_regime": {
   "enum": [
    "fonction_publique",
    "fspoeie",
    "sncf",
    "ratp",
    "banque_de_france",
    "crpcen",
    "opera",
    "comedie_francaise",
    "ieg"
   ],
   "type": "string",
   "description": "Code du régime en annuités (voir retraite_regimes). Ex. fonction_publique, sncf, ratp, banque_de_france, ieg."
  },
  "salaire_reference": {
   "type": "number",
   "minimum": 0,
   "description": "Assiette annuelle brute : dernier traitement indiciaire (fonction publique) ou salaire/traitement de référence des derniers mois (régimes spéciaux, IEG), HORS primes."
  },
  "trimestres_requis": {
   "type": "number",
   "default": 172,
   "minimum": 1,
   "description": "Durée d'assurance requise pour le taux plein (défaut 172)."
  },
  "trimestres_liquidables": {
   "type": "number",
   "default": 0,
   "minimum": 0,
   "description": "Trimestres liquidés au régime (numérateur du prorata durée liquidée ÷ requise)."
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/qotien-pension-annuities-calculator-french-special-regimes-eb1e0dfa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from app.qotien.fr](https://www.zero.xyz/host/app.qotien.fr/llms.txt)