Logo de l'API Sirene

API Sirene - Documentation des services

Logo de l'Insee
retour au sommaire

Interrogation unitaire du siren : résultat

Le résultat est fourni au format Json.
Le retour est structuré en 2 parties :

• le header (à ne pas confondre avec l'en-tête http ni l'en-tête de réponse) qui contient le code retour et le message d'erreur ;
• l'unité légale, qui comprend :
◦ Toutes les variables courantes
◦ La liste de toutes les périodes et, pour chaque période :
▪ La liste des variables historisées.
Les résultats des valeurs non historisées (période courante) sont envoyés avant le tableau periodes.
Le tableau periodes entre […] comprend un nombre de périodes (variable nombrePeriodesUniteLegale) entre {…} par ordre chronologique décroissant :
• une période est définie par une date de début et une date de fin ;
• les valeurs des variables historisées sont celles observées dans la période ;
• une variable non connue sur une période sera à null ;
• la dernière période de l'historique dans l'ordre chronologique correspond à la période courante et a une date de fin à null ;
• un changement de valeur pour une variable historisée implique la création d'une période ;
• des indicatrices de changement (true ou false) sont attachées à chaque variable historisée et indiquent si la variable correspondante a été modifiée par rapport à la période précédente ;
• pour la première période de l'historique de l'entreprise dans l'ordre chronologique toutes les indicatrices sont à false ;
• pour une entreprise dont les variables historisées n'ont jamais été modifiées, la réponse ne comportera qu'une seule période.

Interrogation unitaire du siren : en-tête de la réponse

L’en-tête de la réponse comprend : • Access-Control-Allow-Origin: *
• Cache-Control: private
• Connection: Keep-Alive
• Content-Encoding: gzip
• Content-Length: xxx
• Content-Type: application/json;charset=utf-8
• Date: xxx
• Expires: Thu, 01 Jan 1970 01:00:00 GMT
• Location:https://xxxxxxx (si code 301)
• Keep-Alive: timeout=5, max=100
• Server: unknown
• Vary: Accept-Encoding
• X-Frame-Options: SAMEORIGIN