sirenic

Alerts and monitoring

Create a company watchlist

The most common hole in an onboarding process is checking at entry and never coming back: insolvency proceedings open after signature. This route also watches director targets, not just companies (useful when the risk is the person).

https://api.sirenic.eu/v1OpenAPI 3.1llms.txt

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
Parameters
ParameterWhereExample
ciblesquery · required552032534,542065479
dureequery · optional30
webhookquery · optionalno example
emailquery · optionalno example
renouvellementquery · optionalno example

What is charged

  • 200Ed25519-signed response, charged at the route's price
  • 402Signed x402 quote, nothing is debited
  • 4xxUnknown or invalid identifier, never charged
  • 5xxUpstream 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:

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

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 (a name only, namesakes included, reserved to identified accounts: API key). 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

Paid via x402 or with the credits of an API key, no refund, no pro rata. The client area (/compte/surveillances) lists, stops and renews from the account credits the watches paid with a key of the account, at once or automatically at each expiry (renouvellement=auto at creation with a key); 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.

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, 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 pays on its credits: this route is not in 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 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.

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 pays on its credits: this route is not in the free quota.

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

Read next

OpenAPI · llms.txt · Full route catalogue and pricing