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

## What the route returns

Catalogue description, exactly as agents read it:

**Company monitoring for France: a 30, 90 or 365-day surveillance watchlist (?duree=), recurring KYB & compliance alerts. Each target checked DAILY against official sources; Ed25519-signed webhook and/or e-mail digest, always pollable. Company targets (SIREN): BODACC, status, officers, sanctions/AMF blacklist, PSAN/SGP, Seveso, new FR & EU procurement awards. Director targets (dirigeant:Name): new/ended offices. Per target (1-100) x duration: $0.05 / $0.135 / $0.50. No account, no refund.**

## Expected identifier

`cibles` parameter: 1 to 100 company numbers, or targets of the form `dirigeant:Name`. Plus `duree=30|90|365`.

> ⚠️ A wrongly formatted identifier 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.

## Extract from a genuinely paid response

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](https://api.sirenic.eu/exemples/), and the schema from the OpenAPI document.

```
{
 "surveillance_id": "sw_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.<horodatage_base64url>.<signature_ed25519_base64url>",
 "jeton": "sw_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.<horodatage_base64url>.<signature_ed25519_base64url>",
 "cibles": 2,
 "duree_jours": 30,
 "expire_le": "2026-08-28T07:36:32.134Z",
 "canaux": {
  "webhook": false,
  "email": false,
  "pull": "/v1/surveillance/sw_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
 },
 "source": "Surveillance Sirenic — diffs quotidiens sur sources officielles (Sirene, BODACC, sanctions, AMF, Géorisques, DECP, TED)",
 "disclaimer": "Vérification QUOTIDIENNE : un événement est signalé au plus tard le jour ouvré suivant sa publication par la source. Les correspondances (sanctions, listes AMF) sont des rapprochements de noms à vérifier — jamais une décision. Cible dirigeant : uniquement le suivi des MANDATS publics (nom + année), purgé à l'expiration."
}
```

## Price and billing

Price: **$0.05 (30 j) · $0.135 (90 j) · $0.50 (365 j) / entité**. 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 j), $0.135 (90 j), $0.50 (365 j). 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.

## Calling the route

```
# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i https://api.sirenic.eu/v1/surveillance/creer

# 2. L'appel réglé — le client x402 paie le devis et rejoue la requête
npx x402-fetch https://api.sirenic.eu/v1/surveillance/creer

# 3. Ou en MCP, dans Claude Code / Cursor / un agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## 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 j) · $0.135 (90 j) · $0.50 (365 j) / entité
- `/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](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs) 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](https://api.sirenic.eu/openapi.json) and in [llms.txt](https://api.sirenic.eu/llms.txt).

**One call, end to end**

```
# Client x402 (npm) — le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## Routes used and pricing

| Route | Price | What it returns |
| --- | --- | --- |
| `/v1/surveillance/creer` | $0.05 (30 j) · $0.135 (90 j) · $0.50 (365 j) / entité | Company monitoring for France: a 30, 90 or 365-day surveillance watchlist (?duree=), recurring KYB & compliance alerts. Each target checked DAILY against official sources; Ed25519-signed webhook and/or e-mail digest, always pollable. Company targets (SIREN): BODACC, status, officers, sanctions/AMF blacklist, PSAN/SGP, Seveso, new FR & EU procurement awards. Director targets (dirigeant:Name): new/ended offices. Per target (1-100) x duration: $0.05 / $0.135 / $0.50. No account, no refund. |

## Take it further

- [See a real response (free)](https://api.sirenic.eu/exemples/surveillance-creer.json)
- [Get the quote for /v1/surveillance/creer](https://api.sirenic.eu/v1/surveillance/creer)
- [Get notified about euro packs](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs)

## Read next

- [Monitoring a portfolio of customers or suppliers](https://api.sirenic.eu/en/use-cases/monitor-customer-portfolio-daily-alerts-signed-webhook)

---

Volume figures on this page were measured in our database on 2026-08-19. They are dated snapshots, not live counters.

Full catalogue : https://api.sirenic.eu/