# Briefing on a French company for an AI A short text, written by code, to paste into an AI: the instruction to stick to the data read, each block's status, and the source line to copy. JSON is requested with Accept: application/json. ## What the route returns Catalogue description, exactly as agents read it: **LLM-ready briefing on a French company by SIREN, Markdown by default (JSON with Accept: application/json), in French or English (langue=fr|en): identity without officers, filed accounts over three years with their reliability, BODACC insolvency notices, commercial-court decisions and public contracts counted and dated, each block with its status, age and coverage, and a source line to quote. Written by code from official registers, no model text. Legal entities only.** ## Expected identifier 9-digit SIREN of a fully disclosed legal entity; a sole proprietorship or a restricted-diffusion entity answers 400, never charged. Query `langue`: fr or en. > ⚠️ 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. ## Reconstructed example, not a paid response Dated snapshot from 2026-10-08, reconstructed example, not a paid response (composed by hand or read from the code), 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/entreprise-siren-briefing.json), and the schema from the OpenAPI document. ``` # DANONE (SIREN 552032534) : briefing Sirenic Consigne pour l'IA : les données ci-dessous ont été lues aux registres officiels français par Sirenic le 2026-10-08. Réponds à partir d'elles seules. Chaque bloc dit son état (servi, partiel, absence non conclusive, à vérifier) : rapporte cet état, ne comble pas un manque de mémoire. Cite la source mot pour mot en fin de réponse : Sirenic (INSEE Sirene, Egapro, GLEIF, INPI ratios, BODACC; 2026-09-15/2026-10-08) https://api.sirenic.eu/?utm_source=briefing ``` ## Price and billing Price: **$0.05**. 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. 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. The quote, without paying anything: the route answers 402 with its amount curl -i "https://api.sirenic.eu/v1/entreprise/552032534/briefing" # 2. The paid call: the x402 client settles the quote and replays the request npx x402-fetch "https://api.sirenic.eu/v1/entreprise/552032534/briefing" # 3. Or over MCP, in Claude Code / Cursor / an agent 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 ``` ## What this route does not do No natural person, no verdict and no score: those remain sold through `/v1/intelligence/{siren}` and `/v1/score/defaillance/{siren}`. ## Neighbouring routes - `/v1/entreprise/{siren}`: $0.005 - `/v1/entreprise/{siren}/finances`: $0.01 - `/v1/entreprise/{siren}/dossier`: $0.005 ## 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. Open today: 150 free calls a month with an account, on 106 of 122 routes (the price list says which), 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](https://api.sirenic.eu/openapi.json) and in [llms.txt](https://api.sirenic.eu/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 | Route | Price | Sample | What it returns | | --- | --- | --- | --- | | `/v1/entreprise/{siren}/briefing` | $0.05 | [free sample](https://api.sirenic.eu/exemples/entreprise-siren-briefing.json) | LLM-ready briefing on a French company by SIREN, Markdown by default (JSON with Accept: application/json), in French or English (langue=fr\|en): identity without officers, filed accounts over three years with their reliability, BODACC insolvency notices, commercial-court decisions and public contracts counted and dated, each block with its status, age and coverage, and a source line to quote. Written by code from official registers, no model text. Legal entities only. | ## Take it further - [See the reconstructed example (free)](https://api.sirenic.eu/exemples/entreprise-siren-briefing.json) - [Get the quote for /v1/entreprise/{siren}/briefing](https://api.sirenic.eu/v1/entreprise/552032534/briefing) - [Create an account: 150 free calls a month](https://api.sirenic.eu/compte?lang=en&utm_source=recherche&utm_campaign=referencement) ## Read next - [Briefing your AI on a French company](https://api.sirenic.eu/en/use-cases/brief-your-ai-on-french-company) --- [Home](https://api.sirenic.eu/en) · [Pricing](https://api.sirenic.eu/en/offres) · [Guides](https://api.sirenic.eu/en/articles) · [Routes](https://api.sirenic.eu/en/api) · [About](https://api.sirenic.eu/en/about) · [Legal notice](https://api.sirenic.eu/mentions-legales) · [Privacy](https://api.sirenic.eu/en/privacy)