Le json de retour est composé de deux clés:

  • entreprise contenant les informations de l’entreprise;

  • gateway_error indiquant si l’un des fournisseurs de données n’a pas correctement fourni les informations.

La liste exhaustive des clés pour entreprise est fournie dans l’exemple ci-dessous.

Quelques précisions sur les valeurs retournées:

  • Les diverses dates (ie date_debut, date_creation et date_fin sont fournis dans un format timestamp UNIX) ;

  • Le champ procedure_collective est à ignorer. Il sera suprimmé à terme. Pour le moment il renvoie toujours false.

  • Le champ dirigeant peut être ignoré car il est toujours à true. INFOGREFFE devrait mettre a disposition un nouveau service fournissant la liste des dirigeants

  • Le champ code_effectif_entreprise correspond au référentiel de l’INSEE : Nomenclature INSEE

  • Le champ numero_tva_intracommunautaire correspond au numéro de TVA intracommunautaire également appelé numéro d’identification fiscale (NIF)

  • Le champ procedure_collective est un boolean qui indique si l’entreprise a une procédure collective en cours : si c’est false, l’entreprise est active, si c’est true, l’entreprise est soit en redressement, en liquidation soit en procédure de sauvegarde

  • Les champs forme_juridique et forme_juridique_code sont issus de la nomenclature de l’INSEE que vous pouvez trouver là : Nomenclature INSEE

  • le champ date_radiation est null si l’entreprise n’est pas radié du registre du commerce. Si l’entreprise est radiée, la date est fournie au format timestamp

Le champ etat_administratif est l’état juridique de l’entreprise (source INSEE) : Cette variable est une donnée de l’entreprise. Elle qualifie l’entreprise à un moment donné. Une entreprise au répertoire SIRENE : - peut être juridiquement active tant que sa personnalité morale existe, c’est à dire tant qu’elle n’a pas déclaré sa cessation. - peut être juridiquement cessée.

L’entreprise est considérée juridiquement active : - lorsqu’elle a été inscrite sans activité à sa demande (création au répertoire mais sans avoir encore démarré une activité : activité principale “0000Z”). - si elle n’a plus d’établissement en activité (cessation économique : EtatEco = 3). - suite au décès de l’exploitant ou à une dissolution.

Valeurs : Active, Cessée

Source : http://www.sirene.fr/static-resources/doc/sirenage_interpretation.pdf?version=2.6.2

En cas de succès, le code de retour est 200.

Mandataires sociaux

Il y a deux types de mandataires sociaux :

Personnes physiques

Le champ type vaut "PP"

Les champs complétés sont :

  • nom
  • prenom
  • fonction
  • dirigeant
  • date_naissance
  • date_naissance_timestamp
  • type

Les autres champs sont vides.

Personnes morales

Le champ type vaut "PM"

Les champs complétés sont :

  • fonction
  • dirigeant
  • raison_sociale
  • identifiant (élément facultatif qui peut être vide ou un nombre de 7, 8 ou 9 chiffres)
  • type

Les autres champs sont vides.

Errors

Code Description
401 Non authorisé : le jeton est manquant ou invalide
404 L'entreprise n'a pas été trouvée

Metadata

:champs:
  :entreprise:
    :siren:
      :source: apientreprise
      :length: 9
    :nom_commercial:
      :source: INFOGREFFE
      :length: ''
    :capital_social:
      :source: INFOGREFFE
      :length: ''
    :numero_tva_intracommunautaire:
      :source: apientreprise
      :length: 13
    :forme_juridique:
      :source: INSEE
      :length: ''
    :forme_juridique_code:
      :source: INSEE
      :length: ''
    :nombre_etablissements_actifs:
      :source: INSEE
      :length: ''
    :nom:
      :source: INSEE
      :length: ''
    :prenom:
      :source: INSEE
      :length: ''
    :etat_administratif:
      :value:
        :source: INSEE
        :length: 10
      :date_mise_a_jour:
        :source: INSEE
        :length: ''
    :procedure_collective:
      :source: INSEE
      :length: ''
    :raison_sociale:
      :source: INSEE
      :length: ''
    :siret_siege_social:
      :source: INSEE
      :length: 14
    :code_effectif_entreprise:
      :source: INSEE
      :length: ''
    :date_creation:
      :source: INSEE
      :length: ''
    :date_radiation:
      :source: INFOGREFFE
      :length: ''
    :mandataires_sociaux:
      :nom:
        :source: INFOGREFFE
        :length: ''
      :prenom:
        :source: INFOGREFFE
        :length: ''
      :fonction:
        :source: INFOGREFFE
        :length: ''
      :dirigeant:
        :source: INFOGREFFE
        :length: ''
      :date_naissance:
        :source: INFOGREFFE
        :length: ''
      :date_naissance_timestamp:
        :source: INFOGREFFE
        :length: ''
      :raison_sociale:
        :source: INFOGREFFE
        :length: ''
      :identifiant:
        :source: INFOGREFFE
        :length: ''
      :type:
        :source: INFOGREFFE
        :length: ''
  :gateway_error:
    :source: apientreprise
    :length: 10

Examples

