sirenic

Alerts and monitoring

Renew a watchlist

Three details decide whether this call succeeds. First, the cibles parameter must repeat the watched targets exactly, because that is what the quote is computed from. Second, the renewal window closes 7 days after expiry: beyond that, the watch is purged and must be recreated. Finally, a list holding a dirigeant:Name target is renewed with an account API key, the target being reserved to identified accounts: without it, the answer is a 401 with no quote.

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

GET/v1/surveillance/{jeton}/renouveler

Price
$0.05 (30 days) · $0.135 (90 days) · $0.50 (365 days) / entity
Free quota
No
Family
Alerts and monitoring
Parameters
ParameterWhereExample
jetonpath · requiredyour own
ciblesquery · required552032534,542065479
dureequery · optional30

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)

What the route returns

Catalogue description, exactly as agents read it:

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

Expected identifier

The token returned when the watch was created, in the path.

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.

Neighbouring routes

  • /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, 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/{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.

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) Create an account: 150 free calls a month up to EUR 2 of value

Read next

OpenAPI · llms.txt · Full route catalogue and pricing