# Company trajectory: growth or contraction

This route says whether a company is growing or shrinking, from its filed accounts only: a closed-list verdict over its last 4 fiscal years kept, the latest closed within 24 months, with the revenue series, its peak and its drop. Establishments opened and closed over 24 months, publications of contracts notified over 12 months and the headcount band come alongside, as dated facts, never as a verdict. When the accounts do not support a conclusion, the response says non_evaluable with its cause.

## What the route returns

Catalogue description, exactly as agents read it:

**Growth trajectory of a French company: Of my 300 customers, which ones have been shrinking for two years? A closed-list verdict from filed accounts only, over the last 4 fiscal years (latest closed within 24 months): revenue series, peak, drop, and non_evaluable with its cause. Establishments opened and closed, public contracts and headcount band are dated facts, never a verdict. To screen a list: tendances.trajectoire on /v1/entreprises/requete, 50 SIRENs per call.**

## Expected identifier

9-digit company number of a legal entity. To screen a whole file: the `tendances.trajectoire` criterion of `/v1/entreprises/requete/compter` and `/lister`, by lists of 50 company numbers.

> ⚠️ A wrongly formatted identifier in the **path** returns `400` and is **not billed**, but it costs you a round trip. It is the leading cause of failed calls on the foreign routes. A **search** parameter, by contrast, is cleaned up: unsupported characters are stripped and the usable query is served.

## Extract from a response rendered on test data

