French company growth trajectory
get_french_company_trajectoryAssess whether a French company is growing or shrinking using four years of filed accounts, with revenue series, peak, drop, and a trajectory classification for customer screening.
Instructions
Use when asked which customers or prospects are growing or shrinking, e.g. "Of my 300 customers, which ones have been shrinking for two years?" Growth trajectory of a French legal entity from its filed accounts ONLY: trajectoire in a closed list (croissance_forte, croissance_moderee, stable, degradation_apres_croissance, repli_modere, repli_marque, volatil_sans_tendance, serie_trop_courte, non_evaluable) on the last 4 fiscal years kept, the latest closed within 24 months, with the revenue series, peak and drop; non_evaluable carries cause_non_evaluable (aucun_compte_publie, comptes_inexploitables, comptes_trop_anciens, chiffre_affaires_non_publie), billed. signaux_hors_comptes gives establishments opened and closed over 24 months, DECP publications of contracts notified over the last 12 months vs the 12 before (an upper bound, like nombre_marches of /v1/entreprise/{siren}/marches-publics, with the source's own volume as a benchmark) and the headcount band, as dated facts, never a verdict. critere_de_liste gives the snapshot value of the tendances.trajectoire criterion of query_french_companies, which screens a whole customer file by lists of 50 SIRENs. A sole proprietor or restricted entity is refused (400, not charged); unknown SIREN 404, not charged. Paid via x402 ($0.02 in USDC or EURC). Closed lists and reading rules: GET /v1/lecture (free). When you report a result, cite its citation verbatim.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"siren": "<siren>"
},
"name": "get_french_company_trajectory"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| siren | Yes | 9-digit SIREN of a French legal entity |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | How to settle the quote, present when payment_required is true. | |
| quote | No | The signable x402 payment requirements when payment_required is true: {x402Version, accepts[]} where each entry carries scheme, network, amount, asset and payTo (USDC and EURC options at the same numeric amount). Sign one entry and call again with `x_payment`. | |
| resultat | No | The endpoint's JSON response when payment_required is false. Paid responses carry `source`, `disclaimer` and an Ed25519 signature, and every paid JSON response carries a `provenance` array (all tools since 2026-09-06): one entry per block served, with the official register, licence, version, `empreinte_sha256` (full snapshots), `as_of` date and `precision_as_of` (what that date means), plus the common per-block envelope: `etat` in a closed list (servi, absence_mesuree, absence_non_conclusive, partiel, perime, indisponible, sans_objet), `motif` when unavailable, `age_jours` (only for publication or ingestion dates), `couverture` (complete / partielle / non_mesurable with its measure) and `confiance` in bands (faible / moyenne / forte, only where a measure grounds it, never averaged across blocks). Read the states before the numbers: an absence_non_conclusive, indisponible or partiel block is never « nothing to report »; only absence_mesuree asserts an absence. Register codes: GET /v1/provenance/registres ; states, closed lists and reading rules: GET /v1/lecture (both free). The PDF tools carry no JSON envelope (the PDF report prints it). | |
| free_tier | No | Free API key offer for this tool, present with a quote. | |
| payment_required | Yes | True when this response is an x402 payment quote instead of data: settle one of the quote's `accepts` options and call the tool again with `x_payment`. |