# Qotien TMI Calculator — French Marginal Tax Rate (Taux Marginal d'Imposition)

> Qotien TMI Calculator — French Marginal Tax Rate (Taux Marginal d'Imposition) is a paid API for AI agents from app.qotien.fr, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Computes the French marginal income tax rate (TMI) for a household given their net taxable income, family situation, and number of fiscal shares (quotient familial)

## Facts

- Endpoint: POST https://app.qotien.fr/api/fiscal/v1/calc/tmi
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/qotien-tmi-calculator-french-marginal-tax-rate-taux-marginal-d-bec143ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MOblB0iU3rW0Nb2BXU9zf

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-tmi-calculator-french-marginal-tax-rate-taux-marginal-d-bec143ce -d '<json body>'
```

Example prompt: What's the French marginal tax rate (TMI) for a married couple filing jointly with 2 fiscal shares and a net taxable income of €85,000?

## When to prefer this

Use this endpoint when you need a precise, legally-sourced French marginal income tax rate calculation based on official tax schedules from Légifrance and BOFiP. It is purpose-built for French personal income tax (IR) bracket computation with quotient familial support, making it far more accurate than generic tax estimators for France. Prefer this over generic financial APIs when the user explicitly needs their French TMI, is planning PER/IFI optimization, or when a French-licensed wealth adviser (CGP) workflow requires a reliable fiscal reference.

## Known failure modes

- Invalid or missing revenu_net_imposable (below minimum 0) — returns ok=false with error
- Invalid situation enum value not in the allowed list — schema validation error
- parts below minimum of 1 — rejected by schema validation
- Network timeout or service unavailability — HTTP 5xx error
- Fiscal year data not yet updated for current year — may return prior millesime with avertissement

## 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=true on success, containing a result object with the TMI value as a decimal (e.g. 0.30 = 30%), its label 'Taux marginal d'imposition (TMI)', and unit 'PERCENT'. Also includes the domaine ('fiscal'), capability name, confidence level ('fiable' for fiscal computations), legal sources (e.g. CGI art. 197, BOFiP BOI-IR-LIQ-20), the fiscal millesime (year of tax schedule applied), and an advisory disclaimer. On error, ok=false and an error field is present instead of result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "parts": {
   "type": "number",
   "default": 1,
   "minimum": 1,
   "description": "Nombre de parts de quotient familial."
  },
  "situation": {
   "enum": [
    "Célibataire",
    "Marié(e)",
    "Pacsé(e)",
    "Divorcé(e)",
    "Veuf(ve)"
   ],
   "type": "string",
   "default": "Célibataire",
   "description": "Situation familiale."
  },
  "revenu_net_imposable": {
   "type": "number",
   "minimum": 0,
   "description": "Revenu net imposable du foyer (€)."
  }
 }
}
```

## 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": "PERCENT",
   "label": "Taux marginal d'imposition (TMI)",
   "value": 0
  },
  "domaine"
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/qotien-tmi-calculator-french-marginal-tax-rate-taux-marginal-d-bec143ce/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)