10 octobre 2025

Utiliser l'API de l'INSEE pour tester un SIRET

L'INSEE met à disposition une API pour consulter les propriétés des SIRET enregistrés. Il est nécessaire de créer un compte pour invoquer ses services en HTTP. Suivez leur guide : Insee_API_publique_modalites_connexion.pdf

Vous obtenez une clé (en bas à droite) que vous allez utiliser dans vos transactions.


Vous pouvez tester sur : https://www.data.gouv.fr/dataservices/api-sirene-open-data/ 

A noter : l'API indique une limitation à 30 transactions par minute pour les usages open data

Dans la section Swagger 

  1. Cliquez sur Authorize et indiquez votre clé.
  2. Choisissez par exemple GET /siret/{siret}, cliquez sur "Try it out", 
  3. Indiquez un SIRET, 
  4. Pour n'avoir que la période courante précisez une date à 2999-12-31
  5. Cliquez sur "Execute".

L'interface vous indique la syntaxe "curl" utilisable par exemple dans un script :

curl -X 'GET' \
  'https://api.insee.fr/api-sirene/3.11/siret/12345678901234?date=2999-12-31' \
  -H 'accept: application/json' \
  -H 'X-INSEE-Api-Key-Integration: 49d299ed-macle-apixx-amoix-ede4826b2b8c'

Et le résultat (code retour HTTP et réponse au format JSON, gérable avec la commande jq si vous en disposez) :

{
  "header": {
    "statut": 200,
    "message": "ok"
  },
  "etablissement": {
    "siren": "123456789",
    "nic": "01234",
    "siret": "12345678901234",
    "statutDiffusionEtablissement": "O",
    "dateCreationEtablissement": "2018-08-01",
    "trancheEffectifsEtablissement": "32", 
...

    En plus des données courantes, l'API Sirene donne accès aux variables historisées suivantes :

  • La dénomination ;
  • Le Nic du siège ;
  • Le caractère employeur ;
  • Dans la section "periodesEtablissement" l'occurrence en vigueur a sa "dateFin à null". 
    • On y trouvera son statut dans etatAdministratifEtablissement (A Actif, F Fermé).

Si le SIRET n'est pas attribué c'est un code retour HTTP 404, si vous n'êtes pas authentifié HTTP 401

{
  "header": {
    "statut": 404,
    "message": "Aucun élément trouvé pour le siret 12345678901234"
  }
}
{"message":"Unauthorized","http_status_code":401 
.

Aucun commentaire:

Enregistrer un commentaire