# Everything that changed since a date

One question, one call: everything official sources published about the company since your date, each fact dated at publication with the event date alongside, and a closed verdict that says “nothing new” only when every block was read in full and fresh.

## What the route returns

Catalogue description, exactly as agents read it:

**What changed at a French company since a date (?depuis=YYYY-MM-DD), every official block in one call: BODACC notices (insolvency, sales, accounts filings with their figures), commercial-court decisions, public contracts (DECP, TED), establishments, cessation, licences, dated sanctions listings, trademarks and patents, RGE, lobbying register. Dated at publication, event date alongside; verdict nouveautes, rien_de_nouveau or lecture_incomplete; 100 most recent.**

## Expected identifier

9-digit company number, plus the `depuis=YYYY-MM-DD` parameter (a past day or today).

> ⚠️ 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 genuinely paid response

Dated snapshot from 2026-10-07, truncated to one item per array and then cut for length. It is not live data. The full extract is served **free of charge** from [the samples surface](https://api.sirenic.eu/exemples/entreprise-siren-nouveautes.json), and the schema from the OpenAPI document.

```
{
 "siren": "552032534",
 "denomination": "DANONE",
 "depuis": "2026-07-01",
 "verdict": "nouveautes",
 "nouveautes": [
  {
   "type": "modification",
   "date": "2026-09-02",
   "date_nature": "parution_bodacc",
   "date_evenement": null,
   "bloc": "bodacc",
   "source": "bodacc_dila",
   "reference": "B202601671193",
   "detail": {
    "famille": "modification",
    "type_avis": "Avis initial",
    "tribunal": "Greffe du Tribunal des Activités Economiques de Paris",
    "bulletin": "B",
    "role": "sujet"
   }
  }
 ],
 "totaux_par_type": {
  "modification": 1
 },
 "listes_bornees": {
  "nouveautes": {
   "nombre_total": 1,
   "tronque": false
  }
 },
 "dates_futures_ecartees": 0,
 "blocs": [
  {
   "bloc": "bodacc",
   "source_code": "bodacc_dila",
   "etat": "servi",
   "datation": "datee",
   "date_photo": "2026-10-07",
   "couverture_jusqu_au": "2026-10-07",
   "couverture": {
    "etat": "complete",
    "mesure": "toutes les annonces BODACC qui citent le SIREN, publiées depuis la date demandée / all BODACC notices citing the SIREN published since the requested date"
   },
   "consulte_le": "2026-10-07T22:28:16.157Z",
   "nombre_total": 1,
   "nombre_servi": 1,
   "lecture_complete": true,
   "dates_futures_ecartees": 0,
   "faits_non_dates": [],
   "route": "/v1/entreprise/{siren}/changements"
  }
 ],
 "hors_moteur": [
  {
   "bloc": "recrutement",
   "motif": "photo_sans_historique",
   "route": "/v1/entreprise/{siren}/emploi"
  },
  {
   "bloc": "dirigeants",
   "motif": "aucun_historique_conserve",
   "route": "/v1/entreprise/{siren}"
  },
  {
   "bloc": "tranche
…
```

## Price and billing

Price: **$0.05**. 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/552032534/nouveautes?depuis=2026-07-01"

# 2. The paid call: the x402 client settles the quote and replays the request
npx x402-fetch "https://api.sirenic.eu/v1/entreprise/552032534/nouveautes?depuis=2026-07-01"

# 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

Hiring, officers and headcount band are **outside the engine**: no history of them is kept, and the response says so with the route that serves them. Monthly stocks (Sirene, French public contracts) see nothing after their snapshot: for a more recent date, the response says `lecture_incomplete` and names those blocks, **never `rien_de_nouveau`**. A sole proprietorship is not covered (refused, never charged).

## Neighbouring routes

- `/v1/entreprise/{siren}/changements`: $0.01
- `/v1/surveillance/creer`: $0.05 (30 days) · $0.135 (90 days) · $0.50 (365 days) / entity

## How you pay

Every route is paid **per call**, in USDC or EURC on the Base network, over the x402 protocol: no account to create, no API key, no subscription. 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, on 106 of 122 routes (the price list says which), 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}/nouveautes` | $0.05 | [free sample](https://api.sirenic.eu/exemples/entreprise-siren-nouveautes.json) | What changed at a French company since a date (?depuis=YYYY-MM-DD), every official block in one call: BODACC notices (insolvency, sales, accounts filings with their figures), commercial-court decisions, public contracts (DECP, TED), establishments, cessation, licences, dated sanctions listings, trademarks and patents, RGE, lobbying register. Dated at publication, event date alongside; verdict nouveautes, rien_de_nouveau or lecture_incomplete; 100 most recent. |

## Take it further

- [See a real response (free)](https://api.sirenic.eu/exemples/entreprise-siren-nouveautes.json)
- [Get the quote for /v1/entreprise/{siren}/nouveautes](https://api.sirenic.eu/v1/entreprise/552032534/nouveautes?depuis=2026-07-01)
- [Create an account: 150 free calls a month](https://api.sirenic.eu/compte?lang=en&utm_source=recherche&utm_campaign=referencement)

## Read next

- [Know what changed at a customer since your last contact](https://api.sirenic.eu/en/use-cases/know-what-changed-at-customer-since-your-last-contact)


---

[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)
