sirenic

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.

See a real response (free) Get the quote for /v1/surveillance/creer

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, under a name only: the watch also follows its namesakes, and it is reserved to identified accounts (API key), like filed deeds. 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.

On an association target (RNA number)

Every new notice published in the Official Journal of associations (JOAFE) under that RNA number, whatever its type, reported with its identifier, type and issue date. The target is written as the number itself, W followed by 9 characters, in the same list as company numbers and directors; a legacy identifier without a W has no JOAFE notice and is not accepted. The first run records the notices already published without reporting them, and a stale JOAFE is recorded as a source that is down, never read as “nothing to report”.

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.

It is paid via x402 or with the credits of an API key, no refund, no pro rata. The client area (the Watchlists tab, /compte/surveillances) lists the watches paid with a key of the account, stops them and renews them from the account credits, at once or automatically at each expiry (renouvellement=auto at creation with a key, or the switch on the screen; never above the amount shown); a watch paid via x402 is linked there by its token. Keep the token returned at creation: the screen never shows it, and it is how you poll and renew the watch through the API.

Three ways to be notified

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, 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; /v1/surveillance/creer and /v1/surveillance/{jeton}/renouveler are not in it and are paid on its credits. 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 and in 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

RoutePriceSampleWhat it returns
/v1/surveillance/creer$0.05 (30 days) · $0.135 (90 days) · $0.50 (365 days) / entityfree sampleFrench monitoring: 30, 90 or 365-day KYB/compliance watchlist (?duree=), checked DAILY on official sources; signed webhook, email digest, pollable. Companies (SIREN): BODACC, status, officers, sanctions/AMF blacklist, PSAN/SGP, Seveso, commercial-court decisions, FR/EU awards. Directors (dirigeant:Name, identified accounts only): new/ended offices. Associations (RNA W…): JOAFE notices. Per target (1-100): $0.05 / $0.135 / $0.50. x402 or API-key credits, no refund; renouvellement=auto renews.
/v1/surveillance/{jeton}/renouveler$0.05 (30 days) · $0.135 (90 days) · $0.50 (365 days) / entityfree sampleWatchlist renewal: extend a watchlist of companies (SIREN), directors (dirigeant:Name, identified accounts only) and/or associations (RNA) by 30, 90 or 365 days (?duree=, default 30, whatever the original) of daily official checks: $0.05 / $0.135 / $0.50 per target. cibles must repeat the exact watched targets: it sets the quote. Possible until 7 days after expiry, then purged. No refund, no pro rata. Auto-renewal on credits: renouvellement=auto at creation with an API key, or in the account.
/v1/entreprise/{siren}/changements$0.01free sampleCompany 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.01free sampleLegal 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 and an account API key: the director target is reserved to identified accounts, like filed deeds, and without an account it is refused before any quote. It is a name only, which also follows its namesakes without telling them apart. The watch returns only new and ended offices from official publications: no personal data beyond what the registry publishes. The name you pass appears in clear, with the creation request, in the log of our front-end server, kept 7 days at most, until the filter that removes it is in place.

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

The first step is free and shows you exactly what you would be buying, with no account or key; an account, with its API key, then opens the free quota; /v1/surveillance/creer and /v1/surveillance/{jeton}/renouveler are not in it and are paid on its credits.

See a real response (free) Get the quote for /v1/surveillance/creer Read the route reference Create an account: 150 free calls a month up to EUR 2 of value

Read next

OpenAPI · llms.txt · Full route catalogue and pricing