API Sirene - Documentation des services

retour au sommaire

---

Résultat des requêtes multicritères

Format Json

Les réponses sont par défaut en JSON et renvoient les Siren (resp les Siret) répondant à la requête avec la totalité des périodes pour les variables historisées. Le header est complété par le nombre total de résultats de la requête (total), le rang de début et le nombre de résultats effectivement retournés (20 par défaut) et, si le paramètre curseur est utilisé, le curseur et le curseur suivant. Pour l'utilisation des paramètres nombre et debut, consulter la pagination des résultats ; pour curseur, consulter la page dédiée

Exemple

Recherche de tous les établissement dont le siren commence par 3 : https://api.insee.fr/api-sirene/3.11/siret?q=siren:3*&champs=siret,denominationUniteLegale&curseur=*

Header :

X-Frame-Options: SAMEORIGIN
Cache-Control: no-cache
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: POST,GET
Content-Encoding: gzip
Vary: Accept-Encoding
Expires: Thu, 01 Jan 1970 00:00:00 GMT
X-Total-Count: 8738318
Access-Control-Allow-Headers: authorization,Access-Control-Allow-Origin,Content-Type,SOAPAction
Link: ; rel="first", ; rel="next"
Content-Type: application/json;charset=utf-8
Date: Tue, 08 Mar 2022 10:03:34 GMT
Transfer-Encoding: chunked
Connection: keep-alive
Strict-Transport-Security: max-age=100000; includeSubDomains

Complément :

{
    "header": {
        "statut": 200,
        "message": "OK",
        "total": 8738318,
        "debut": 0,
        "nombre": 20,
        "curseur": "*",
        "curseurSuivant": "AoEuMzAwMDAwMzUzMDAwMTU="

Vient ensuite la liste des unités légales (resp. des établissements), chacun étant structuré comme le résultat des requêtes unitaires siren ou siret.

Format csv

Le retour peut être fourni au format CSV par négociation du contenu via le paramètre Accept de l’en-tête http : accept:text/csv.
Le retour contient alors la valeur des variables non historisées et uniquement la valeur courante des variables historisées.

Exemple

Recherche de tous les établissements dont le siren commence par 3 : https://api.insee.fr/api-sirene/3.11/siret?q=siren:3*&champs=siret,denominationUniteLegale

Header :

X-Frame-Options: SAMEORIGIN
Cache-Control: no-cache
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: POST,GET
Content-Encoding: gzip
Vary: Accept-Encoding
Expires: Thu, 01 Jan 1970 00:00:00 GMT
X-Total-Count: 8738318
Access-Control-Allow-Headers: authorization,Access-Control-Allow-Origin,Content-Type,SOAPAction
Link: ; rel="first", ; rel="next"
Content-Type: text/csv;charset=utf-8
Date: Tue, 08 Mar 2022 10:43:05 GMT
Transfer-Encoding: chunked
Connection: keep-alive
Strict-Transport-Security: max-age=100000; includeSubDomains

Sortie :

siret,denominationUniteLegale
30000001500010,
30000002300014,
30000004900019,
30000007200029,
30000008000014,
30000009800032,
30000009800040,
...

Commentaires

Les curseurs ne sont pas disponibles en csv. Les formats de sortie sont identiques sur la console. Pour en savoir plus

---