GET/v1/kyb/batch
- Price
- $0.105 / entity
- Free quota
- No
- Family
- KYB and reports
| Parameter | Where | Example |
|---|---|---|
sirens | query · required | 552032534,542065479 |
vue | query · optional | no example |
What is charged
200Ed25519-signed response, charged at the route's price402Signed x402 quote, nothing is debited4xxUnknown or invalid identifier, never charged5xxUpstream source unavailable, or a counted total below the list read (compte_incoherent), never charged
What the route returns
Catalogue description, exactly as agents read it:
Batch KYB and bulk company lookup for 2 to 100 French companies in one call (sirens): full KYB files with commercial-court decisions (Judilibre) and per-block provenance, for due diligence and compliance; or vue=synthese, one line per SIREN for a supplier list. $0.105 per company (30% off the $0.15 unit price), quoted per SIREN; an unknown SIREN (trouve=false) is billed as one lookup. Fully disclosed legal persons only: a sole proprietor or restricted unit refuses the batch (400, not charged).
Expected identifier
sirens parameter: 2 to 100 company numbers, comma-separated. With vue=synthese, one compact line per number at the same price, for a long supplier list; without it, each full file. A sole proprietorship, restricted-diffusion or no-legal-personality SIREN refuses the whole batch (400, never charged), sirens_refuses naming them.
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.105 / 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 sirens parameter accepts 2 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.
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/kyb/{siren}: $0.15/v1/comparer: $0.12 / entity/v1/prospection: $0.02
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
| Route | Price | Sample | What it returns |
|---|---|---|---|
/v1/kyb/batch | $0.105 / entity | free sample | Batch KYB and bulk company lookup for 2 to 100 French companies in one call (sirens): full KYB files with commercial-court decisions (Judilibre) and per-block provenance, for due diligence and compliance; or vue=synthese, one line per SIREN for a supplier list. $0.105 per company (30% off the $0.15 unit price), quoted per SIREN; an unknown SIREN (trouve=false) is billed as one lookup. Fully disclosed legal persons only: a sole proprietor or restricted unit refuses the batch (400, not charged). |
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/kyb/batch Create an account: 150 free calls a month up to EUR 2 of value