# Qotien Fiscal Referential Value Lookup

> Qotien Fiscal Referential Value Lookup 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).

Returns a sourced, dated scalar value from the French fiscal and retirement reference database for a given parameter key (e.g. IFI thresholds, PER ceilings, pension point values)

## Facts

- Endpoint: POST https://app.qotien.fr/api/fiscal/v1/calc/valeur
- 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-fiscal-referential-value-lookup-481e01de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_elhjWeaqrdE8rwZ5OSRA0

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-fiscal-referential-value-lookup-481e01de -d '<json body>'
```

Example prompt: What is the current IFI threshold for a single taxpayer ('pass' or 'cehr_seuil_celibataire') — look it up in the Qotien fiscal referential and tell me the value in euros along with its confidence level and legal source.

## When to prefer this

Choose this endpoint when you need a precise, legally sourced scalar value from the French fiscal or retirement referential (thresholds, ceilings, point values, rates) and need to cite its legal provenance (Légifrance/BOFiP). Prefer it over general web search when accuracy, traceability, and fiscal vintage metadata are required for tax simulation or CGP advisory workflows.

## Known failure modes

- Unknown or misspelled 'cle' key returns ok:false with an error field
- Key exists but value is non-calculable — confiance returns 'non_calculable'
- Stale referential version if the API is not updated after a fiscal year change
- Network timeout if the service is unavailable during high load
- Invalid JSON body returns a 400-level error

## 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 containing: a boolean success flag, the domain (fiscal/retraite/referentiel), the capability name called, a result object with the numeric value, its unit (EUR/PERCENT/RATE), and a human-readable label, a confidence enum (fiable/estime/partiel/sourcee/variable), an array of primary legal sources (Légifrance, BOFiP references), the referential version used, and the fiscal vintage year the value belongs to. On error, an 'error' field replaces 'result'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cle": {
   "type": "string",
   "description": "Clé publique stable (liste via referentiel_recherche). Ex. pass, cehr_seuil_celibataire, reversion_plafond_couple, carmf_rcv_valeur_point."
  }
 }
}
```

## 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": null,
   "label": "Valeur du référentiel (sourcée + datée)",
   "value": 0
  },
  "domain
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/qotien-fiscal-referential-value-lookup-481e01de/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)