GET/v1/eu/entreprise/CH/{id}
- Prix
- 0,01 €
- Quota gratuit
- Inclus
- Famille
- Europe · recherche et fiches
| Paramètre | Où | Exemple |
|---|---|---|
id | chemin · obligatoire | CHE-107.480.920 |
Ce qui est facturé
200Réponse signée Ed25519, débitée au prix de la route402Devis x402 signé, rien n'est débité4xxIdentifiant inconnu ou invalide, jamais facturé5xxSource amont indisponible, ou total compté sous la liste lue (compte_incoherent), jamais facturé
Voir une réponse réelle (gratuit) Obtenir le devis de /v1/eu/entreprise/CH/{id}
Ce que la route rend
Description publiée au catalogue, traduite ici en français (les agents la lisent en anglais, comme toutes nos surfaces de découverte) :
Consultation du registre officiel des entreprises suisses (Zefix, index central des raisons de commerce / registre central du commerce), qui couvre les sociétés inscrites en Suisse. Requête : /v1/eu/entreprise/CH/CHE-107.480.920 (numéro IDE CHE, avec ou sans points). Renvoie la dénomination légale, la forme juridique, le statut normalisé, le siège et le lien vers le registre cantonal, en direct depuis Zefix. Entreprises individuelles exclues : en Suisse, une entreprise individuelle (Einzelunternehmen), dont la raison de commerce porte le nom du titulaire, rend 404 sans facturation ; une succursale n'est servie que si son siège l'est (personne morale ou société de personnes) ; une forme juridique qui ne tranche pas est omise. Le même schéma JSON unifié que toutes les fiches d'entreprises européennes de Sirenic.
Identifiant attendu
Identifiant CHE, au format CHE-123.456.789 ou en chiffres continus.
Un identifiant au mauvais format dans le chemin rend 400 et n'est pas facturé, mais il vous fait perdre un aller-retour. C'est la première cause d'appel raté sur les routes étrangères. Un paramètre de recherche, lui, est nettoyé : les caractères non pris en charge sont retirés et la requête utile est servie.
Prix et facturation
Tarif : 0,01 €, débité en crédits (1 crédit = 1 €) ; en x402, le même montant se règle en USDC ou en EURC. Le montant qui fait foi est celui du devis 402 renvoyé par la route elle-même, pas ce texte, qui est dérivé de la même grille mais reste une page.
Une réponse d'erreur annule le paiement : un 400, un 404 ou un 503 n'est jamais facturé. Une panne d'une source amont ferme la route en 503 plutôt que de servir une réponse dégradée.
Ce que cette route ne fait pas
Interrogation en direct chez le registre, la réponse gardée en cache jusqu'à 24 h : elle peut donc avoir été lue la veille. Elle dépend de la disponibilité du registre : une panne rend 503 et l'appel n'est pas facturé, jamais une réponse dégradée. Entreprises individuelles exclues : en Suisse, une entreprise individuelle (Einzelunternehmen), dont la raison de commerce porte le nom du titulaire, rend 404 sans facturation ; une succursale n'est servie que si son siège l'est (elle est écartée de la recherche) ; une forme juridique qui ne tranche pas est omise.
Routes voisines
/v1/eu/entreprise/{pays}/{id}: 0,01 €/v1/eu/recherche: 0,003 €
Comment on paie
Chaque route se paie à l'appel, de deux façons, sans abonnement : en x402, en USDC ou EURC sur le réseau Base, sans compte ni clé d'API ; ou avec la clé d'API d'un compte, qui ouvre le quota gratuit. En x402, le premier appel renvoie un devis 402 que votre client règle, puis rejoue l'appel. Un appel en erreur n'est jamais facturé.
Ouvert aujourd'hui : 150 appels gratuits par mois avec un compte, dans la limite de 2 € de valeur, sur 122 routes sur 129 (la grille dit lesquelles), plus 100 lignes gratuites par mois sur l'identité en lot, et le paiement à l'appel en x402 (USDC ou EURC), sans compte sauf les actes du registre. Crédits prépayés : leur recharge par carte n'est pas encore ouverte.
Les réponses payantes sont signées Ed25519 : vous pouvez prouver plus tard ce qui vous a été servi, et à quelle date. Le catalogue entier est lisible gratuitement dans l'OpenAPI et le llms.txt.
Un appel, de bout en bout
# 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
# Ou en serveur local (stdio), avec votre clé ou un portefeuille x402
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp
Routes utilisées et prix
| Route | Prix | Exemple | Ce qu'elle rend |
|---|---|---|---|
/v1/eu/entreprise/CH/{id} | 0,01 € | exemple gratuit | Consultation du registre officiel des entreprises suisses (Zefix, index central des raisons de commerce / registre central du commerce), qui couvre les sociétés inscrites en Suisse. Requête : /v1/eu/entreprise/CH/CHE-107.480.920 (numéro IDE CHE, avec ou sans points). Renvoie la dénomination légale, la forme juridique, le statut normalisé, le siège et le lien vers le registre cantonal, en direct depuis Zefix. Entreprises individuelles exclues : en Suisse, une entreprise individuelle (Einzelunternehmen), dont la raison de commerce porte le nom du titulaire, rend 404 sans facturation ; une succursale n'est servie que si son siège l'est (personne morale ou société de personnes) ; une forme juridique qui ne tranche pas est omise. Le même schéma JSON unifié que toutes les fiches d'entreprises européennes de Sirenic. |
Passer à l'action
La première étape est gratuite et vous montre exactement ce que vous achèteriez, sans compte ni clé ; un compte, avec sa clé d'API, ouvre ensuite le quota gratuit.
Voir une réponse réelle (gratuit) Obtenir le devis de /v1/eu/entreprise/CH/{id} Créer un compte : 150 appels gratuits par mois dans la limite de 2 € de valeur