# Qotien Fiscal Reference Search API

> Qotien Fiscal Reference Search API 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).

Searches the French fiscal and retirement reference database to look up tax rules, thresholds, rates, and regime details by keyword and domain

## Facts

- Endpoint: POST https://app.qotien.fr/api/fiscal/v1/calc/recherche
- 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-reference-search-api-6bce50b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FZz324QWR7PxWCe1KCDqY

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-reference-search-api-6bce50b1 -d '<json body>'
```

Example prompt: Search the Qotien fiscal reference database for 'plafond IFI' in the fiscal domain — I need the current IFI wealth tax threshold with its legal source and confidence level.

## When to prefer this

Choose this endpoint when you need to look up specific French fiscal parameters, tax thresholds, retirement regime rules, or succession tax data from authoritative legal sources (Légifrance, BOFiP). It is ideal for CGP (wealth management advisor) workflows requiring cited, versioned regulatory data. Prefer this over generic web search when you need structured, machine-readable fiscal values with confidence levels and legal citations. Not suitable for personalized tax advice or non-French jurisdictions.

## Known failure modes

- No match found for the keyword — result returns value:0 with label indicating no result
- Invalid domain enum value — API returns validation error
- Query too vague or misspelled — low-confidence or empty result
- Fiscal reference data not yet updated for current year — millesime_fiscal may lag
- ok:false returned with error field instead of result when internal calculation fails

## 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: a boolean success flag, the matched capability name, a result object containing the numeric value, unit (EUR/PERCENT/RATE), and human-readable label, a confidence level (fiable/estime/partiel/non_calculable/sourcee/variable), an array of primary legal sources (Légifrance, BOFiP references), the fiscal year (millesime_fiscal), and a usage warning that results are informational and not personalized advice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Mot-clé cherché dans la clé publique ou le libellé."
  },
  "domaine": {
   "enum": [
    "fiscal",
    "retraite",
    "succession"
   ],
   "type": "string",
   "description": "Filtre par domaine."
  }
 }
}
```

## 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": "Recherche dans le référentiel",
   "value": 0
  },
  "domaine": "refer
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/qotien-fiscal-reference-search-api-6bce50b1/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)