API Documentation

API PRO

Introduction

Bienvenue sur l’API PRO Societe.com. Accédez et récupérez les données de la base d’entreprises françaises la plus complète du marché, à la demande et en temps réel.

Vous avez accès avec notre API Pro aux informations légales, juridiques et financières de 12 millions de sociétés, ainsi que tous leurs mandataires sociaux, bénéficiaires effectifs et dirigeants.

Nos données sont exhaustives, fiables et mises à jour quotidiennement depuis les répertoires SIRENE, INPI et BODACC et de multiples sources privées.

L’API Pro de Societe.com vous permet de récupérer des informations et documents d’une entreprise française à partir de leur n° SIREN (n° RCS) , n° SIRET ou n° de TVA.

Pour toute questions, n’hésitez pas à contacter notre support technique sur : api@pro.societe.com

Versions de l’API

Pour connaitre la version la plus récente et pour connaitre les évolutions apportées par chaque nouvelle version majeure ou mineure, rendez-vous ici :

https://api.societe.com/versions

L’URL type pour la version API : https://api.societe.com/api/v{X}

où X représente le numéro de la version (version majeure uniquement).

Exemple : https://api.societe.com/api/v1 => interrogera la version 1 de l’API

En cas de changement de cette version majeure, l’ancienne version restera accessible durant 3 mois à date de la mise en production de la nouvelle version majeure. Vous serez averti à chaque changement de version. Un changement de version majeure est un évènement rare car il vient modifier un usage existant de l’API et donc écessite un changement -ou a minima une vérification- coté client.

Exemple : suppression d’un champ existant, changement d’url d’une route,…

Ensuite, ils existent des changements de version plus fréquents, qui ne modifient pas le fonctionnement existant de l’API, ce sont des versions mineures. Ces versions mineures sont automatiquement mis en production et vous bénéficier tout le temps de la version mineure la plus à jour.

Exemple : ajout d’un nouveau champ, ajout d’une nouvelle route,…

Authentification

