Votre premier appel
L'adresse de base est https://siren.jsonpage.com. Une clé API est nécessaire pour les routes de consultation. Les exemples ci-dessous utilisent des identifiants fictifs.
Avec cURL
curl "https://siren.jsonpage.com/v1/companies/123456789" \
-H "X-API-Key: $SIREN_API_KEY"Avec JavaScript côté serveur
const response = await fetch(
"https://siren.jsonpage.com/v1/companies/123456789",
{ headers: { "X-API-Key": process.env.SIREN_API_KEY } }
);
if (!response.ok) throw new Error(`Siren API: ${response.status}`);
const company = await response.json();Remplacez l'identifiant fictif par un SIREN réel dans votre application.
Deux recherches exactes
/v1/companies/{siren}Retourne l'entreprise identifiée par un SIREN de 9 chiffres.
/v1/establishments/{siret}Retourne l'établissement identifié par un SIRET de 14 chiffres.
/v1/metadataRetourne la date du stock et les informations de chargement.
Les routes /health/live et /health/ready servent à la supervision et ne nécessitent pas de clé API.
Des champs faciles à exploiter
Réponse illustrative pour une entreprise. Les champs absents dans la source sont renvoyés à null.
{
"siren": "123456789",
"diffusion_status": "O",
"name": "Entreprise Exemple",
"created_at": "2020-01-01",
"administrative_status": "A",
"activity_code": "62.01Z",
"legal_category": "5710",
"last_processed_at": "2026-09-01T10:00:00"
}Données fictives. Le statut de diffusion P entraîne le masquage des noms et adresses protégés.
Gérer les réponses
| Code | Signification | Action recommandée |
|---|---|---|
200 | Fiche trouvée | Utiliser la réponse JSON. |
400 | Identifiant invalide | Vérifier le format SIREN ou SIRET. |
401 | Clé absente ou invalide | Vérifier l'en-tête X-API-Key. |
404 | Aucune fiche | Vérifier l'identifiant. |
429 | Débit du forfait dépassé | Attendre le délai Retry-After. |
500 | Données indisponibles | Réessayer plus tard. |
503 | Service temporairement occupé | Réessayer avec temporisation. |
{ "error": "rate_limit_exceeded" }Débits : Gratuit 100/min, Standard 1 000/min, Pro sans plafond de forfait. Il n'y a pas de quota mensuel. Des protections globales restent actives pour préserver la disponibilité.
Une intégration fiable
- Validez que vos SIREN ont 9 chiffres et vos SIRET 14 chiffres avant l'appel.
- Conservez la clé API côté serveur et prévoyez sa rotation.
- Sur
429ou503, réessayez après une attente progressive. - Consultez
/v1/metadatapour connaître la date du stock servi. - Respectez le statut de diffusion partielle
Pet les conditions de réutilisation des données Insee.
Voir aussi la page SLA pour l'objectif de disponibilité proposé.
Source des données
Data source
Les données proviennent de la base Sirene publiée par l'Insee. Leur réutilisation relève de la Licence Ouverte 2.0 d'Etalab. Source : Insee, base Sirene. La date de mise à jour du stock servi figure dans /v1/metadata.
The data comes from the Sirene database published by Insee. Reuse is governed by the Etalab Open Licence 2.0. Source: Insee, Sirene database. The date of the served stock is available at /v1/metadata.