GET/v1/surveillance/creer
- Price
- $0.05 (30 days) · $0.135 (90 days) · $0.50 (365 days) / entity
- Free quota
- No
- Family
- Alerts and monitoring
| Parameter | Where | Example |
|---|---|---|
cibles | query · required | 552032534,542065479 |
duree | query · optional | 30 |
webhook | query · optional | no example |
email | query · optional | no example |
What is charged
200Ed25519-signed response, charged at the route's price402Signed x402 quote, nothing is debited4xxUnknown or invalid identifier, never charged5xxUpstream source unavailable, never charged
See a real response (free) Get the quote for /v1/surveillance/creer
What the route returns
Catalogue description, exactly as agents read it:
Monitoring for France: a 30, 90 or 365-day watchlist (?duree=) for KYB & compliance alerts, checked DAILY against official sources; Ed25519-signed webhook and/or e-mail digest, always pollable. Companies (SIREN): BODACC, status, officers, sanctions/AMF blacklist, PSAN/SGP, Seveso, commercial-court decisions, FR/EU procurement awards. Directors (dirigeant:Name): new/ended offices. Associations (RNA W…): JOAFE notices. Per target (1-100) x duration: $0.05 / $0.135 / $0.50. No account, no refund.
Expected identifier
cibles parameter: 1 to 100 targets, each a company number, an association RNA number (W followed by 9 characters) or a target of the form dirigeant:Name. Plus duree=30|90|365.
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.
Price and billing
Price: $0.05 (30 days) · $0.135 (90 days) · $0.50 (365 days) / entity. 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.
Batch billing: the cibles parameter accepts 1 to 100 comma-separated values, and the amount is the unit price times the number of values. The quote is frozen before settlement: there is no partial settlement.
The unit price additionally depends on the duree parameter, from a closed list: $0.05 (30 days), $0.135 (90 days), $0.50 (365 days). Default value: 30.
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.
What this route does not do
No account, therefore no dashboard and no refund, no pro rata. Keep the token returned at creation: it alone allows polling and renewal.
Neighbouring routes
/v1/surveillance/{jeton}/renouveler: $0.05 (30 days) · $0.135 (90 days) · $0.50 (365 days) / entity/v1/entreprise/{siren}/changements: $0.01
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 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 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
Routes used and pricing
| Route | Price | Sample | What it returns |
|---|---|---|---|
/v1/surveillance/creer | $0.05 (30 days) · $0.135 (90 days) · $0.50 (365 days) / entity | free sample | Monitoring for France: a 30, 90 or 365-day watchlist (?duree=) for KYB & compliance alerts, checked DAILY against official sources; Ed25519-signed webhook and/or e-mail digest, always pollable. Companies (SIREN): BODACC, status, officers, sanctions/AMF blacklist, PSAN/SGP, Seveso, commercial-court decisions, FR/EU procurement awards. Directors (dirigeant:Name): new/ended offices. Associations (RNA W…): JOAFE notices. Per target (1-100) x duration: $0.05 / $0.135 / $0.50. No account, no refund. |
Take it further
No account to create, no key to request: the first step is free and shows you exactly what you would be buying.
See a real response (free) Get the quote for /v1/surveillance/creer Get notified about euro packs