Dated snapshot from 2026-10-21, rendered by the route on test data (fictitious companies), with no purchase, truncated by removal, some arrays keeping several items, then cut for length here. It is not live data. The full extract is served **free of charge** from [the samples surface](https://api.sirenic.eu/exemples/entreprise-siren-trajectoire.json), and the schema from the OpenAPI document.

```
{
 "siren": "000000158",
 "trajectoire": "croissance_forte",
 "cause_non_evaluable": null,
 "fenetre": {
  "exercices_max": 4,
  "age_max_mois": 24,
  "exercices_retenus": 4,
  "derniere_cloture": "2025-12-01",
  "age_derniere_cloture_mois": 10
 },
 "comptes": {
  "serie": [
   {
    "date_cloture": "2022-12-01",
    "chiffre_affaires": 1000000,
    "motif_hors_tendance": null
   },
   {
    "date_cloture": "2025-12-01",
    "chiffre_affaires": 1800000,
    "motif_hors_tendance": null
   }
  ],
  "variation_premier_dernier_pct": 80,
  "annee_pic": 2025,
  "chiffre_affaires_pic": 1800000,
  "repli_depuis_le_pic_pct": 0,
  "regularite": "reguliere",
  "source": {
   "flux": "ratios-financiers-inpi-bce",
   "date": "2026-09-15"
  }
 },
 "signaux_hors_comptes": {
  "lecture": "faits_sans_verdict",
  "etablissements": {
   "ouverts": 3,
   "fermes": 0,
   "solde": 3,
   "du": "2024-10-22",
   "au": "2026-10-21",
   "code": null,
   "source": {
    "flux": "sirene-stock-etablissements",
    "date": "2026-10-01"
   }
  },
  "marches": {
   "derniers_12_mois": {
    "nombre": 4,
    "du": "2025-10-22",
    "au": "2026-10-21"
   },
   "precedents_12_mois": {
    "nombre": 1,
    "du": "2024-10-22",
    "au": "2025-10-21"
   },
   "repere_source": null,
   "motif_repere": "pas_encore_calcule",
   "code": "volume_source_variable",
   "source": {
    "flux": "decp-marches-valides",
    "date": "2026-09-30"
   }
  },
  "effectif": {
   "tranche": "12",
   "annee": 2023,
   "code": "niveau_sans_historique",
   "source": {
    "flux": "sirene-stock-unites-legales",
    "date": "2026-10-01
…
```

## Price and billing

Price: **$0.02**. The authoritative amount is the one in the `402` quote returned by the route itself, not this text, which derives from the same grid but is still just a page.

An error response **cancels the payment**: a `400`, `404` or `503` is never billed. An upstream outage closes the route with a `503` rather than serving a degraded response.

## Calling the route

```
# 1. The quote, without paying anything: the route answers 402 with its amount
curl -i "https://api.sirenic.eu/v1/entreprise/000000158/trajectoire"

# 2. The paid call: the x402 client settles the quote and replays the request
npx x402-fetch "https://api.sirenic.eu/v1/entreprise/000000158/trajectoire"

# 3. Or over MCP, in Claude Code / Cursor / an agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

# Or as a local server (stdio), with your key or an x402 wallet
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp
```

## What this route does not do

**A verdict on the accounts, not a forecast.** Accounts are published one to two fiscal years late. A sole proprietor or a company under restricted diffusion is refused, never billed.

## Neighbouring routes

- `/v1/entreprise/{siren}/finances`: $0.01
- `/v1/entreprise/{siren}/sante`: $0.15
- `/v1/entreprises/requete/lister`: $0.02

## How you pay

Every route is paid **per call**, two ways, with no subscription: over x402, in USDC or EURC on the Base network, with no account and no API key; or with the API key of an account, which opens the free quota. Over x402, the first call returns a `402` quote your client settles, then replays the call. A failed call is never billed.

Open today: 150 free calls a month with an account, up to EUR 2 of value, on 122 of 129 routes (the price list says which), with 100 more free lines a month on batch identity, and pay-per-call over x402 (USDC or EURC), with no account except registry filings. Prepaid credits: card top-up is not open yet.

Paid responses are **Ed25519-signed**: you can later prove what was served to you, and when. The whole catalogue is free to read in the [OpenAPI document](https://api.sirenic.eu/openapi.json) and in [llms.txt](https://api.sirenic.eu/llms.txt).

**One call, end to end**

```
# x402 client (npm): the 402 quote is settled and the call replayed automatically
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Or over MCP, in Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

# Or as a local server (stdio), with your key or an x402 wallet
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp
```

## Routes used and pricing

| Route | Price | Sample | What it returns |
| --- | --- | --- | --- |
| `/v1/entreprise/{siren}/trajectoire` | $0.02 | [free sample](https://api.sirenic.eu/exemples/entreprise-siren-trajectoire.json) | Growth trajectory of a French company: Of my 300 customers, which ones have been shrinking for two years? A closed-list verdict from filed accounts only, over the last 4 fiscal years (latest closed within 24 months): revenue series, peak, drop, and non_evaluable with its cause. Establishments opened and closed, public contracts and headcount band are dated facts, never a verdict. To screen a list: tendances.trajectoire on /v1/entreprises/requete, 50 SIRENs per call. |

## Take it further

- [See a response on test data (free)](https://api.sirenic.eu/exemples/entreprise-siren-trajectoire.json)
- [Get the quote for /v1/entreprise/{siren}/trajectoire](https://api.sirenic.eu/v1/entreprise/000000158/trajectoire)
- [Create an account: 150 free calls a month up to EUR 2 of value](https://api.sirenic.eu/compte?lang=en&utm_source=recherche&utm_campaign=referencement)

## Read next

- [Target growing companies, screen out those that are shrinking](https://api.sirenic.eu/en/use-cases/target-growing-companies-screen-out-those-that-are-shrinking)
- [Find prospects that look like your best customers](https://api.sirenic.eu/en/use-cases/find-prospects-that-look-like-your-best-customers)


---

[Home](https://api.sirenic.eu/en) · [Pricing](https://api.sirenic.eu/en/offres) · [Guides](https://api.sirenic.eu/en/articles) · [Routes](https://api.sirenic.eu/en/api) · [About](https://api.sirenic.eu/en/about) · [Legal notice](https://api.sirenic.eu/mentions-legales) · [Privacy](https://api.sirenic.eu/en/privacy)
