# Monitoring a portfolio of customers or suppliers

Checking a customer at onboarding and never looking again is the most common hole in an onboarding process. Insolvency proceedings open after signature, not before. /v1/surveillance/creer sets up a watch on 1 to 100 targets, checked daily against official sources.

## What is watched

### On a company target

Filings in the official legal-notices gazette, status changes, officer movements, sanctions and market-authority blacklist screening, authorisations of digital-asset service providers and asset managers, Seveso classification, and **new French and EU public-procurement awards**.

### On a director target

New and ended directorships. Useful when the risk is not the company but the person running it — a director accumulating offices in distressed companies is a signal that watching the company alone will not give you.

## Three durations, one price per target per duration

The duration is chosen at creation time (`?duree=` parameter): 30, 90 or 365 days. The quote is **priced on two axes** — number of targets × duration — and frozen before settlement. The three unit prices appear in the routes table below; they are deliberately not repeated in this text, so that they cannot go stale in it.

Renewal (`/v1/surveillance/{jeton}/renouveler`) accepts any duration regardless of the original one, and remains possible **until 7 days after expiry** — after that the watch is purged. The `cibles` parameter must repeat the watched targets exactly: that is what the quote is computed from.

> ⚠️ No account, therefore no dashboard and **no refund, no pro rata**. Keep the token returned at creation: it is the only way to poll and renew the watch.

## Three ways to be notified

- **Ed25519-signed webhook**: you verify the signature with our public key and know the alert really comes from us, with no shared secret to rotate.
- **E-mail digest**, for human use.
- **Polling**: the watch stays queryable at any time with its token, which spares you exposing a public endpoint to receive a webhook.

## Watch, or poll occasionally?

If your portfolio is small and your rhythm monthly, `/v1/entreprise/{siren}/changements?depuis=YYYY-MM-DD` is enough: it returns announcements published since a date, and you only pay when you ask. A watch earns its price as soon as detection latency matters — because it checks **every day**, including the days you forget to ask.

> ⚠️ The changes route detects **new publications in the legal-notices gazette**, not field-level edits of a company record: the identity stock is a monthly snapshot and keeps no history. Do not expect it to catch a silent address change.

## 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.

Would you rather have a euro invoice and prepaid credits? That is **in preparation**, and we will not announce a date until it is open. Write to [contact@sirenic.eu](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs) and we will let you know when it opens.

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**

```
# Client x402 (npm) — le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## Routes used and pricing

| Route | Price | What it returns |
| --- | --- | --- |
| `/v1/surveillance/creer` | $0.05 (30 j) · $0.135 (90 j) · $0.50 (365 j) / entité | Company monitoring for France: a 30, 90 or 365-day surveillance watchlist (?duree=), recurring KYB & compliance alerts. Each target checked DAILY against official sources; Ed25519-signed webhook and/or e-mail digest, always pollable. Company targets (SIREN): BODACC, status, officers, sanctions/AMF blacklist, PSAN/SGP, Seveso, new FR & EU procurement awards. Director targets (dirigeant:Name): new/ended offices. Per target (1-100) x duration: $0.05 / $0.135 / $0.50. No account, no refund. |
| `/v1/surveillance/{jeton}/renouveler` | $0.05 (30 j) · $0.135 (90 j) · $0.50 (365 j) / entité | Watchlist renewal: extend an existing company monitoring watchlist by 30, 90 or 365 days (?duree=, default 30, any duration whatever the original) of daily surveillance against official sources — $0.05 / $0.135 / $0.50 per target. The cibles parameter must repeat the exact watched targets: it is what the quote is computed from. Possible until 7 days after expiry, then the watch is purged. No refund, no pro rata. |
| `/v1/entreprise/{siren}/changements` | $0.01 | Company changes monitoring for a French company: the new official BODACC gazette announcements published SINCE a given date (?depuis=YYYY-MM-DD) — the poll endpoint for watchlist and portfolio surveillance. Returns the new announcements (insolvency, deregistration, sales, filings, changes) in reverse-chronological order. Note: detects new BODACC publications, not field-level edits of the Sirene/RNE profile (the monthly stock keeps no history). |
| `/v1/entreprise/{siren}/alertes` | $0.01 | Legal alerts for a French company from BODACC, the official French gazette of legal notices: insolvency proceedings (procedures collectives) and related court filings, deregistrations and business sales, grouped and most recent first. Check whether a French company is subject to collective proceedings before you contract — a due diligence, KYB and compliance signal for supplier onboarding and risk monitoring, drawn from official registry data. |

## Frequently asked questions

### How do I verify the webhook signature?

With our published Ed25519 public key. Verification takes a few lines in any language, and a worked example ships in our examples repository.

### Can I watch a director by name?

Yes, with a target of the form dirigeant:Name. The name you pass is never logged, and the watch returns only new and ended offices from official publications — no personal data beyond what the registry publishes.

### What if an official source is down for a day?

The run is deferred, not discarded. This is a design rule: an unavailable source must never produce a silence that reads as “nothing to report”. Nor can a successful-but-empty run refresh the snapshot's age — that particular disarming was identified and closed.

## Take it further

- [See a real response (free)](https://api.sirenic.eu/exemples/surveillance-creer.json)
- [Get the quote for /v1/surveillance/creer](https://api.sirenic.eu/v1/surveillance/creer)
- [Read the route reference](https://api.sirenic.eu/en/api)
- [Get notified about euro packs](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs)

## Read next

- [Assessing a customer's default risk](https://api.sirenic.eu/en/use-cases/assess-customer-s-default-risk-with-scorecard-returned)
- [Detecting insolvency proceedings](https://api.sirenic.eu/en/use-cases/detect-insolvency-proceedings-france-europe)

---

Volume figures on this page were measured in our database on 2026-08-19. They are dated snapshots, not live counters.

Full catalogue : https://api.sirenic.eu/