# Qotien French Retirement Pension Estimator

> Qotien French Retirement Pension Estimator 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).

Estimates French retirement pension for salaried workers, civil servants, and self-employed professionals across 32 pension schemes based on age, status, and career data

## Facts

- Endpoint: POST https://app.qotien.fr/api/fiscal/v1/calc/estimation
- 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-french-retirement-pension-estimator-2bcaed1c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YcUVzD4I0Tywxs42qovng

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-french-retirement-pension-estimator-2bcaed1c -d '<json body>'
```

Example prompt: I'm a 45-year-old cadre salarié earning €55,000 net imposable per year, I started working in 2001 and have 92 trimestres acquis — can you estimate my French retirement pension if I retire at 64?

## When to prefer this

Choose this endpoint when you need a French-law-grounded retirement pension estimate for one of the supported statuts (salarié, fonctionnaire, profession libérale/TNS) and want results sourced from Légifrance and BOFiP across 32 pension schemes. It is especially valuable when career data (trimestres, career start year) is available to narrow the estimate range. Prefer it over generic financial calculators when French regulatory accuracy and legal source traceability matter.

## Known failure modes

- Missing required fields (age or statut) returns ok=false with an error field
- Unrecognized statut value causes parsing failure
- Age below 16 or trimestres_acquis below 0 fail schema validation
- Insufficient career data results in confiance='partiel' or 'non_calculable' with a reduced estimate
- Payment not provided or rejected (HTTP 402) blocks the call entirely

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

A JSON object with ok=true, the domain ('retraite'), a result object containing the estimated pension value in EUR with a label and unit, a confidence level (fiable/estime/partiel/variable), an array of legal sources (CNAV, AGIRC-ARRCO, etc.), the fiscal vintage used, and an optional warning that the result is an estimate and not personalized advice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "age": {
   "type": "number",
   "minimum": 16,
   "description": "Âge actuel (ans)."
  },
  "statut": {
   "type": "string",
   "description": "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)."
  },
  "age_depart": {
   "type": "number",
   "default": 64,
   "minimum": 50,
   "description": "Âge de départ souhaité (défaut 64)."
  },
  "trimestres_acquis": {
   "type": "number",
   "minimum": 0,
   "description": "Trimestres déjà acquis (RIS) — resserre la fourchette si fourni."
  },
  "annee_debut_carriere": {
   "type": "number",
   "description": "Année de début de carrière — resserre la fourchette si fournie."
  },
  "revenu_net_imposable": {
   "type": "number",
   "minimum": 0,
   "description": "Revenu net imposable annuel actuel (€)."
  },
  "traitement_indiciaire": {
   "type": "number",
   "minimum": 0,
   "description": "Fonctionnaire uniquement : dernier traitement indiciaire brut annuel, hors primes."
  }
 }
}
```

## 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": "Estimation de pension (données partielles)",
   "value": 0
  },
  "do
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/qotien-french-retirement-pension-estimator-2bcaed1c/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)