GET /api/v1/entreprises/418166096?token=OraehahG8Uunahligh3thaez
200
{
  "entreprise": {
    "siren": "418166096",
    "capital_social": 509525,
    "numero_tva_intracommunautaire": "FR16418166096",
    "forme_juridique": "SA à directoire (s.a.i.)",
    "forme_juridique_code": "5699",
    "nombre_etablissements_actifs": 1,
    "nom_commercial": "OCTO-TECHNOLOGY",
    "procedure_collective": false,
    "raison_sociale": "OCTO-TECHNOLOGY",
    "siret_siege_social": "41816609600069",
    "code_effectif_entreprise": "22",
    "date_creation": 891381600,
    "nom": null,
    "prenom": null,
    "etat_administratif": {
      "value": "Actif",
      "date_mise_a_jour": 891381600
    },
    "date_radiation": null,
    "mandataires_sociaux": [
      {
        "nom": "HISQUIN",
        "prenom": "FRANCOIS",
        "fonction": "PRESIDENT DU DIRECTOIRE",
        "date_naissance": "1965-01-27",
        "date_naissance_timestamp": -155523600,
        "dirigeant": true,
        "raison_sociale": "",
        "identifiant": "",
        "type": "PP"
      },
      {
        "nom": "NIBOUREL",
        "prenom": "CHRISTIAN",
        "fonction": "PRESIDENT DU CONSEIL DE SURVEILLANCE",
        "date_naissance": "1958-01-09",
        "date_naissance_timestamp": -378003600,
        "dirigeant": true,
        "raison_sociale": "",
        "identifiant": "",
        "type": "PP"
      },
      {
        "nom": "DEGONSE",
        "prenom": "GERARD",
        "fonction": "VICE-PRESIDENT",
        "date_naissance": "1947-07-03",
        "date_naissance_timestamp": -710038800,
        "dirigeant": true,
        "raison_sociale": "",
        "identifiant": "",
        "type": "PP"
      },
      {
        "nom": "CINQUIN",
        "prenom": "LUDOVIC",
        "fonction": "MEMBRE DU DIRECTOIRE",
        "date_naissance": "1972-01-25",
        "date_naissance_timestamp": 65142000,
        "dirigeant": true,
        "raison_sociale": "",
        "identifiant": "",
        "type": "PP"
      },
      {
        "nom": "DEGONSE",
        "prenom": "GERARD",
        "fonction": "MEMBRE DU CONSEIL DE SURVEILLANCE",
        "date_naissance": "1947-07-03",
        "date_naissance_timestamp": -710038800,
        "dirigeant": true,
        "raison_sociale": "",
        "identifiant": "",
        "type": "PP"
      },
      {
        "nom": "BEN MAHMOUD",
        "prenom": "SIHEM",
        "fonction": "MEMBRE DU CONSEIL DE SURVEILLANCE",
        "date_naissance": "1967-03-13",
        "date_naissance_timestamp": -88563600,
        "dirigeant": true,
        "raison_sociale": "",
        "identifiant": "",
        "type": "PP"
      },
      {
        "nom": "BOKOBZA",
        "prenom": "JEAN-PIERRE",
        "fonction": "MEMBRE DU CONSEIL DE SURVEILLANCE",
        "date_naissance": "1961-04-24",
        "date_naissance_timestamp": -274237200,
        "dirigeant": true,
        "raison_sociale": "",
        "identifiant": "",
        "type": "PP"
      },
      {
        "nom": "CAMPBELL",
        "prenom": "ALLAN",
        "fonction": "MEMBRE DU CONSEIL DE SURVEILLANCE",
        "date_naissance": "1961-03-31",
        "date_naissance_timestamp": -276310800,
        "dirigeant": true,
        "raison_sociale": "",
        "identifiant": "",
        "type": "PP"
      },
      {
        "nom": "PLANTIN",
        "prenom": "JEAN-FRANCOIS",
        "fonction": "COMMISSAIRE AUX COMPTES TITULAIRE",
        "date_naissance": "1959-01-27",
        "date_naissance_timestamp": -344912400,
        "dirigeant": true,
        "raison_sociale": "",
        "identifiant": "",
        "type": "PP"
      },
      {
        "nom": "",
        "prenom": "",
        "fonction": "COMMISSAIRE AUX COMPTES TITULAIRE",
        "date_naissance": "",
        "date_naissance_timestamp": 0,
        "dirigeant": true,
        "raison_sociale": "MAZARS - SOCIETE ANONYME",
        "identifiant": "784824153",
        "type": "PM"
      },
      {
        "nom": "",
        "prenom": "",
        "fonction": "COMMISSAIRE AUX COMPTES SUPPLEANT",
        "date_naissance": "",
        "date_naissance_timestamp": 0,
        "dirigeant": true,
        "raison_sociale": "BCRH & ASSOCIES - SOCIETE A RESPONSABILITE LIMITEE",
        "identifiant": "490092574",
        "type": "PM"
      },
      {
        "nom": "SIMON",
        "prenom": "JEAN-LOUIS",
        "fonction": "COMMISSAIRE AUX COMPTES SUPPLEANT",
        "date_naissance": "1959-02-17",
        "date_naissance_timestamp": -343098000,
        "dirigeant": true,
        "raison_sociale": "",
        "identifiant": "",
        "type": "PP"
      }
    ]
  },
  "gateway_error": false
}

Params

Param name Description
siren
required

Le numéro de siren de l’entreprise. Ce paramètre est à passer dans l’url.

Validations:

  • Must be a String