Pour accéder au service API PRO vous devez obtenir une clé d’API, aussi appelé Token. Pour cela il vous faut créer un compte Societe.com (https://paiement.societe.com/compte-login). Une fois enregistré, récupérez ou générez vos clés dans votre dashboard personnel.

Vous pouvez également être accompagné pour qu’on se charge de tout en contactant notre service API PRO : api@pro.societe.com

Dans chaque requête, vous devez indiquer votre clé d’API (token). Deux méthodes sont disponibles pour spécifier votre token d’identification :

  • Passer par le paramètre token dans la requête token={token}

    • curl 'https://api.societe.com/api/v1/entreprise/search?nom=societe&token={token}'
  • Passer par le header d’authentification X-Authorization: socapi {token}

    • curl 'https://api.societe.com/api/v1/entreprise/search?nom=societe' -H 'X-Authorization: socapi {token}'

Pas encore de token d’identification ? Contactez le service API PRO: api@pro.societe.com

Format

Les réponses peuvent être générées sous 2 formats :

  • XML

  • JSON

Par défaut le retour se fera en JSON, ajouter le paramètre contenttype=xml à la requête, pour avoir un retour en XML :

  • curl 'https://api.societe.com/api/v1/entreprise/search?nom=societe&token={token}&contenttype=xml'

Charset

Deux charsets possible :

  • UTF-8

  • ISO-8859-1

Par défaut le charset sera UTF-8, ajouter le paramètre charset=iso-8859-1 à la requête pour avoir un retour en ISO-8859-1

Limitations

Limitations de l’API :

  • Les requêtes à l’API PRO se font avec la méthode GET du protocole HTTP.

  • Vous ne pouvez accéder à l’API PRO que depuis les IPs autorisées dans votre compte ou déclarées en contactant notre service client api@pro.societe.com.

  • Les appels à l’API PRO sont limités par défaut à 60 requetes / minutes. Pour bénéficier d’une limitation plus haute vous pouvez opter pour l’option Highrate dans votre compte ou contactez notre service client api@pro.societe.com

Succès de la requête

En cas de succès de la requête, la réponse est retournée avec un code HTTP 200. En cas d’erreur, le code HTTP est différent, un message est transmis pour donner plus d’information.

Crédits

Chaque requête réussie consomme un ou plusieurs crédits. Chaque requête en erreur ne consomme aucun crédit, sauf les requêtes en erreur ayant des paramètres valides.

Le service suivant indique votre solde de crédits :

HTTP Request

GET https://api.societe.com/api/v1/infoclient

Societe

Existence

GET https://api.societe.com/api/v1/entreprise/493467849/exist
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
{
  "common": {
    "siren": "493467849",
    "siretsiege": "49346784900011",
    "numtva": "FR35493467849",
    "deno": "IGF INDUSTRIES - ARBEL FAUVET RAIL",
    "pcollencours": false,
    "status": "active",
    "immatinsee": "enregistre",
    "immatrcs": "radiee",
    "immatbodacc": true
  }
}
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
<?xml version="1.0" encoding="UTF-8"?>
<common>
    <siren>493467849</siren>
    <siretsiege>49346784900011</siretsiege>
    <numtva>FR35493467849</numtva>
    <deno>IGF INDUSTRIES - ARBEL FAUVET RAIL</deno>
    <pcollencours>false</pcollencours>
    <status>active</status>
    <immatinsee>enregistre</immatinsee>
    <immatrcs>radiee</immatrcs>
    <immatbodacc>true</immatbodacc>
</common>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Existence
GET/entreprise/{numid}/exist

Retourne les informations d’existence de l’entreprise.
Le paramètre {numid} permet de passer un numéro d’identification unique de l’entreprise dont on souhaite récupérer les informations. Ce numéro d’identification peut être :

  • un numéro SIREN (exemple 493467849)

  • un numéro SIRET (exemple : 42872326600048)

  • un numéro de TVA intracomm. (exemple FR56428723266)

Liste des champs des résultats (code HTTP 200) :

  • siren : Numéro SIREN de l’entreprise. Numéro d’enregistrement de l’entreprise au registre du Commerce et des Sociétés (RCS)

  • siretsiege : Numéro SIRET de l’entreprise. Numéro d’enregistrement de l’établissement siège de l’entreprise au répertoire Sirene de l’INSEE.

  • numtva : Numéro de TVA intracommunautaire de l’entreprise. Numéro d’identification unique délivré par l’administration fiscale du pays de domiciliation.

  • deno : Dénomination de l’entreprise. C’est la raison sociale de la société.

  • pcollencours : Procédure collective en cours.

  • status : Statut de l’entreprise pour Societe.com.

  • immatinsee : Immatriculation au répertoire Sirene de l’INSEE.

  • immatrcs : Immatriculation au Registre du Commerce et des Sociétés RCS.

  • immatbodacc : Enregistrement dans le BODACC. Si ce champ est à true c’est qu’il existe au moins un enregistrement dans le registre des annonces BODACC

URI Parameters
HideShow
numid
string (required) Example: 493467849

un numéro SIREN, un numéro SIRET ou un numéro de TVA intracomm.


Informations Légales

GET https://api.societe.com/api/v1/entreprise/493467849/infoslegales
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
{
  "infolegales": {
    "siren": "493467849",
    "sirenformat": "493 467 849",
    "urlfiche": "https://www.societe.com/societe/igf-industries-arbel-fauvet-rail-493467849.html",
    "siretsiege": "49346784900011",
    "siretsiegeformat": "493 467 849 00011",
    "nicsiege": "00011",
    "numtva": "FR35493467849",
    "dernieremaj": "20220501",
    "datecreainsee": "20070201",
    "dateferminsee": "",
    "denoinsee": "IGF INDUSTRIES - ARBEL FAUVET RAIL",
    "nomcommercialinsee": "",
    "enseigneinsee": "",
    "sigleinsee": "",
    "codecatjurlev1insee": "5",
    "codecatjurlev2insee": "56",
    "codecatjurlev3insee": "5699",
    "catjurlibinsee": "SA à directoire",
    "catcodeinsee": "",
    "catlibinsee": "",
    "nomadressageinsee": "",
    "cpltnomadressageinsee": "",
    "cpltadressageinsee": "",
    "voieadressageinsee": "28 AV DE MESSINE",
    "dispadressageinsee": "",
    "codepostalinsee": "75008",
    "villeinsee": "PARIS",
    "paysinsee": "France",
    "trancheeffinsee": "NN",
    "aprminsee": "",
    "nafcodelev1insee": "3",
    "nafcodelev2insee": "30",
    "nafcodelev3insee": "302",
    "nafcodelev4insee": "3020",
    "nafinsee": "3020Z",
    "naflibinsee": "Construction de locomotives et d'autre matériel ferroviaire roulant",
    "datecrearcs": "20061228",
    "datefermrcs": "",
    "rcs": "Paris B 493467849",
    "codegreffe": "7501",
    "numdossiergreffe": "2006B24949",
    "nomgreffe": "PARIS",
    "denorcs": "IGF INDUSTRIES - ARBEL FAUVET RAIL",
    "nomcommercialrcs": "",
    "enseignercs": "",
    "siglercs": "",
    "typecap": "FIXE",
    "capital": "33458640,00",
    "codedevise": "300",
    "libdevise": "EURO",
    "codecatjurlev1rcs": "5",
    "codecatjurlev2rcs": "55",
    "codecatjurlev3rcs": "5599",
    "catjurlibrcs": "SA à conseil d'administration",
    "nomadressagercs": "",
    "cpltnomadressagercs": "",
    "cpltadressagercs": "",
    "voieadressagercs": "28 AVENUE DE MESSINE",
    "dispadressagercs": "",
    "codepostalrcs": "75008",
    "villercs": "PARIS",
    "paysrcs": "France",
    "nafcodelev1rcs": "3",
    "nafcodelev2rcs": "30",
    "nafcodelev3rcs": "302",
    "nafcodelev4rcs": "3020",
    "nafrcs": "3020Z",
    "naflibrcs": "Construction de locomotives et d'autre matériel ferroviaire roulant"
  }
}
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
<?xml version="1.0" encoding="UTF-8"?>
<infolegales>
    <siren>493467849</siren>
    <sirenformat>493 467 849</sirenformat>
    <urlfiche>https://www.societe.com/societe/igf-industries-arbel-fauvet-rail-493467849.html</urlfiche>
    <siretsiege>49346784900011</siretsiege>
    <siretsiegeformat>493 467 849 00011</siretsiegeformat>
    <nicsiege>00011</nicsiege>
    <numtva>FR35493467849</numtva>
    <dernieremaj>20220501</dernieremaj>
    <datecreainsee>20070201</datecreainsee>
    <dateferminsee></dateferminsee>
    <denoinsee>IGF INDUSTRIES - ARBEL FAUVET RAIL</denoinsee>
    <nomcommercialinsee></nomcommercialinsee>
    <enseigneinsee></enseigneinsee>
    <sigleinsee></sigleinsee>
    <codecatjurlev1insee>5</codecatjurlev1insee>
    <codecatjurlev2insee>56</codecatjurlev2insee>
    <codecatjurlev3insee>5699</codecatjurlev3insee>
    <catjurlibinsee>SA à directoire</catjurlibinsee>
    <catcodeinsee></catcodeinsee>
    <catlibinsee></catlibinsee>
    <nomadressageinsee></nomadressageinsee>
    <cpltnomadressageinsee></cpltnomadressageinsee>
    <cpltadressageinsee></cpltadressageinsee>
    <voieadressageinsee>28 AV DE MESSINE</voieadressageinsee>
    <dispadressageinsee></dispadressageinsee>
    <codepostalinsee>75008</codepostalinsee>
    <villeinsee>PARIS</villeinsee>
    <paysinsee>France</paysinsee>
    <trancheeffinsee>NN</trancheeffinsee>
    <aprminsee></aprminsee>
    <nafcodelev1insee>3</nafcodelev1insee>
    <nafcodelev2insee>30</nafcodelev2insee>
    <nafcodelev3insee>302</nafcodelev3insee>
    <nafcodelev4insee>3020</nafcodelev4insee>
    <nafinsee>3020Z</nafinsee>
    <naflibinsee>Construction de locomotives et d'autre matériel ferroviaire roulant</naflibinsee>
    <datecrearcs>20061228</datecrearcs>
    <datefermrcs></datefermrcs>
    <rcs>Paris B 493467849</rcs>
    <codegreffe>7501</codegreffe>
    <numdossiergreffe>2006B24949</numdossiergreffe>
    <nomgreffe>PARIS</nomgreffe>
    <denorcs>IGF INDUSTRIES - ARBEL FAUVET RAIL</denorcs>
    <nomcommercialrcs></nomcommercialrcs>
    <enseignercs></enseignercs>
    <siglercs></siglercs>
    <typecap>FIXE</typecap>
    <capital>33458640,00</capital>
    <codedevise>300</codedevise>
    <libdevise>EURO</libdevise>
    <codecatjurlev1rcs>5</codecatjurlev1rcs>
    <codecatjurlev2rcs>55</codecatjurlev2rcs>
    <codecatjurlev3rcs>5599</codecatjurlev3rcs>
    <catjurlibrcs>SA à conseil d'administration</catjurlibrcs>
    <nomadressagercs></nomadressagercs>
    <cpltnomadressagercs></cpltnomadressagercs>
    <cpltadressagercs></cpltadressagercs>
    <voieadressagercs>28 AVENUE DE MESSINE</voieadressagercs>
    <dispadressagercs></dispadressagercs>
    <codepostalrcs>75008</codepostalrcs>
    <villercs>PARIS</villercs>
    <paysrcs>France</paysrcs>
    <nafcodelev1rcs>3</nafcodelev1rcs>
    <nafcodelev2rcs>30</nafcodelev2rcs>
    <nafcodelev3rcs>302</nafcodelev3rcs>
    <nafcodelev4rcs>3020</nafcodelev4rcs>
    <nafrcs>3020Z</nafrcs>
    <naflibrcs>Construction de locomotives et d'autre matériel ferroviaire roulant</naflibrcs>
</infolegales>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Informations Légales
GET/entreprise/{numid}/infoslegales

Retourne les informations légales de l’entreprise.
Le paramètre {numid} permet de passer un numéro d’identification unique de l’entreprise dont on souhaite récupérer les informations. Ce numéro d’identification peut être :

  • un numéro SIREN (exemple 493467849)

  • un numéro SIRET (exemple : 42872326600048)

  • un numéro de TVA intracomm. (exemple FR56428723266)

Liste des champs des résultats (code HTTP 200) :

  • siren : Numéro SIREN de l’entreprise. Numéro d’enregistrement de l’entreprise au registre du Commerce et des Sociétés (RCS)

  • sirenformat : Numéro SIREN formaté de l’entreprise. Le numéro SIREN est souvent formaté avec des espaces tous les 3 caractères.

  • urlfiche : Lien vers la page de l’entreprise sur Societe.com

  • siretsiege : Numéro SIRET de l’entreprise. Numéro d’enregistrement de l’établissement siège de l’entreprise au répertoire Sirene de l’INSEE ou au RCS dans certains cas.

  • siretsiegeformat : Numéro SIRET formaté de l’entreprise. Formaté avec des espace tous les 3 caractères sur les 9 premiers chiffres correspondant au SIREN puis les 5 dernier chiffres du NIC.

  • nicsiege : Numéro NIC de l’établissement siège de l’entreprise. C’est le numéro d’identification d’un l’établissement de l’entreprise, ici le siège.

  • numtva : Numéro de TVA intracommunautaire de l’entreprise. Numéro d’identification unique délivré par l’administration fiscale du pays de domiciliation.

  • dernieremaj : Date de dernière mise à jour sur l’entreprise. Elle correspond au dernier changement survenu à l’INSEE, au RCS ou au BODACC sur ce SIREN. Format : AAAAMMJJ

  • datecreainsee : Date de création à l’INSEE. La date a laquelle l’entreprise a été enregistrée dans le répertoire Sirene de l’INSEE. Format : AAAAMMJJ

  • dateferminsee : Date de fermeture à l’INSEE. La date a laquelle l’entreprise a été fermée dans le répertoire Sirene de l’INSEE. Format : AAAAMMJJ

  • denoinsee : Dénomination de l’entreprise déclarée à l’INSEE. C’est la raison sociale de la société déclarée au répertoire Sirene de l’INSEE.

  • nomcommercialinsee : Nom commercial déclaré INSEE. C’est une précision de la raison sociale qui peut servir de dénomination secondaire pour l’entreprise (facultatif)

  • enseigneinsee : Enseigne déclaré INSEE. C’est un complément de la dénomination pour l’entreprise (facultatif)

  • sigleinsee : Sigle déclaré INSEE. C’est un complément de la dénomination pour l’entreprise (facultatif)

  • codecatjurlev1insee : Code de la forme juridique code Niv.1 déclarée à l’INSEE. Cf tableau des form ci-dessous.

  • codecatjurlev2insee : Code de la forme juridique code Niv.2 déclarée à l’INSEE. Cf tableau des form ci-dessous.

  • codecatjurlev3insee : Code de la forme juridique code Niv.3 déclarée à l’INSEE. Cf tableau des form ci-dessous.

  • catjurlibinsee : Nom de la forme juridique déclarée à l’INSEE.

  • catcodeinsee : Code de la catégorie INSEE. https://www.insee.fr/fr/metadonnees/definition/c1057

  • catlibinsee : Nom de la catégorie INSEE

  • nomadressageinsee : Nom d’adressage déclaré à l’INSEE

  • cpltnomadressageinsee : Complément du nom d’adressage déclaré à l’INSEE

  • cpltadressageinsee : Complément du nom d’adressage déclaré à l’INSEE

  • voieadressageinsee : Nom de la voie d’adressage déclaré à l’INSEE

  • dispadressageinsee : Information de dispatch d’adressage déclaré à l’INSEE

  • codepostalinsee : Code postal déclaré à l’INSEE

  • villeinsee : Ville déclarée à l’INSEE

  • paysinsee : Pays déclaré à l’INSEE

  • trancheeffinsee : Tranche d’effectif moyen déclaré à l’INSEE. Cette donnée correspond à l’effectif de l’année N-1.

  • aprminsee : Code d’activité ARPM déclaré pour l’établissement. Ce code décrit la catégorie précise de l’activité principale au répertoire des métiers

  • nafcodelev1insee : Code d’activité NAF / APE de niveau 1 déclaré à l’INSEE. Ce code décrit le secteur d’activité (parmi 21 sections) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • nafcodelev2insee : Code d’activité NAF / APE de niveau 2 déclaré à l’INSEE. Ce code décrit la branche d’activité (parmi 88 divisions) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • nafcodelev3insee : Code d’activité NAF / APE de niveau 3 déclaré à l’INSEE. Ce code décrit le groupe d’activité (parmi 272 groupes) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • nafcodelev4insee : Code d’activité NAF / APE de niveau 4 déclaré à l’INSEE. Ce code décrit la catégorie d’activité (parmi 615 classes) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • nafinsee : Code d’activité NAF / APE déclaré à l’INSEE. Ce code décrit la catégorie précise (parmi 732 sous-classes) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • naflibinsee : Libellé de l’activité NAF / APE déclaré à l’INSEE.

  • datecrearcs : Date immatriculation de l’entreprise au RCS. La date a laquelle l’entreprise a été immatriculée au registre du commerce et des sociétés. Format : AAAAMMJJ (sauf dans certains cas rares où ce sera AAAAMM)

  • datefermrcs : Date de radiation de l’entreprise au RCS. La date a laquelle l’entreprise a été radiée du registre du commerce et des sociétés. Format : AAAAMMJJ (sauf dans certains cas rares où ce sera AAAAMM)

  • rcs : Mention RCS de l’entreprise. Cet identifiant est composé du nom de la ville d’immatriculation, d’une lettre (A pour commerçant, B pour société) et du numéro SIREN.

  • codegreffe : Code du greffe de référence.

  • numdossiergreffe : Numéro de dossier au greffe

  • nomgreffe : Nom du greffe du tribunal de commerce.

  • denorcs : Dénomination de l’entreprise déclarée au RCS. C’est la raison sociale de la société déclarée au registre du commerce et des sociétés.

  • nomcommercialrcs : Nom commercial déclaré RCS. C’est une précision de la raison sociale qui peut servir de dénomination secondaire pour l’entreprise (facultatif)

  • enseignercs : Enseigne déclaré RCS. C’est un complément de la dénomination pour l’entreprise (facultatif)

  • siglercs : Sigle déclaré RCS. C’est un complément de la dénomination pour l’entreprise (facultatif)

  • typecap : Type de capital social. Le capital social d’une entreprise peut être fixe ou variable

  • capital : Montant du capital social de l’entreprise.

  • codedevise : Code de la devise du capital social de l’entreprise.

  • libdevise : Nom de la devise du capital social de l’entreprise.

  • codecatjurlev1rcs : Code de la forme juridique code Niv.1 déclarée au RCS. Cf tableau des form ci-dessous.

  • codecatjurlev2rcs : Code de la forme juridique code Niv.2 déclarée au RCS. Cf tableau des form ci-dessous.

  • codecatjurlev3rcs : Code de la forme juridique code Niv.3 déclarée au RCS. Cf tableau des form ci-dessous.

  • catjurlibrcs : Nom de la forme juridique déclarée au RCS

  • nomadressagercs : Nom d’adressage déclaré au RCS

  • cpltnomadressagercs : Complément du nom d’adressage déclaré au RCS

  • cpltadressagercs : Complément du nom d’adressage déclaré au RCS

  • voieadressagercs : Nom de la voie d’adressage déclaré au RCS

  • dispadressagercs : Information de dispatch d’adressage déclaré au RCS

  • codepostalrcs : Code postal déclaré au RCS

  • villercs : Ville déclarée au RCS

  • paysrcs : Pays déclaré au RCS

  • nafcodelev1rcs : Code d’activité NAF / APE de niveau 1 déclaré au RCS. Ce code décrit le secteur d’activité (parmi 21 sections) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • nafcodelev2rcs : Code d’activité NAF / APE de niveau 2 déclaré au RCS. Ce code décrit la branche d’activité (parmi 88 divisions) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • nafcodelev3rcs : Code d’activité NAF / APE de niveau 3 déclaré au RCS. Ce code décrit le groupe d’activité (parmi 272 groupes) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • nafcodelev4rcs : Code d’activité NAF / APE de niveau 4 déclaré au RCS. Ce code décrit la catégorie d’activité (parmi 615 classes) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • nafrcs : Code d’activité NAF / APE déclaré au RCS. Ce code décrit la catégorie précise (parmi 732 sous-classes) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • naflibrcs : Libellé de l’activité NAF / APE déclaré au RCS.

  • effmoyrcs : Effectif moyen déclaré au RCS. Cette donnée est extraite des bilans déposés au greffe et correspond donc à la date de dépot

URI Parameters
HideShow
numid
string (required) Example: 493467849

un numéro SIREN, un numéro SIRET ou un numéro de TVA intracomm.


Dirigeants

GET https://api.societe.com/api/v1/entreprise/493467849/dirigeants
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
{
  "data": {
    "nbdirigeants": 4,
    "dirigeants": [
      {
        "type": "PP",
        "datedebut": "20100612",
        "datefin": "20111029",
        "titre": "Vice-président",
        "denopm": "",
        "sirenpm": "",
        "civpp": "MME",
        "nompp": "LAURENT",
        "prenompp": "Cecile",
        "datenaisspp": "19580119",
        "agepp": 64,
        "nationalitepp": "",
        "codenationalitepp": "",
        "villenaissancepp": "",
        "paysnaissancepp": "",
        "codepaysnaissancepp": "",
        "adresseligne1pp": "",
        "adresseligne2pp": "",
        "adresseligne3pp": "",
        "cpadressepp": "",
        "villeadressepp": "",
        "paysadressepp": "",
        "codepaysadressepp": "",
        "url": "https://dirigeant.societe.com/dirigeant/Cecile.LAURENT.96264220.html",
        "lien_dir_pm": "",
        "lien_dir_pp": "https://dirigeant.societe.com/dirigeant/Cecile.LAURENT.96264220.html",
        "id_dir_pm": "",
        "id_dir_pp": "Cecile.LAURENT.96264220"
      },
      {
        "type": "PP",
        "datedebut": "20100612",
        "datefin": "",
        "titre": "Président du directoire",
        "denopm": "",
        "sirenpm": "",
        "civpp": "M",
        "nompp": "LAURENT",
        "prenompp": "Maxime",
        "datenaisspp": "19481028",
        "agepp": 73,
        "nationalitepp": "",
        "codenationalitepp": "",
        "villenaissancepp": "",
        "paysnaissancepp": "",
        "codepaysnaissancepp": "",
        "adresseligne1pp": "",
        "adresseligne2pp": "",
        "adresseligne3pp": "",
        "cpadressepp": "",
        "villeadressepp": "",
        "paysadressepp": "",
        "codepaysadressepp": "",
        "url": "https://dirigeant.societe.com/dirigeant/Maxime.LAURENT.14264082.html",
        "lien_dir_pm": "",
        "lien_dir_pp": "https://dirigeant.societe.com/dirigeant/Maxime.LAURENT.14264082.html",
        "id_dir_pm": "",
        "id_dir_pp": "Maxime.LAURENT.14264082"
      },
      {
        "type": "PP",
        "datedebut": "20070403",
        "datefin": "20081223",
        "titre": "Président du directoire",
        "denopm": "",
        "sirenpm": "",
        "civpp": "M",
        "nompp": "ROQUES",
        "prenompp": "Bernard",
        "datenaisspp": "19471115",
        "agepp": 74,
        "nationalitepp": "",
        "codenationalitepp": "",
        "villenaissancepp": "",
        "paysnaissancepp": "",
        "codepaysnaissancepp": "",
        "adresseligne1pp": "",
        "adresseligne2pp": "",
        "adresseligne3pp": "",
        "cpadressepp": "",
        "villeadressepp": "",
        "paysadressepp": "",
        "codepaysadressepp": "",
        "url": "https://dirigeant.societe.com/dirigeant/Bernard.ROQUES.12697222.html",
        "lien_dir_pm": "",
        "lien_dir_pp": "https://dirigeant.societe.com/dirigeant/Bernard.ROQUES.12697222.html",
        "id_dir_pm": "",
        "id_dir_pp": "Bernard.ROQUES.12697222"
      },
      {
        "type": "PP",
        "datedebut": "20100612",
        "datefin": "",
        "titre": "Président du conseil de surveillance",
        "denopm": "",
        "sirenpm": "",
        "civpp": "M",
        "nompp": "HAU",
        "prenompp": "Emmanuel",
        "datenaisspp": "19391125",
        "agepp": 82,
        "nationalitepp": "",
        "codenationalitepp": "",
        "villenaissancepp": "",
        "paysnaissancepp": "",
        "codepaysnaissancepp": "",
        "adresseligne1pp": "",
        "adresseligne2pp": "",
        "adresseligne3pp": "",
        "cpadressepp": "",
        "villeadressepp": "",
        "paysadressepp": "",
        "codepaysadressepp": "",
        "url": "https://dirigeant.societe.com/dirigeant/Emmanuel.HAU.66228392.html",
        "lien_dir_pm": "",
        "lien_dir_pp": "https://dirigeant.societe.com/dirigeant/Emmanuel.HAU.66228392.html",
        "id_dir_pm": "",
        "id_dir_pp": "Emmanuel.HAU.66228392"
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
<?xml version="1.0" encoding="UTF-8"?>
<data>
    <nbdirigeants>4</nbdirigeants>
    <dirigeants>
        <dirigeant>
            <type>PP</type>
            <datedebut>20100612</datedebut>
            <datefin>20111029</datefin>
            <titre>Vice-président</titre>
            <denopm></denopm>
            <sirenpm></sirenpm>
            <civpp>MME</civpp>
            <nompp>LAURENT</nompp>
            <prenompp>Cecile</prenompp>
            <datenaisspp>19580119</datenaisspp>
            <agepp>64</agepp>
            <nationalitepp></nationalitepp>
            <codenationalitepp></codenationalitepp>
            <villenaissancepp></villenaissancepp>
            <paysnaissancepp></paysnaissancepp>
            <codepaysnaissancepp></codepaysnaissancepp>
            <adresseligne1pp></adresseligne1pp>
            <adresseligne2pp></adresseligne2pp>
            <adresseligne3pp></adresseligne3pp>
            <cpadressepp></cpadressepp>
            <villeadressepp></villeadressepp>
            <paysadressepp></paysadressepp>
            <codepaysadressepp></codepaysadressepp>
            <url>https://dirigeant.societe.com/dirigeant/Cecile.LAURENT.96264220.html</url>
            <lien_dir_pm></lien_dir_pm>
            <lien_dir_pp>https://dirigeant.societe.com/dirigeant/Cecile.LAURENT.96264220.html</lien_dir_pp>
            <id_dir_pm></id_dir_pm>
            <id_dir_pp>Cecile.LAURENT.96264220</id_dir_pp>
        </dirigeant>
        <dirigeant>
            <type>PP</type>
            <datedebut>20100612</datedebut>
            <datefin></datefin>
            <titre>Président du directoire</titre>
            <denopm></denopm>
            <sirenpm></sirenpm>
            <civpp>M</civpp>
            <nompp>LAURENT</nompp>
            <prenompp>Maxime</prenompp>
            <datenaisspp>19481028</datenaisspp>
            <agepp>73</agepp>
            <nationalitepp></nationalitepp>
            <codenationalitepp></codenationalitepp>
            <villenaissancepp></villenaissancepp>
            <paysnaissancepp></paysnaissancepp>
            <codepaysnaissancepp></codepaysnaissancepp>
            <adresseligne1pp></adresseligne1pp>
            <adresseligne2pp></adresseligne2pp>
            <adresseligne3pp></adresseligne3pp>
            <cpadressepp></cpadressepp>
            <villeadressepp></villeadressepp>
            <paysadressepp></paysadressepp>
            <codepaysadressepp></codepaysadressepp>
            <url>https://dirigeant.societe.com/dirigeant/Maxime.LAURENT.14264082.html</url>
            <lien_dir_pm></lien_dir_pm>
            <lien_dir_pp>https://dirigeant.societe.com/dirigeant/Maxime.LAURENT.14264082.html</lien_dir_pp>
            <id_dir_pm></id_dir_pm>
            <id_dir_pp>Maxime.LAURENT.14264082</id_dir_pp>
        </dirigeant>
        <dirigeant>
            <type>PP</type>
            <datedebut>20070403</datedebut>
            <datefin>20081223</datefin>
            <titre>Président du directoire</titre>
            <denopm></denopm>
            <sirenpm></sirenpm>
            <civpp>M</civpp>
            <nompp>ROQUES</nompp>
            <prenompp>Bernard</prenompp>
            <datenaisspp>19471115</datenaisspp>
            <agepp>74</agepp>
            <nationalitepp></nationalitepp>
            <codenationalitepp></codenationalitepp>
            <villenaissancepp></villenaissancepp>
            <paysnaissancepp></paysnaissancepp>
            <codepaysnaissancepp></codepaysnaissancepp>
            <adresseligne1pp></adresseligne1pp>
            <adresseligne2pp></adresseligne2pp>
            <adresseligne3pp></adresseligne3pp>
            <cpadressepp></cpadressepp>
            <villeadressepp></villeadressepp>
            <paysadressepp></paysadressepp>
            <codepaysadressepp></codepaysadressepp>
            <url>https://dirigeant.societe.com/dirigeant/Bernard.ROQUES.12697222.html</url>
            <lien_dir_pm></lien_dir_pm>
            <lien_dir_pp>https://dirigeant.societe.com/dirigeant/Bernard.ROQUES.12697222.html</lien_dir_pp>
            <id_dir_pm></id_dir_pm>
            <id_dir_pp>Bernard.ROQUES.12697222</id_dir_pp>
        </dirigeant>
        <dirigeant>
            <type>PP</type>
            <datedebut>20100612</datedebut>
            <datefin></datefin>
            <titre>Président du conseil de surveillance</titre>
            <denopm></denopm>
            <sirenpm></sirenpm>
            <civpp>M</civpp>
            <nompp>HAU</nompp>
            <prenompp>Emmanuel</prenompp>
            <datenaisspp>19391125</datenaisspp>
            <agepp>82</agepp>
            <nationalitepp></nationalitepp>
            <codenationalitepp></codenationalitepp>
            <villenaissancepp></villenaissancepp>
            <paysnaissancepp></paysnaissancepp>
            <codepaysnaissancepp></codepaysnaissancepp>
            <adresseligne1pp></adresseligne1pp>
            <adresseligne2pp></adresseligne2pp>
            <adresseligne3pp></adresseligne3pp>
            <cpadressepp></cpadressepp>
            <villeadressepp></villeadressepp>
            <paysadressepp></paysadressepp>
            <codepaysadressepp></codepaysadressepp>
            <url>https://dirigeant.societe.com/dirigeant/Emmanuel.HAU.66228392.html</url>
            <lien_dir_pm></lien_dir_pm>
            <lien_dir_pp>https://dirigeant.societe.com/dirigeant/Emmanuel.HAU.66228392.html</lien_dir_pp>
            <id_dir_pm></id_dir_pm>
            <id_dir_pp>Emmanuel.HAU.66228392</id_dir_pp>
        </dirigeant>
    </dirigeants>
</data>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Dirigeants
GET/entreprise/{numid}/dirigeants

Retourne les informations sur les dirigeants de l’entreprise.
Le paramètre {numid} permet de passer un numéro d’identification unique de l’entreprise dont on souhaite récupérer les informations. Ce numéro d’identification peut être :

  • un numéro SIREN (exemple 493467849)

  • un numéro SIRET (exemple : 42872326600048)

  • un numéro de TVA intracomm. (exemple FR56428723266)

Liste des champs des résultats (code HTTP 200) :

  • nbdirigeants : Nombre de dirigeants

  • type: Type de dirigeant. Un dirigeant peut être une personne physique (PP) ou une personne morale (PM)

  • datedebut: Date de début de mandat déclarée au RCS. Format : AAAAMMJJ

  • datefin: Date de fin de mandat déclarée au RCS. Format : AAAAMMJJ

  • titre: Titre de la fonction du mandataire déclaré au RCS.

  • denopm: Dénomination de l’entreprise mandataire. Dans le cas d’une personne morale mandataire.

  • sirenpm: Numéro SIREN de l’entreprise mandataire. Dans le cas d’une personne morale mandataire.

  • civpp: Civilité du mandataire. Dans le cas d’une personne physique mandataire.

  • nompp: Nom du mandataire. Dans le cas d’une personne physique mandataire.

  • prenompp: Prénom du mandataire. Dans le cas d’une personne physique mandataire.

  • datenaisspp: Date de naissance du mandataire. Dans le cas d’une personne physique mandataire. Format : AAAAMMJJ

  • agepp: Age du mandataire. Dans le cas d’une personne physique mandataire.

  • nationalitepp: Nationalité du mandataire. Dans le cas d’une personne physique mandataire.

  • codenationalitepp: Code de la nationalité du mandataire. Dans le cas d’une personne physique mandataire.

  • villenaissancepp: Ville de naissance du mandataire. Dans le cas d’une personne physique mandataire.

  • paysnaissancepp: Pays de naissance du mandataire. Dans le cas d’une personne physique mandataire.

  • codepaysnaissancepp: Code du pays de naissance du mandataire. Dans le cas d’une personne physique mandataire.

  • adresseligne1pp: Ligne 1 de l’adresse du mandataire. Dans le cas d’une personne physique mandataire.

  • adresseligne2pp: Ligne 2 de l’adresse du mandataire. Dans le cas d’une personne physique mandataire.

  • adresseligne3pp: Ligne 3 de l’adresse du mandataire. Dans le cas d’une personne physique mandataire.

  • cpadressepp: Code postal de l’adresse du mandataire. Dans le cas d’une personne physique mandataire.

  • villeadressepp: Ville de l’adresse du mandataire. Dans le cas d’une personne physique mandataire.

  • paysadressepp: Pays de l’adresse du mandataire. Dans le cas d’une personne physique mandataire.

  • codepaysadressepp: Code du pays de l’adresse du mandataire. Dans le cas d’une personne physique mandataire.

  • url: Adresse URL de la fiche du mandataire. Si personne physique sur https://dirigeant.societe.com et si mandataire personne morale sur https://www.societe.com

  • lien_dir_pp: Adresse URL de la fiche du mandataire personne physique sur https://dirigeant.societe.com

  • lien_dir_pm: Adresse URL de la fiche du mandataire personne morale sur https://www.societe.com

  • id_dir_pp: Identifiant du mandataire personne physique

  • id_dir_pm: Identifiant du mandataire personne morale

URI Parameters
HideShow
numid
string (required) Example: 493467849

Siren / Siret / TVA de l’entreprise cherchée


Bilans

GET https://api.societe.com/api/v1/entreprise/493467849/bilans
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
{
  "data": {
    "nbbilans": 1,
    "dernierbildate": "2007",
    "dernierca": 15300000,
    "monnaie": "EU",
    "derniereffmoy": 296,
    "bilans": [
      {
        "anneebilan": "2007",
        "typebilan": "Sociaux",
        "idbilan": "493467849200712311",
        "datebilan": "20071231",
        "dureebilan": 12,
        "devisebilan": "EU",
        "actiftotal": 81500000,
        "actifimmo": 52500000,
        "actifimmoincorp": 44200000,
        "actifimmocorp": 6700000,
        "actifimmofin": 1600000,
        "actifcirc": 26700000,
        "actifcircstock": 16500000,
        "actifcirccreance": 3500000,
        "actifcircdispo": 0,
        "actifreg": 2300000,
        "passiftotal": 81500000,
        "passifcapprop": -11800000,
        "passifprovision": 4000000,
        "passifdette": 89400000,
        "passifdettefin": 18100000,
        "passifdettefour": 24800000,
        "passifdettefisc": 5600000,
        "passifdetteautres": 40900000,
        "passifreg": 0,
        "rescatotal": 15300000,
        "rescaexp": 3500000,
        "resprod": 25400000,
        "resva": -1400000,
        "resebe": -14700000,
        "resrex": -16000000,
        "resrcai": -17700000,
        "resresnet": -18200000,
        "reseff": 296,
        "ratiocaf": -16800000,
        "ratiofdr": -48200000,
        "ratiobfr": -42300000,
        "ratiocreancecli": 29,
        "ratiodettefour": 296,
        "ratiostock": 386,
        "ratiodette1a": 50600000,
        "ratiomargecom": 0,
        "ratioeene": 0,
        "ratiocreditbail": 0,
        "ratiofraisperso": 12800000,
        "rationfraisfin": 1700000,
        "ratio1": -11,
        "ratio2": 16,
        "ratio3": 5,
        "ratio4": -8,
        "ratio5": -137,
        "ratio6": -1129
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
<?xml version="1.0" encoding="UTF-8"?>
<data>
    <nbbilans>1</nbbilans>
    <dernierbildate>2007</dernierbildate>
    <dernierca>15300000</dernierca>
    <monnaie>EU</monnaie>
    <derniereffmoy>296</derniereffmoy>
    <bilans>
        <bilan>
            <anneebilan>2007</anneebilan>
            <typebilan>Sociaux</typebilan>
            <idbilan>493467849200712311</idbilan>
            <datebilan>20071231</datebilan>
            <dureebilan>12</dureebilan>
            <devisebilan>EU</devisebilan>
            <actiftotal>81500000</actiftotal>
            <actifimmo>52500000</actifimmo>
            <actifimmoincorp>44200000</actifimmoincorp>
            <actifimmocorp>6700000</actifimmocorp>
            <actifimmofin>1600000</actifimmofin>
            <actifcirc>26700000</actifcirc>
            <actifcircstock>16500000</actifcircstock>
            <actifcirccreance>3500000</actifcirccreance>
            <actifcircdispo>0</actifcircdispo>
            <actifreg>2300000</actifreg>
            <passiftotal>81500000</passiftotal>
            <passifcapprop>-11800000</passifcapprop>
            <passifprovision>4000000</passifprovision>
            <passifdette>89400000</passifdette>
            <passifdettefin>18100000</passifdettefin>
            <passifdettefour>24800000</passifdettefour>
            <passifdettefisc>5600000</passifdettefisc>
            <passifdetteautres>40900000</passifdetteautres>
            <passifreg>0</passifreg>
            <rescatotal>15300000</rescatotal>
            <rescaexp>3500000</rescaexp>
            <resprod>25400000</resprod>
            <resva>-1400000</resva>
            <resebe>-14700000</resebe>
            <resrex>-16000000</resrex>
            <resrcai>-17700000</resrcai>
            <resresnet>-18200000</resresnet>
            <reseff>296</reseff>
            <ratiocaf>-16800000</ratiocaf>
            <ratiofdr>-48200000</ratiofdr>
            <ratiobfr>-42300000</ratiobfr>
            <ratiocreancecli>29</ratiocreancecli>
            <ratiodettefour>296</ratiodettefour>
            <ratiostock>386</ratiostock>
            <ratiodette1a>50600000</ratiodette1a>
            <ratiomargecom>0</ratiomargecom>
            <ratioeene>0</ratioeene>
            <ratiocreditbail>0</ratiocreditbail>
            <ratiofraisperso>12800000</ratiofraisperso>
            <rationfraisfin>1700000</rationfraisfin>
            <ratio1>-11</ratio1>
            <ratio2>16</ratio2>
            <ratio3>5</ratio3>
            <ratio4>-8</ratio4>
            <ratio5>-137</ratio5>
            <ratio6>-1129</ratio6>
        </bilan>
    </bilans>
</data>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Bilans
GET/entreprise/{numid}/bilans

Retourne toutes les informations financières de l’entreprise.
Le paramètre {numid} permet de passer un numéro d’identification unique de l’entreprise dont on souhaite récupérer les informations. Ce numéro d’identification peut être :

  • un numéro SIREN (exemple 493467849)

  • un numéro SIRET (exemple : 42872326600048)

  • un numéro de TVA intracomm. (exemple FR56428723266)

Liste des champs des résultats (code HTTP 200) :

  • nbbilans: Nombre total de bilans sur cette entreprise

  • dernierbildate: Date du dernier bilan disponible

  • dernierca: Montant du dernier chiffre d’affaires déclaré

  • monnaie: Devise des bilans

  • derniereffmoy: Dernier effectif moyen déclaré par l’entreprise

  • anneebilan: Annee sur laquelle porte le bilan

  • typebilan: Type du bilan

  • idbilan: Numéro d’identification du bilan. Cet id permet de récupérer les informations complètes du bilan

  • datebilan: Date de clôture de l’exercice

  • dureebilan: Durée de l’exercice

  • devisebilan: Devise du bilan

  • actiftotal: Total de l’actif

  • actifimmo: Total des immobilisations

  • actifimmoincorp: Immobilisations incorporelles

  • actifimmocorp: Immobilisations corporelles

  • actifimmofin: Immobilisations financières

  • actifcirc: Total des actifs circulants

  • actifcircstock: Stocks et en-cours

  • actifcirccreance: Créances

  • actifcircdispo: Disponibilités - Trésorerie

  • actifreg: Compte de régulation actif

  • passiftotal: Total du passif

  • passifcapprop: Capitaux propres

  • passifprovision: Provisions

  • passifdette: Total des dettes

  • passifdettefin: Dettes financières et emprunts

  • passifdettefour: Dettes fournisseurs

  • passifdettefisc: Dettes fiscales et sociales

  • passifdetteautres: Autres dettes

  • passifreg: Compte de régulation passif

  • rescatotal: Total du chiffre d’affaires (CA)

  • rescaexp: Chiffre d’affaires réalisé à l’export

  • resprod: Production

  • resva: Valeur ajoutée

  • resebe: Excédent brut d’exploitation (EBE)

  • resrex: Résultat d’exploitation (REX)

  • resrcai: Résultat courant avant impôts (RCAI)

  • resresnet: Résultat net. Bénéfice ou pertes

  • reseff: Effectif moyen déclaré au compte de résultat

  • ratiocaf: Ratios - CAF

  • ratiofdr: Ratios - Fonds de roulement

  • ratiobfr: Ratios - Besoin en fond de roulement

  • ratiorcreancecli: Ratio créances clients

  • ratiodettefour: Ratio dettes fournisseurs

  • ratiostock: Ratio stocks

  • ratiodette1an: Dettes à -1 an

  • ratiomargecom: Ratio marge commerciale

  • ratioeene: Ratio EENE

  • ratiocreditbail: Ratio - Crédit bail

  • ratiofraisperso: Ratio - Frais de personnels

  • ratiofraisfin: Ratio - Frais financiers

  • ratio1: Ratio frais financiers / EBE

  • ratio2: Ratio (réal + dispo) dettes à court terme

  • ratio3: Ratio cap permanent / passif

  • ratio4: Ratio VA / CA

  • ratio5: Ratio trésorerie / CA

  • ratio6: Ratio FDR / CA

URI Parameters
HideShow
numid
string (required) Example: 493467849

un numéro SIREN, un numéro SIRET ou un numéro de TVA intracomm.


Etablissements

GET https://api.societe.com/api/v1/entreprise/493467849/etablissements
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
{
  "data": {
    "siretsiege": "49346784900011",
    "nbetablissements": 2,
    "etablissements": [
      {
        "typeetab": "siege",
        "estactive": true,
        "estdiffusable": true,
        "siret": "49346784900011",
        "deno": "",
        "nomadressage": "",
        "cpltnomadressage": "",
        "cpltadr": "",
        "voieadr": "28 AV DE MESSINE",
        "dispadr": "",
        "codepostal": "75008",
        "villebrut": "PARIS 8",
        "ville": "PARIS",
        "pays": "France",
        "depurb": "",
        "tailleurb": "",
        "numurb": "",
        "enseigne": "",
        "nomcommercial": "",
        "naf": "3020Z",
        "naflib": "Construction de locomotives et d'autre matériel ferroviaire roulant",
        "aprm": "",
        "aprmlib": "",
        "trancheeffinsee": "",
        "dateapparition": "20061226",
        "datefermeture": "20101231"
      },
      {
        "typeetab": "secondaire",
        "estactive": true,
        "estdiffusable": true,
        "siret": "49346784900029",
        "deno": "ARBEL FAUVET RAIL",
        "nomadressage": "ARBEL FAUVET RAIL",
        "cpltnomadressage": "",
        "cpltadr": "",
        "voieadr": "140 RUE DU PARADIS",
        "dispadr": "",
        "codepostal": "59500",
        "villebrut": "DOUAI",
        "ville": "DOUAI",
        "pays": "France",
        "depurb": "",
        "tailleurb": "",
        "numurb": "",
        "enseigne": "ARBEL FAUVET RAIL",
        "nomcommercial": "",
        "naf": "3020Z",
        "naflib": "Construction de locomotives et d'autre matériel ferroviaire roulant",
        "aprm": "",
        "aprmlib": "",
        "trancheeffinsee": "Unité non employeuse ou effectif inconnu au 31/12",
        "dateapparition": "20070201",
        "datefermeture": "20121231"
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
<?xml version="1.0" encoding="UTF-8"?>
<data>
    <siretsiege>49346784900011</siretsiege>
    <nbetablissements>2</nbetablissements>
    <etablissements>
        <etablissement>
            <typeetab>siege</typeetab>
            <estactive>true</estactive>
            <estdiffusable>true</estdiffusable>
            <siret>49346784900011</siret>
            <deno></deno>
            <nomadressage></nomadressage>
            <cpltnomadressage></cpltnomadressage>
            <cpltadr></cpltadr>
            <voieadr>28 AV DE MESSINE</voieadr>
            <dispadr></dispadr>
            <codepostal>75008</codepostal>
            <villebrut>PARIS 8</villebrut>
            <ville>PARIS</ville>
            <pays>France</pays>
            <depurb></depurb>
            <tailleurb></tailleurb>
            <numurb></numurb>
            <enseigne></enseigne>
            <nomcommercial></nomcommercial>
            <naf>3020Z</naf>
            <naflib>Construction de locomotives et d'autre matériel ferroviaire roulant</naflib>
            <aprm></aprm>
            <aprmlib></aprmlib>
            <trancheeffinsee></trancheeffinsee>
            <dateapparition>20061226</dateapparition>
            <datefermeture>20101231</datefermeture>
        </etablissement>
        <etablissement>
            <typeetab>secondaire</typeetab>
            <estactive>true</estactive>
            <estdiffusable>true</estdiffusable>
            <siret>49346784900029</siret>
            <deno>ARBEL FAUVET RAIL</deno>
            <nomadressage>ARBEL FAUVET RAIL</nomadressage>
            <cpltnomadressage></cpltnomadressage>
            <cpltadr></cpltadr>
            <voieadr>140 RUE DU PARADIS</voieadr>
            <dispadr></dispadr>
            <codepostal>59500</codepostal>
            <villebrut>DOUAI</villebrut>
            <ville>DOUAI</ville>
            <pays>France</pays>
            <depurb></depurb>
            <tailleurb></tailleurb>
            <numurb></numurb>
            <enseigne>ARBEL FAUVET RAIL</enseigne>
            <nomcommercial></nomcommercial>
            <naf>3020Z</naf>
            <naflib>Construction de locomotives et d'autre matériel ferroviaire roulant</naflib>
            <aprm></aprm>
            <aprmlib></aprmlib>
            <trancheeffinsee>Unité non employeuse ou effectif inconnu au 31/12</trancheeffinsee>
            <dateapparition>20070201</dateapparition>
            <datefermeture>20121231</datefermeture>
        </etablissement>
    </etablissements>
</data>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Etablissements
GET/entreprise/{numid}/etablissements

Retourne les informations sur tous les établissements de l’entreprise.
Le paramètre {numid} permet de passer un numéro d’identification unique de l’entreprise dont on souhaite récupérer les informations. Ce numéro d’identification peut être :

  • un numéro SIREN (exemple 493467849)

  • un numéro SIRET (exemple : 42872326600048)

  • un numéro de TVA intracomm. (exemple FR56428723266)

Liste des champs des résultats (code HTTP 200) :

  • siretsiege : Numéro SIRET de l’entreprise. Numéro d’enregistrement de l’établissement siège de l’entreprise au répertoire Sirene de l’INSEE.

  • nbetablissements : Le nombre total d’établissements rattachés à l’entreprise. Un établissement est une unité de production (fabrication, stockage, administratif,?) géographiquement individualisée.

  • typeetab : Type d’établissement est-il le siège de l’entreprise. Cet établissement peut être le siège social et correspondre à l?adresse administrative de l’entreprise ou bien être un établissement secondaire.

  • estactive : Cet établissement est-il actif ?

  • estdiffusable : Cet établissement est-il diffusable ?

  • siret : Numéro SIRET de l’établissement. Numéro d’enregistrement de l’établissement de l’entreprise au répertoire Sirene de l’INSEE.

  • deno : Dénomination de l’établissement . C’est la raison sociale de la société déclarée. Elle identifie l?entreprise en tant que personne morale

  • nomadressage : Nom d’adressage de l’établissement.

  • cpltnomadressage : Complément du nom d’adressage de l’établissement.

  • cpltadr : Complément de l’adresse de l’établissement.

  • voieadr : Voie de l’adresse de l’établissement.

  • dispadr : Information de dispatch d’adressage de l’établissement

  • codepostal : Code postal de l’établissement.

  • villebrut : Ville de l’établissement. Format brut qui peut contenir des informations d’arrondissement par exemple.

  • pays : Pays de l’établissement.

  • depurb : Departement de l’unité urbaine de l’établissement.

  • tailleurb : Taille de l’unité urbaine de l’établissement.

  • numurb : Numero de l’unité urbaine de l’établissement.

  • enseigne : Enseigne de l’établissement. C’est un complément de la dénomination, c’est le signe visible permettant d’identifier et de localiser géographiquement un établissement (facultatif)

  • nomcommercial : Nom commercial de l’établissement. C’est une précision de la raison sociale qui peut servir de dénomination secondaire pour l’établissement.

  • naf : Code d’activité NAF / APE déclaré pour l’établissement. Ce code décrit la catégorie précise (parmi 732 sous-classes) à laquelle appartient l’établissement. Cf. tableau ci-dessous

  • naflib : Libellé de l’activité NAF / APE déclaré pour l’établissement

  • aprm : Code d’activité ARPM déclaré pour l’établissement. Ce code décrit la catégorie précise de l’activité principale au répertoire des métiers

  • aprmlib : Libellé d’activité APRM déclaré pour l’établissement. Ce libellé décrit la catégorie précise de l’activité principale au répertoire des métiers

  • trancheeffinsee : Tranche d’effectif moyen déclaré à l’INSEE. Cette donnée correspond à l’effectif de l’année N-1.

  • dateapparition : Date d’apparition dans la base INSEE. Format : AAAAMMJJ

  • datefermeture : Date de fermeture à l’INSEE. Format : AAAAMMJJ

URI Parameters
HideShow
numid
string (required) Example: 493467849

un numéro SIREN, un numéro SIRET ou un numéro de TVA intracomm.


Procédures Collectives

GET https://api.societe.com/api/v1/entreprise/493467849/procedurescollectives
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
{
  "data": {
    "nbprocedures": 5,
    "procedures": [
      {
        "dateproc": "20090210",
        "codeproc": "11",
        "typeproc": "Redressement judiciaire",
        "admincode1": "",
        "admintype1": "",
        "adminnom1": "",
        "adminadr1": "",
        "admincp1": "",
        "adminville1": "",
        "admincode2": "",
        "admintype2": "",
        "adminnom2": "",
        "adminadr2": "",
        "admincp2": "",
        "adminville2": ""
      },
      {
        "dateproc": "20091222",
        "codeproc": "12",
        "typeproc": "Plan de continuation / redressement",
        "admincode1": "",
        "admintype1": "",
        "adminnom1": "",
        "adminadr1": "",
        "admincp1": "",
        "adminville1": "",
        "admincode2": "",
        "admintype2": "",
        "adminnom2": "",
        "adminadr2": "",
        "admincp2": "",
        "adminville2": ""
      },
      {
        "dateproc": "20100505",
        "codeproc": "13",
        "typeproc": "Liquidation judiciaire",
        "admincode1": "4100",
        "admintype1": "Liquidateur",
        "adminnom1": "SCP B.T.S.G en la personne de Me Stéphane GORRIAS",
        "adminadr1": "1 PL BOIELDIEU",
        "admincp1": "75002",
        "adminville1": "PARIS",
        "admincode2": "",
        "admintype2": "",
        "adminnom2": "",
        "adminadr2": "",
        "admincp2": "",
        "adminville2": ""
      },
      {
        "dateproc": "20100625",
        "codeproc": "08",
        "typeproc": "Jugement autorisant la poursuite d'activité",
        "admincode1": "",
        "admintype1": "",
        "adminnom1": "",
        "adminadr1": "",
        "admincp1": "",
        "adminville1": "",
        "admincode2": "",
        "admintype2": "",
        "adminnom2": "",
        "adminadr2": "",
        "admincp2": "",
        "adminville2": ""
      },
      {
        "dateproc": "20100707",
        "codeproc": "14",
        "typeproc": "Plan de cession",
        "admincode1": "4100",
        "admintype1": "Liquidateur",
        "adminnom1": "SCP B.T.S.G en la personne de Me Stéphane GORRIAS",
        "adminadr1": "1 PL BOIELDIEU",
        "admincp1": "75002",
        "adminville1": "PARIS",
        "admincode2": "",
        "admintype2": "",
        "adminnom2": "",
        "adminadr2": "",
        "admincp2": "",
        "adminville2": ""
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
<?xml version="1.0" encoding="UTF-8"?>
<data>
    <nbprocedures>5</nbprocedures>
    <procedures>
        <procedure>
            <dateproc>20090210</dateproc>
            <codeproc>11</codeproc>
            <typeproc>Redressement judiciaire</typeproc>
            <admincode1></admincode1>
            <admintype1></admintype1>
            <adminnom1></adminnom1>
            <adminadr1></adminadr1>
            <admincp1></admincp1>
            <adminville1></adminville1>
            <admincode2></admincode2>
            <admintype2></admintype2>
            <adminnom2></adminnom2>
            <adminadr2></adminadr2>
            <admincp2></admincp2>
            <adminville2></adminville2>
        </procedure>
        <procedure>
            <dateproc>20091222</dateproc>
            <codeproc>12</codeproc>
            <typeproc>Plan de continuation / redressement</typeproc>
            <admincode1></admincode1>
            <admintype1></admintype1>
            <adminnom1></adminnom1>
            <adminadr1></adminadr1>
            <admincp1></admincp1>
            <adminville1></adminville1>
            <admincode2></admincode2>
            <admintype2></admintype2>
            <adminnom2></adminnom2>
            <adminadr2></adminadr2>
            <admincp2></admincp2>
            <adminville2></adminville2>
        </procedure>
        <procedure>
            <dateproc>20100505</dateproc>
            <codeproc>13</codeproc>
            <typeproc>Liquidation judiciaire</typeproc>
            <admincode1>4100</admincode1>
            <admintype1>Liquidateur</admintype1>
            <adminnom1>SCP B.T.S.G en la personne de Me Stéphane GORRIAS</adminnom1>
            <adminadr1>1 PL BOIELDIEU</adminadr1>
            <admincp1>75002</admincp1>
            <adminville1>PARIS</adminville1>
            <admincode2></admincode2>
            <admintype2></admintype2>
            <adminnom2></adminnom2>
            <adminadr2></adminadr2>
            <admincp2></admincp2>
            <adminville2></adminville2>
        </procedure>
        <procedure>
            <dateproc>20100625</dateproc>
            <codeproc>08</codeproc>
            <typeproc>Jugement autorisant la poursuite d'activité</typeproc>
            <admincode1></admincode1>
            <admintype1></admintype1>
            <adminnom1></adminnom1>
            <adminadr1></adminadr1>
            <admincp1></admincp1>
            <adminville1></adminville1>
            <admincode2></admincode2>
            <admintype2></admintype2>
            <adminnom2></adminnom2>
            <adminadr2></adminadr2>
            <admincp2></admincp2>
            <adminville2></adminville2>
        </procedure>
        <procedure>
            <dateproc>20100707</dateproc>
            <codeproc>14</codeproc>
            <typeproc>Plan de cession</typeproc>
            <admincode1>4100</admincode1>
            <admintype1>Liquidateur</admintype1>
            <adminnom1>SCP B.T.S.G en la personne de Me Stéphane GORRIAS</adminnom1>
            <adminadr1>1 PL BOIELDIEU</adminadr1>
            <admincp1>75002</admincp1>
            <adminville1>PARIS</adminville1>
            <admincode2></admincode2>
            <admintype2></admintype2>
            <adminnom2></adminnom2>
            <adminadr2></adminadr2>
            <admincp2></admincp2>
            <adminville2></adminville2>
        </procedure>
    </procedures>
</data>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Procédures Collectives
GET/entreprise/{numid}/procedurescollectives

Retourne toutes les informations juridiques concernant les procédures collectives de l’entreprise.
Le paramètre {numid} permet de passer un numéro d’identification unique de l’entreprise dont on souhaite récupérer les informations. Ce numéro d’identification peut être :

  • un numéro SIREN (exemple 493467849)

  • un numéro SIRET (exemple : 42872326600048)

  • un numéro de TVA intracomm. (exemple FR56428723266)

Liste des champs des résultats (code HTTP 200) :

  • nbprocedures : Nombre de procédures collectives de l’entreprise

  • dateproc : Date de la procédure collective de l’entreprise. Format : AAAAMMJJ

  • codeproc : Code de la procédure collective de l’entreprise

  • typeproc : Type de la procédure collective de l’entreprise

  • admincode1 : Code du premier administrateur judiciaire en charge de la procédure collective.

  • admintype1 : Type de l’administrateur judiciaire en charge de la procédure collective.

  • adminnom1 : Nom du premier administrateur judiciaire en charge de la procédure collective.

  • adminadr1 : Adresse du premier administrateur judiciaire en charge de la procédure collective.

  • admincp1 : Code postal du premier administrateur judiciaire en charge de la procédure collective.

  • adminville1 : Ville du premier administrateur judiciaire en charge de la procédure collective.

  • admincode2 : Code du second administrateur judiciaire en charge de la procédure collective.

  • admintype2 : Type de l’administrateur judiciaire en charge de la procédure collective.

  • adminnom2 : Nom du second administrateur judiciaire en charge de la procédure collective.

  • adminadr2 : Adresse du second administrateur judiciaire en charge de la procédure collective.

  • admincp2 : Code postal du second administrateur judiciaire en charge de la procédure collective.

  • adminville2 : Ville du second administrateur judiciaire en charge de la procédure collective.

URI Parameters
HideShow
numid
string (required) Example: 493467849

un numéro SIREN, un numéro SIRET ou un numéro de TVA intracomm.


Evènements

GET https://api.societe.com/api/v1/entreprise/493467849/evenements
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
{
  "data": {
    "nbevenements": 52,
    "evenements": [
      {
        "dateevenement": "20061228",
        "labelevenement": "Statuts"
      },
      {
        "dateevenement": "20070201",
        "labelevenement": "Requete et ordonnance"
      },
      {
        "dateevenement": "20070227",
        "labelevenement": "Changement de forme juridique avec changement de catégorie"
      },
      {
        "dateevenement": "20070227",
        "labelevenement": "Changement de Président (PDG, PCA)"
      },
      {
        "dateevenement": "20070227",
        "labelevenement": "Nomination/démission des organes de gestion"
      },
      {
        "dateevenement": "20070227",
        "labelevenement": "PV d'Assemblée"
      },
      {
        "dateevenement": "20070227",
        "labelevenement": "Statuts mis à jour"
      },
      {
        "dateevenement": "20070227",
        "labelevenement": "Rapport des commissaires ou du gérant"
      },
      {
        "dateevenement": "20070515",
        "labelevenement": "Augmentation de capital"
      },
      {
        "dateevenement": "20070515",
        "labelevenement": "Certificat de dépot des fonds"
      },
      {
        "dateevenement": "20070515",
        "labelevenement": "PV d'Assemblée"
      },
      {
        "dateevenement": "20070515",
        "labelevenement": "Statuts mis à jour"
      },
      {
        "dateevenement": "20070515",
        "labelevenement": "Rapport des commissaires ou du gérant"
      },
      {
        "dateevenement": "20070521",
        "labelevenement": "Acte sous seing privé"
      },
      {
        "dateevenement": "20070521",
        "labelevenement": "Apport partiel"
      },
      {
        "dateevenement": "20070521",
        "labelevenement": "Acte sous seing privé"
      },
      {
        "dateevenement": "20070621",
        "labelevenement": "Rapport des commissaires ou du gérant"
      },
      {
        "dateevenement": "20070713",
        "labelevenement": "Augmentation de capital"
      },
      {
        "dateevenement": "20070713",
        "labelevenement": "Changement de dénomination sociale"
      },
      {
        "dateevenement": "20070713",
        "labelevenement": "Déclaration de conformité"
      },
      {
        "dateevenement": "20070713",
        "labelevenement": "PV d'Assemblée"
      },
      {
        "dateevenement": "20070713",
        "labelevenement": "PV du Conseil d'Administration"
      },
      {
        "dateevenement": "20070713",
        "labelevenement": "Statuts mis à jour"
      },
      {
        "dateevenement": "20070713",
        "labelevenement": "Procuration"
      },
      {
        "dateevenement": "20070724",
        "labelevenement": "Nomination/démission des organes de gestion"
      },
      {
        "dateevenement": "20071122",
        "labelevenement": "Nomination/démission des organes de gestion"
      },
      {
        "dateevenement": "20071122",
        "labelevenement": "PV d'Assemblée"
      },
      {
        "dateevenement": "20080104",
        "labelevenement": "Nomination/démission des organes de gestion"
      },
      {
        "dateevenement": "20080609",
        "labelevenement": "Requete et ordonnance"
      },
      {
        "dateevenement": "20080625",
        "labelevenement": "Rapport des commissaires ou du gérant"
      },
      {
        "dateevenement": "20080702",
        "labelevenement": "Augmentation de capital"
      },
      {
        "dateevenement": "20080702",
        "labelevenement": "Statuts mis à jour"
      },
      {
        "dateevenement": "20080702",
        "labelevenement": "Rapport des commissaires ou du gérant"
      },
      {
        "dateevenement": "20080702",
        "labelevenement": "Acte modificatif"
      },
      {
        "dateevenement": "20080828",
        "labelevenement": "Augmentation de capital"
      },
      {
        "dateevenement": "20080828",
        "labelevenement": "Certificat de dépot des fonds"
      },
      {
        "dateevenement": "20080828",
        "labelevenement": "PV d'Assemblée"
      },
      {
        "dateevenement": "20080828",
        "labelevenement": "Statuts mis à jour"
      },
      {
        "dateevenement": "20080909",
        "labelevenement": "Requete et ordonnance"
      },
      {
        "dateevenement": "20080929",
        "labelevenement": "Rapport des commissaires ou du gérant"
      },
      {
        "dateevenement": "20081017",
        "labelevenement": "Augmentation de capital"
      },
      {
        "dateevenement": "20081017",
        "labelevenement": "Certificat de dépot des fonds"
      },
      {
        "dateevenement": "20081017",
        "labelevenement": "Nomination/démission des organes de gestion"
      },
      {
        "dateevenement": "20081017",
        "labelevenement": "Statuts mis à jour"
      },
      {
        "dateevenement": "20081125",
        "labelevenement": "Changement de Président (PDG, PCA)"
      },
      {
        "dateevenement": "20081125",
        "labelevenement": "Nomination/démission des organes de gestion"
      },
      {
        "dateevenement": "20081125",
        "labelevenement": "PV d'Assemblée"
      },
      {
        "dateevenement": "20090622",
        "labelevenement": "Changement de commissaire aux comptes"
      },
      {
        "dateevenement": "20100301",
        "labelevenement": "Augmentation de capital"
      },
      {
        "dateevenement": "20100301",
        "labelevenement": "Statuts mis à jour"
      },
      {
        "dateevenement": "20100301",
        "labelevenement": "Rapport des commissaires ou du gérant"
      },
      {
        "dateevenement": "20100412",
        "labelevenement": "Statuts mis à jour"
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
<?xml version="1.0" encoding="UTF-8"?>
<data>
    <nbevenements>52</nbevenements>
    <evenements>
        <evenement>
            <dateevenement>20061228</dateevenement>
            <labelevenement>Statuts</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070201</dateevenement>
            <labelevenement>Requete et ordonnance</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070227</dateevenement>
            <labelevenement>Changement de forme juridique avec changement de catégorie</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070227</dateevenement>
            <labelevenement>Changement de Président (PDG, PCA)</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070227</dateevenement>
            <labelevenement>Nomination/démission des organes de gestion</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070227</dateevenement>
            <labelevenement>PV d'Assemblée</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070227</dateevenement>
            <labelevenement>Statuts mis à jour</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070227</dateevenement>
            <labelevenement>Rapport des commissaires ou du gérant</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070515</dateevenement>
            <labelevenement>Augmentation de capital</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070515</dateevenement>
            <labelevenement>Certificat de dépot des fonds</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070515</dateevenement>
            <labelevenement>PV d'Assemblée</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070515</dateevenement>
            <labelevenement>Statuts mis à jour</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070515</dateevenement>
            <labelevenement>Rapport des commissaires ou du gérant</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070521</dateevenement>
            <labelevenement>Acte sous seing privé</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070521</dateevenement>
            <labelevenement>Apport partiel</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070521</dateevenement>
            <labelevenement>Acte sous seing privé</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070621</dateevenement>
            <labelevenement>Rapport des commissaires ou du gérant</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070713</dateevenement>
            <labelevenement>Augmentation de capital</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070713</dateevenement>
            <labelevenement>Changement de dénomination sociale</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070713</dateevenement>
            <labelevenement>Déclaration de conformité</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070713</dateevenement>
            <labelevenement>PV d'Assemblée</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070713</dateevenement>
            <labelevenement>PV du Conseil d'Administration</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070713</dateevenement>
            <labelevenement>Statuts mis à jour</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070713</dateevenement>
            <labelevenement>Procuration</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20070724</dateevenement>
            <labelevenement>Nomination/démission des organes de gestion</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20071122</dateevenement>
            <labelevenement>Nomination/démission des organes de gestion</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20071122</dateevenement>
            <labelevenement>PV d'Assemblée</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080104</dateevenement>
            <labelevenement>Nomination/démission des organes de gestion</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080609</dateevenement>
            <labelevenement>Requete et ordonnance</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080625</dateevenement>
            <labelevenement>Rapport des commissaires ou du gérant</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080702</dateevenement>
            <labelevenement>Augmentation de capital</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080702</dateevenement>
            <labelevenement>Statuts mis à jour</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080702</dateevenement>
            <labelevenement>Rapport des commissaires ou du gérant</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080702</dateevenement>
            <labelevenement>Acte modificatif</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080828</dateevenement>
            <labelevenement>Augmentation de capital</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080828</dateevenement>
            <labelevenement>Certificat de dépot des fonds</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080828</dateevenement>
            <labelevenement>PV d'Assemblée</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080828</dateevenement>
            <labelevenement>Statuts mis à jour</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080909</dateevenement>
            <labelevenement>Requete et ordonnance</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20080929</dateevenement>
            <labelevenement>Rapport des commissaires ou du gérant</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20081017</dateevenement>
            <labelevenement>Augmentation de capital</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20081017</dateevenement>
            <labelevenement>Certificat de dépot des fonds</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20081017</dateevenement>
            <labelevenement>Nomination/démission des organes de gestion</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20081017</dateevenement>
            <labelevenement>Statuts mis à jour</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20081125</dateevenement>
            <labelevenement>Changement de Président (PDG, PCA)</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20081125</dateevenement>
            <labelevenement>Nomination/démission des organes de gestion</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20081125</dateevenement>
            <labelevenement>PV d'Assemblée</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20090622</dateevenement>
            <labelevenement>Changement de commissaire aux comptes</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20100301</dateevenement>
            <labelevenement>Augmentation de capital</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20100301</dateevenement>
            <labelevenement>Statuts mis à jour</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20100301</dateevenement>
            <labelevenement>Rapport des commissaires ou du gérant</labelevenement>
        </evenement>
        <evenement>
            <dateevenement>20100412</dateevenement>
            <labelevenement>Statuts mis à jour</labelevenement>
        </evenement>
    </evenements>
</data>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Evènements
GET/entreprise/{numid}/evenements

Retourne tous les évènements légaux de l’entreprise.
Le paramètre {numid} permet de passer un numéro d’identification unique de l’entreprise dont on souhaite récupérer les informations. Ce numéro d’identification peut être :

  • un numéro SIREN (exemple 493467849)

  • un numéro SIRET (exemple : 42872326600048)

  • un numéro de TVA intracomm. (exemple FR56428723266)

Liste des champs des résultats (code HTTP 200) :

  • nbevenements : Nombre total d’événement de l’entreprise.

  • dateevenement : Date de l’évènement de l’entreprise. Format : AAAAMMJJ

  • labelevenement : Label de l’évènement de l’entreprise.

URI Parameters
HideShow
numid
string (required) Example: 493467849

un numéro SIREN, un numéro SIRET ou un numéro de TVA intracomm.


Recherche

Recherche d'entreprise

GET https://api.societe.com/api/v1/entreprise/search?nom=societe&debut=5&nbrep=1
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
{
  "data": {
    "moderecherche": "noexa",
    "page": 6,
    "totalpages": 471123,
    "nbtot": 471122,
    "results": [
      {
        "nomcommercial": "SOCIETE COOPERATIVE ABBEVILLOISE D'APPROVISIONNEMENT",
        "siren": "005520119",
        "nafcode": "512A",
        "naflib": "Commerce de gros de céréales et aliments pour le bétail",
        "cpville": "80100 ABBEVILLE",
        "dep": "80",
        "longitude": "",
        "latitude": ""
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
<?xml version="1.0" encoding="UTF-8"?>
<data>
    <moderecherche>noexa</moderecherche>
    <page>6</page>
    <totalpages>471123</totalpages>
    <nbtot>471122</nbtot>
    <results>
        <result>
            <nomcommercial>SOCIETE COOPERATIVE ABBEVILLOISE D'APPROVISIONNEMENT</nomcommercial>
            <siren>005520119</siren>
            <nafcode>512A</nafcode>
            <naflib>Commerce de gros de céréales et aliments pour le bétail</naflib>
            <cpville>80100 ABBEVILLE</cpville>
            <dep>80</dep>
            <longitude></longitude>
            <latitude></latitude>
        </result>
    </results>
</data>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Recherche d'entreprise
GET/entreprise/search{?nom}{&debut}{&nbrep}

Retourne les entreprises correspondant à la recherche.

Liste des champs des résultats (code HTTP 200) :

  • moderecherche: Mode de recherche

  • page: Page actuelle de résultats de recherche

  • totalpages: Nombre total de pages de résultats de recherche

  • nbtot: Nombre total de résultats de recherche.

  • nomcommercial: Nom commercial déclaré au RCS. C’est une précision de la raison sociale qui peut servir de dénomination secondaire pour l’entreprise. C’est le nom sous lequel l’activité d’une société est connue du public (facultatif)

  • siren: Numéro SIREN de l’entreprise. Numéro d’enregistrement de l’entreprise au registre du Commerce et des Sociétés (RCS)

  • nafcode: Code d’activité NAF / APE déclaré au RCS. Ce code décrit la catégorie précise (parmi 732 sous-classes) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • naflib: Libellé de l’activité NAF / APE déclaré au RCS.

  • cpville: Code Postal et ville déclarés au RCS

  • dep: Département

  • longitude: Longitude de l’adresse de l’entreprise

  • latitude: Latitude de l’adresse de l’entreprise

URI Parameters
HideShow
nom
string (optional) Example: societe

Nom de l’entreprise

exa
string (optional) Example: on

Recherche exacte sur le nom de l’entreprise (prend uniquement la valeur ‘on’)

dirig
string (optional) Example: dupont

Nom du dirigeant

pre
string (optional) Example: damien

Prénom du diriegant (nécessite un champ supplémentaire)

ape
string (optional) Example: 3700Z

Code ape (nécessite un champ supplémentaire)

dep
string (optional) Example: 75

Département (nécessite un champ supplémentaire)

debut
string (optional) Example: 5

Offset permettant d’obtenir les résultats suivants
+ Default: 0

nbrep
string (optional) Example: 1

Nombre de résultats max obtenus (max possible 1000)
+ Default: 200


Recherche d'établissement

GET https://api.societe.com/api/v1/etablissement/search?nom=societe&debut=5&nbrep=1
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
{
  "data": {
    "page": 6,
    "totalpages": 508563,
    "nbtot": 508562,
    "results": [
      {
        "raisonsociale": "SOCIETE BRETONNE DE TRAVAUX PUBLICS SBTP",
        "sigle": "",
        "enseigne": "",
        "adresse": "la Pelliere",
        "siren": "005480082",
        "nafcode": "451A",
        "naflib": "Terrassements divers",
        "cpville": "44800 ST HERBLAIN",
        "dep": "44",
        "longitude": "",
        "latitude": ""
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
<?xml version="1.0" encoding="UTF-8"?>
<data>
    <page>6</page>
    <totalpages>508563</totalpages>
    <nbtot>508562</nbtot>
    <results>
        <result>
            <raisonsociale>SOCIETE BRETONNE DE TRAVAUX PUBLICS SBTP</raisonsociale>
            <sigle></sigle>
            <enseigne></enseigne>
            <adresse>la Pelliere</adresse>
            <siren>005480082</siren>
            <nafcode>451A</nafcode>
            <naflib>Terrassements divers</naflib>
            <cpville>44800 ST HERBLAIN</cpville>
            <dep>44</dep>
            <longitude></longitude>
            <latitude></latitude>
        </result>
    </results>
</data>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Recherche d'établissement
GET/etablissement/search{?nom}{&debut}{&nbrep}

Retourne les entreprises correspondant à la recherche.

Liste des champs des résultats (code HTTP 200) :

  • page: Page actuelle de résultats de recherche

  • totalpages: Nombre total de pages de résultats de recherche

  • nbtot: Nombre total de résultats de recherche.

  • raisonsociale: Dénomination de l’entreprise déclarée au RCS. C’est la raison sociale de la société déclarée au registre du commerce et des sociétés. Elle identifie l’entreprise en tant que personne morale

  • sigle: Sigle déclaré au RCS. Le sigle d’une société correspond à un diminutif de la dénomination sociale

  • enseigne: Enseigne déclarée au RCS. C’est un complément de la dénomination pour l’entreprise

  • adresse: Nom de l’adresse déclarée au RCS (numéro et nom de voie)

  • siren: Numéro SIREN de l’entreprise. Numéro d’enregistrement de l’entreprise au registre du Commerce et des Sociétés (RCS)

  • nafcode: Code d’activité NAF / APE déclaré au RCS. Ce code décrit la catégorie précise (parmi 732 sous-classes) à laquelle appartient l’entreprise. Cf. tableau ci-dessous

  • naflib: Libellé de l’activité NAF / APE déclaré au RCS.

  • cpville: Code Postal et ville déclarés au RCS

  • dep: Département

  • longitude: Longitude de l’adresse de l’entreprise

  • latitude: Latitude de l’adresse de l’entreprise

URI Parameters
HideShow
nom
string (optional) Example: societe

Nom de l’entreprise

dirig
string (optional) Example: dupont

Nom du dirigeant

pre
string (optional) Example: damien

Prénom du diriegant (nécessite un champ supplémentaire)

ape
string (optional) Example: 3700Z

iCode ape (nécessite un champ supplémentaire)

dep
string (optional) Example: 75

Département (nécessite un champ supplémentaire)

debut
string (optional) Example: 5

Offset permettant d’obtenir les résultats suivants
+ Default: 0

nbrep
string (optional) Example: 1

Nombre de résultats max obtenus (max possible 1000)
+ Default: 200


Dirigeant

Mandats

GET https://api.societe.com/api/v1/mandats/Xavier.NIEL.59467820
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
{
  "data": {
    "civilite": "M",
    "nom": "DUPONT",
    "prenom": "Jean",
    "datenaissance": "19400318",
    "url": "https://dirigeant.societe.com/dirigeant/Jean.DUPONT.31202604.html",
    "nbmandats": 4,
    "mandats": [
      {
        "codefonction": "0120",
        "fonctionlibelle": "PDG",
        "siren": "422956151",
        "denomination": "ARCANDE",
        "codepostal": "33600",
        "ville": "PESSAC",
        "activite": "316D",
        "activitelibelle": "Fabrication de matériels électriques n.c.a.",
        "url": "https://www.societe.com/societe/arcande-422956151.html",
        "bilan": {
          "datedernierbilan": 2004,
          "monnaie": "EU",
          "resnet": 8000,
          "ca": 85000,
          "eff": -1
        }
      },
      {
        "codefonction": "4100",
        "fonctionlibelle": "Liquidateur",
        "siren": "482932522",
        "denomination": "DLG DIFFUSION",
        "codepostal": "33138",
        "ville": "LANTON",
        "activite": "4652Z",
        "activitelibelle": "Commerce de gros (commerce interentreprises) de composants et d'équipements électroniques et de télécommunication",
        "url": "https://www.societe.com/societe/dlg-diffusion-482932522.html",
        "bilan": {
          "datedernierbilan": 2014,
          "monnaie": "EU",
          "resnet": 12300,
          "ca": 173700,
          "eff": -1
        }
      },
      {
        "codefonction": "0200",
        "fonctionlibelle": "Gérant",
        "siren": "531875490",
        "denomination": "AQ",
        "codepostal": "33138",
        "ville": "LANTON",
        "activite": "6820B",
        "activitelibelle": "Location de terrains et d'autres biens immobiliers",
        "url": "https://www.societe.com/societe/aq-531875490.html"
      },
      {
        "codefonction": "4100",
        "fonctionlibelle": "Liquidateur",
        "siren": "750424160",
        "denomination": "SCI STIVE FAMILY",
        "codepostal": "33138",
        "ville": "LANTON",
        "activite": "6820B",
        "activitelibelle": "Location de terrains et d'autres biens immobiliers",
        "url": "https://www.societe.com/societe/sci-stive-family-750424160.html"
      }
    ],
    "nbcomandataires": 3,
    "comandataires": [
      {
        "civilite": "M",
        "nom": "BOTTIER",
        "prenom": "Patrick",
        "datenaissance": "19521208",
        "url": "https://dirigeant.societe.com/dirigeant/Patrick.BOTTIER.86842902.html",
        "nbmandats": 1
      },
      {
        "civilite": "M",
        "nom": "LEBRUN",
        "prenom": "Claude",
        "datenaissance": "19480811",
        "url": "https://dirigeant.societe.com/dirigeant/Claude.LEBRUN.41262204.html",
        "nbmandats": 1
      },
      {
        "civilite": "MME",
        "nom": "DELFORT",
        "prenom": "Myriam",
        "datenaissance": "19490204",
        "url": "https://dirigeant.societe.com/dirigeant/Myriam.DELFORT.11266800.html",
        "nbmandats": 1
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
<?xml version="1.0" encoding="UTF-8"?>
<data>
    <civilite>M</civilite>
    <nom>DUPONT</nom>
    <prenom>Jean</prenom>
    <datenaissance>19400318</datenaissance>
    <url>https://dirigeant.societe.com/dirigeant/Jean.DUPONT.31202604.html</url>
    <nbmandats>4</nbmandats>
    <mandats>
        <mandat>
            <codefonction>0120</codefonction>
            <fonctionlibelle>PDG</fonctionlibelle>
            <siren>422956151</siren>
            <denomination>ARCANDE</denomination>
            <codepostal>33600</codepostal>
            <ville>PESSAC</ville>
            <activite>316D</activite>
            <activitelibelle>Fabrication de matériels électriques n.c.a.</activitelibelle>
            <url>https://www.societe.com/societe/arcande-422956151.html</url>
            <bilan>
                <datedernierbilan>2004</datedernierbilan>
                <monnaie>EU</monnaie>
                <resnet>8000</resnet>
                <ca>85000</ca>
                <eff>-1</eff>
            </bilan>
        </mandat>
        <mandat>
            <codefonction>4100</codefonction>
            <fonctionlibelle>Liquidateur</fonctionlibelle>
            <siren>482932522</siren>
            <denomination>DLG DIFFUSION</denomination>
            <codepostal>33138</codepostal>
            <ville>LANTON</ville>
            <activite>4652Z</activite>
            <activitelibelle>Commerce de gros (commerce interentreprises) de composants et d'équipements électroniques et de télécommunication</activitelibelle>
            <url>https://www.societe.com/societe/dlg-diffusion-482932522.html</url>
            <bilan>
                <datedernierbilan>2014</datedernierbilan>
                <monnaie>EU</monnaie>
                <resnet>12300</resnet>
                <ca>173700</ca>
                <eff>-1</eff>
            </bilan>
        </mandat>
        <mandat>
            <codefonction>0200</codefonction>
            <fonctionlibelle>Gérant</fonctionlibelle>
            <siren>531875490</siren>
            <denomination>AQ</denomination>
            <codepostal>33138</codepostal>
            <ville>LANTON</ville>
            <activite>6820B</activite>
            <activitelibelle>Location de terrains et d'autres biens immobiliers</activitelibelle>
            <url>https://www.societe.com/societe/aq-531875490.html</url>
        </mandat>
        <mandat>
            <codefonction>4100</codefonction>
            <fonctionlibelle>Liquidateur</fonctionlibelle>
            <siren>750424160</siren>
            <denomination>SCI STIVE FAMILY</denomination>
            <codepostal>33138</codepostal>
            <ville>LANTON</ville>
            <activite>6820B</activite>
            <activitelibelle>Location de terrains et d'autres biens immobiliers</activitelibelle>
            <url>https://www.societe.com/societe/sci-stive-family-750424160.html</url>
        </mandat>
    </mandats>
    <nbcomandataires>3</nbcomandataires>
    <comandataires>
        <comandataire>
            <civilite>M</civilite>
            <nom>BOTTIER</nom>
            <prenom>Patrick</prenom>
            <datenaissance>19521208</datenaissance>
            <url>https://dirigeant.societe.com/dirigeant/Patrick.BOTTIER.86842902.html</url>
            <nbmandats>1</nbmandats>
        </comandataire>
        <comandataire>
            <civilite>M</civilite>
            <nom>LEBRUN</nom>
            <prenom>Claude</prenom>
            <datenaissance>19480811</datenaissance>
            <url>https://dirigeant.societe.com/dirigeant/Claude.LEBRUN.41262204.html</url>
            <nbmandats>1</nbmandats>
        </comandataire>
        <comandataire>
            <civilite>MME</civilite>
            <nom>DELFORT</nom>
            <prenom>Myriam</prenom>
            <datenaissance>19490204</datenaissance>
            <url>https://dirigeant.societe.com/dirigeant/Myriam.DELFORT.11266800.html</url>
            <nbmandats>1</nbmandats>
        </comandataire>
    </comandataires>
</data>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Mandats
GET/mandats/{dirid}

Retourne les informations des mandats exercés par le dirigeant dans différentes entreprises.
Le paramètre {dirid} permet de passer un identifiant unique du dirigeant dont on souhaite récupérer les informations (exemple : Xavier.NIEL.59467820)

Liste des champs des résultats (code HTTP 200) :

  • civilite : Civilité du dirigeant (ou du co-mandataire si dans comandataires)

  • nom : Nom du dirigeant (ou du co-mandataire si dans comandataires)

  • prenom : Prénom du dirigeant (ou du co-mandataire si dans comandataires)

  • datenaissance : Date de naissance du dirigeant (ou du co-mandataire si dans comandataires)

  • url : Url de la fiche sur Dirigeant.com (ou du co-mandataire si dans comandataires) ou Url de la fiche sur Societe.com si dans mandats

  • nbmandats : Nombre de mandat que le dirigeant (ou du co-mandataire si dans comandataires) exerce dans des entreprises

  • mandats : Liste des mandats

  • codefonction : Code de la fonction du mandat du dirigeant dans cette entreprise

  • fonctionlibelle : Libellé de la fonction du mandat du dirigeant dans cette entreprise

  • siren : Siren de l’entreprise dans laquelle le dirigeant exerce ce mandat

  • denomination : Dénomination sociale de l’entreprise dans laquelle le dirigeant exerce ce mandat

  • codepostal : Code postal du siège social de l’entreprise dans laquelle le dirigeant exerce ce mandat

  • ville : Ville du siège social de l’entreprise dans laquelle le dirigeant exerce ce mandat

  • activite : Code de l’activité de l’entreprise dans laquelle le dirigeant exerce ce mandat

  • activitelibelle : Libellé de l’activité de l’entreprise dans laquelle le dirigeant exerce ce mandat.

  • bilan : Dernier bilan de l’entreprise dans laquelle le dirigeant exerce ce mandat

  • datedernierbilan : Date du dernier bilan de l’entreprise dans laquelle le dirigeant exerce ce mandat

  • monnaie : Devise du dernier bilan de l’entreprise dans laquelle le dirigeant exerce ce mandat

  • resnet : Résultat net du dernier bilan de l’entreprise dans laquelle le dirigeant exerce ce mandat

  • ca : Chiffre d’affaire net du dernier bilan de l’entreprise dans laquelle le dirigeant exerce ce mandat

  • eff : Effectif du dernier bilan de l’entreprise dans laquelle le dirigeant exerce ce mandat

  • nbcomandataires : Nombre de co-mandataires du dirigeant

  • comandataire : Liste des co-mandataires du dirigeant

URI Parameters
HideShow
dirid
string (required) Example: Xavier.NIEL.59467820

identifiant d’un mandataire


Compte client

Informations client

GET https://api.societe.com/api/v1/infoclient
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
{
  "data": {
    "token": "0123456789abcdef0123456789abcdef",
    "nbips": 1,
    "ips": [
      {
        "ip": "1.2.3.4"
      }
    ],
    "nbhit": 84,
    "creditmode": "illimite",
    "creditrestant": "100.00",
    "comptegele": false,
    "compteactif": true,
    "freqmode": "illimite",
    "nbversion": 1,
    "versions": [
      {
        "numeroversion": 1,
        "datedernierappel": "20220505171438"
      }
    ],
    "creditdernierforfait": "100.00",
    "prixdernierforfait": "0.00",
    "datedernierforfait": "20220505"
  }
}
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
Body
<?xml version="1.0" encoding="UTF-8"?>
<data>
    <token>0123456789abcdef0123456789abcdef</token>
    <nbips>1</nbips>
    <ips>
        <ip>
            <ip>1.2.3.4</ip>
        </ip>
    </ips>
    <nbhit>85</nbhit>
    <creditmode>illimite</creditmode>
    <creditrestant>100.00</creditrestant>
    <comptegele>false</comptegele>
    <compteactif>true</compteactif>
    <freqmode>illimite</freqmode>
    <nbversion>1</nbversion>
    <versions>
        <version>
            <numeroversion>1</numeroversion>
            <datedernierappel>20220505171438</datedernierappel>
        </version>
    </versions>
    <creditdernierforfait>100.00</creditdernierforfait>
    <prixdernierforfait>0.00</prixdernierforfait>
    <datedernierforfait>20220505</datedernierforfait>
</data>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Informations client
GET/infoclient

Récupère les informations correspondant à votre compte client.

Liste des champs des résultats (code HTTP 200) :

  • token : Le numéro unique d’identification d’un compte client API (TOKEN)

  • nbips : Nombre total d’adresses IP déclarée. Ces sont les adresses IP qui pourront utiliser l’API avec. le token ci-dessus.

  • ip : Adresse IP déclarée

  • nbhit : Ce champ représente le nombre de requêtes effectées depuis l’ouverture du compte

  • creditmode : Mode de consommation des criédits

  • creditrestant : Nombre de crédits restant

  • comptegele : Compte gelé

  • compteactif : Compte actif

  • freqmode : Mode de fréquence d’appel

  • nbversions : Nombre de versions différentes déjà utilisées par le passé.

  • versions : Liste des versions utilisées ainsi que la date de la dernière utilisation.

  • numeroversion : Numéro de la version

  • datedernierappel : Date du dernier appel réalisé sur cette version. Format : AAAAMMDDHHMMSS

  • creditdernierforfait : Crédits ajoutés par le dernier forfait acheté

  • prixdernierforfait : Prix du dernier forfait

  • datedernierforfait : Date d’achat du dernier forfait


Log client

GET https://api.societe.com/api/v1/logclient
Requestsformat=jsonformat=xml
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
This response has no content.
Body
{
  "error": {
    "codemsg": "Bad Request",
    "params": [
      {
        "desc": "Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null))."
      }
    ]
  }
}
Body
{
  "error": {
    "codemsg": "Unauthorized"
  }
}
Body
{
  "error": {
    "codemsg": "Payment Required"
  }
}
Body
{
  "error": {
    "codemsg": "Forbidden"
  }
}
Body
{
  "error": {
    "codemsg": "Not Found"
  }
}
Body
{
  "error": {
    "codemsg": "Method Not Allowed"
  }
}
Body
{
  "error": {
    "codemsg": "Too Many Requests",
    "retryafter": "5"
  }
}
Body
{
  "error": {
    "codemsg": "Internal Server Error"
  }
}
Body
{
  "error": {
    "codemsg": "Service Unavailable"
  }
}
Headers
X-Authorization: socapi {token}
Responses200400401402403404405429500503
This response has no content.
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Bad Request</codemsg>
    <params>
        <param>
            <desc>Le parametre rncs ne valide pas la fonction de check (taille minimum : 9, taille maximum : 9, range : (null)).</desc>
        </param>
    </params>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Unauthorized</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Payment Required</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Forbidden</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Not Found</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Method Not Allowed</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Too Many Requests</codemsg>
    <retryafter>5</retryafter>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Internal Server Error</codemsg>
</error>
Body
<?xml version="1.0" encoding="UTF-8"?>
<error>
    <codemsg>Service Unavailable</codemsg>
</error>

Log client
GET/logclient

Récupération des logs clients (appels au service API PRO) au format .tgz.
Le fichier .tgz est un fichier compressé qui contient les logs clients sur les 13 derniers mois d’utilisation du service API PRO. Ce fichier .tgz contient donc plusieurs fichiers de logs intitulés AAAA-MM.log et contenant tous les logs clients d’un mois.

Liste des champs des résultats (code HTTP 200) :

  • colonne 1 : Adresse IP de l’appel

  • colonne 2 : Token utilisé pour l’appel

  • colonne 3 : Date et heure de l’appel. Format [AAAA-MM-JJ:HH:MM:SS]

  • colonne 4 : Méthode d’appel

  • colonne 5 : Url appelé

  • colonne 6 : Code http de retour


Annexes

Correspondance des formes juridiques

Télécharger les correspondances des formes juridiques : https://api.societe.com/api/v1/correspondance-catjur.csv

Correspondance des nafs

Télécharger les correspondances des nafs : https://api.societe.com/api/v1/correspondance-nafs.csv

Generated by aglio on 05 May 2022