{"uid":"cap_elhjWeaqrdE8rwZ5OSRA0","slug":"qotien-fiscal-referential-value-lookup-481e01de","name":"Qotien Fiscal Referential Value Lookup","description":"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.","url":"https://app.qotien.fr/api/fiscal/v1/calc/valeur","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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},"domaine":"referentiel","sources":["references_officielles.json v0.8.6"],"confiance":"sourcee","capability":"valeur","referentiel":"references_officielles.json v0.8.6","annee_revenus":2025,"millesime_fiscal":"2026"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1bfk1wHMFpZWJB5BpHFKI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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)","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"IFI surtax threshold for singles","prompt":"What is the current CEHR surtax threshold for a single person in France? I need the exact euro value, the unit, and which legal source it comes from."},{"title":"CARMF pension point value","prompt":"Look up the current CARMF RCV pension point value in the Qotien referential — I need the numeric value, its unit, and how confident the system is in that figure."},{"title":"PER deduction ceiling check","prompt":"What is the official PER deduction ceiling I should use for a retirement planning simulation this fiscal year? Give me the sourced value and the fiscal vintage it applies to."}],"resultDescription":"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'.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:45:58.385Z","isFirstParty":false}