API to renew a company watchlist

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
Parameter	Where	Example
`jeton`	path · required	your own
`cibles`	query · required	`552032534,542065479`
`duree`	query · optional	`30`

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)

curlx402MCP

# {jeton}: the token returned by GET /v1/surveillance/creer when your watch was created (sw_…). It is an access key: no publishable example exists, replace {jeton} with your own.
curl "https://api.sirenic.eu/v1/surveillance/{jeton}/renouveler?cibles=552032534,542065479&duree=30" \
  -H "X-Api-Key: $SIRENIC_KEY"

# {jeton}: the token returned by GET /v1/surveillance/creer when your watch was created (sw_…). It is an access key: no publishable example exists, replace {jeton} with your own.
# 1. The quote, without paying anything: the route answers 402 with its amount
curl -i "https://api.sirenic.eu/v1/surveillance/{jeton}/renouveler?cibles=552032534,542065479&duree=30"

# 2. The paid call: the x402 client settles the quote and replays the request
npx x402-fetch "https://api.sirenic.eu/v1/surveillance/{jeton}/renouveler?cibles=552032534,542065479&duree=30"

# Or over MCP, in Claude Code / Cursor / an agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

200 OK · extract

{
 "surveillance_id": "sw_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "jeton": "sw_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "duree_jours": 30,
 "expire_le": "2026-09-27T07:36:32.134Z"
}

Dated snapshot from 2026-07-29, truncated to one item per array. It is not live data. The full extract is served free of charge from the samples surface, and the schema from the OpenAPI document.

Full real response ↗

What the route returns

Catalogue description, exactly as agents read it:

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.

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, 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/{jeton}/renouveler`	$0.05 (30 days) · $0.135 (90 days) · $0.50 (365 days) / entity	free sample	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.

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 notified about euro packs

Renew a watchlist