Credits


En fonction de votre formule, vous disposez d'un stock de crédits mensuel. Chaque requête réussie consomme un ou plusieurs crédits Le coût en crédits de chaque opération est défini dans la documentation ci-dessous.


Gestion d'erreur


Le champ "success" prend la valeur "true" si la requête s'est correctement déroulée. Dans le cas contraire, le champ "success" prend la valeur "false" et un code d'erreur est retourné dans le champ "errorCode". Voici les différents codes d'erreur que vous pourrez rencontrer :

  • API_COMPANY_NOT_FOUND La société n'a pas été trouvée
  • API_INVALID_KEY La clé d'API est invalide
  • API_MAX_MATCH_EXCEEDED Les crédits de la clé d'API sont épuisés
  • API_INVALID_PAGE La page demandée n'existe pas
  • USER_COMPANY_EXPIRED Le compte est expiré, la carte de crédit a été refusée

Exemple d'erreur

{ "success": false, "errorType": "Functionnal", "errorCode": "API_INVALID_KEY", "errorMessage": "The api key is invalid" }


Consulter sa consommation


Ce service permet de consulter vos crédits disponibles.

https://societeinfo.com/app/rest/api/v1/apikeyinfo/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètre obligatoire

  • key — Clé d'API

Exemple

{ "success": true, "result": { "consumedCredits": 12457, "maxCredits": 50000, "extraCredits": 50000, "consumedExtraCredits": 0, "totalAvailableCredits": 87543 } }


Rechercher des sociétés par mots clés  1 crédit/requête


Ce service permet la recherche par nom ou mots clés et lieu sur l'ensemble de notre base. Ajustez le paramètre searchMode si vous souhaitez effectuer une recherche sémantique avec des opérateurs booléens.
Le service renvoie une vue synthétique des sociétés (nom, activité, adresse formatée, géolocation).
Pour obtenir les informations détaillées de l'entreprise, utilisez ensuite le service de recherche par ID

https://societeinfo.com/app/rest/api/v1/querysearch/companies/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètres obligatoires

  • key — Clé d'API. Elle vous identifie à des fins de gestion des quotas.
  • page (1 par défaut) — Numéro de la page de résultats
  • limit (10 par défaut) — Nombre de résultats par page. Limité à 25.

Paramètres facultatifs

  • query — Termes spécifiés pour la recherche
  • searchMode — Spécifie le type de recherche exécutée. Les valeurs possibles sont les suivantes :
    • legalname (par défaut) Limite la recherche à la raison social des entreprises.
    • keyword Exécute une recherche sémantique sur tous les contenus texte associé à l'entreprise (sources légales, code APE, sites web, réseaux sociaux...). Supporte les opérateurs booléens AND, OR, NOT
    • person Limite la recherche aux noms des dirigeants des entreprises.
    • name Limite la recherche aux noms (dénomination, nom commercial, sigle) et marques des entreprises.
    • auto Exécute une recherche 'legalname', puis une recherche 'keyword' si le score de la recherche 'legalname' est insuffisant.
  • where — Ajoutez ce paramètre pour limiter les résultats au code postal ou à la ville définie
  • active (true par défaut) - Ajoutez ce paramètre pour limiter les résultats aux entreprises actives. Les valeurs possibles sont true ou false
  • withEstablishments (false par défaut) - Ajoutez ce paramètre pour inclure les établissements dans les résultats de recherche. Les valeurs possibles sont true ou false
  • minsales et maxsales - Ajoutez ce paramètre pour limiter les résultats aux entreprises dans la fourchette de chiffre d'affaire définie.
  • minprofits et maxprofits - Ajoutez ce paramètre pour limiter les résultats aux entreprises dans la fourchette de bénéfices définie.
  • minstaff et maxstaff - Ajoutez ce paramètre pour limiter les résultats aux entreprises dans la fourchette d'effectif définie.
  • mincreationdate et maxcreationdate - Ajoutez ce paramètre pour limiter les résultats aux entreprises dans la fourchette de date de création. (format YYYYMMDD)
  • withsite - Ajoutez ce paramètre pour limiter les résultats aux entreprises avec un site web identifié. Les valeurs possibles sont true ou false
  • withphone - Ajoutez ce paramètre pour limiter les résultats aux entreprises avec un téléphone identifié. Les valeurs possibles sont true ou false
  • withemail - Ajoutez ce paramètre pour limiter les résultats aux entreprises avec un mail identifié. Les valeurs possibles sont true ou false
  • withtwitter - Ajoutez ce paramètre pour limiter les résultats aux entreprises avec un compte twitter identifié. Les valeurs possibles sont true ou false
  • mintwitterfollowers - Ajoutez ce paramètre pour limiter les résultats aux entreprises dont l'un des comptes twitter a pour minimum le nombre d'abonnés définie.
  • mintwitterfriends - Ajoutez ce paramètre pour limiter les résultats aux entreprises dont l'un des comptes twitter a pour minimum le nombre d'abonnements définie.
  • sort - Ajoutez ce paramètre pour trier les résultats. Les valeurs possibles sont les suivantes :
    • score (par défaut) Pertinence
    • salesDesc Chiffre d'affaire décroissant
    • salesAsc Chiffre d'affaire croissant
    • salesGrowthDesc Variation chiffre d'affaire décroissant
    • salesGrowthAsc Variation chiffre d'affaire croissant
    • profitDesc Bénéfice décroissant
    • profitAsc Bénéfice croissant
    • profitGrowthDesc Variation bénéfice décroissant
    • profitGrowthAsc Variation bénéfice croissant
    • staffDesc Effectifs décroissants
    • staffAsc Effectifs croissants
    • staffGrowthDesc Variation effectifs décroissant
    • staffGrowthAsc Variation effectifs croissant
    • riskLevelDesc Risque décroissant
    • riskLevelAsc Risque croissant
    • creationDateDesc Date de création décroissante
    • creationDateAsc Date de création croissante
    • twitterFollowerDesc Followers twitter décroissant
    • alexaRankAsc Rank Alexa croissant
    • totalMarksDesc Nombre de marques décroissant

Exemple

{ "success": true, "total": 8504, "currentPage": 1, "totalPages": 1701, "result": [{ "id": "55f17646b3a2d5ccd3e40834", "registration_number": "494804230", "full_registration_number": "49480423000030", "legal_type": "Siege", "name": "LEARNISSIMO", "activity": "Création et édition de sites internet, commercialisation de produits et services sur internet", "formatted_address": "75009 Paris", "lng": 2.3522219, "lat": 48.856614 }, { "id": "55f178d7b3a2d5ccd3f3f9a8", "registration_number": "494925498", "full_registration_number": "49492549800011", "legal_type": "Siege", "name": "TUTO4PC.COM GROUP", "activity": "Créations de sites internet d'offres logiciels pour internet et publicités sur internet prise de participation dans toutes sociétés françaises ou etrangéres la gestion de ces participations la réalisation de toutes opérations sur les titres de participations composant le Protefeuille constitue.", "formatted_address": "75008 Paris", "lng": 2.3522219, "lat": 48.856614 }, { "id": "55f173edb3a2d5ccd3d42c2a", "registration_number": "504483892", "full_registration_number": "50448389200023", "legal_type": "Siege", "name": "WIBILONG", "activity": "Création, production et exploitation de média (logiciel, site Internet, commerce électronique)", "formatted_address": "75001 Paris", "lng": 2.3522219, "lat": 48.856614 }, { "id": "55f176bbb3a2d5ccd3e70a74", "registration_number": "504586140", "full_registration_number": "50458614000056", "legal_type": "Siege", "name": "CAPPTAIN", "activity": "Fournitures de prestations de services et de développements d'applications logicielles, développement et recherche de nouvelles technologies.", "formatted_address": "75008 Paris", "lng": 2.3522219, "lat": 48.856614 }] }


Recherche radar de sociétés   1 crédit/requête


Une recherche radar permet de rechercher des entreprises dans une zone définie. Ce service est une extension du service de recherche classique et supporte les mêmes paramètres (searchMode, minsales, withemail...)
Il renvoie une vue synthétique des sociétés (nom, activité, adresse formatée, géolocation).
Pour obtenir les informations détaillées de l'entreprise, utilisez ensuite le service de recherche par ID

https://societeinfo.com/app/rest/api/v1/radarsearch/companies/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètres obligatoires

  • key — Clé d'API. Elle vous identifie à des fins de gestion des quotas.
  • lat — Latitude de la recherche
  • lng — Longitude de la recherche
  • radius — Rayon de recherche en mètre (maximum 100km)
  • page (1 par défaut) — Numéro de la page de résultats
  • limit (10 par défaut) — Nombre de résultats par page. Limité à 25.

Paramètres facultatifs

Les mêmes paramètres facultatifs que la recherche par mots clés.

Exemple

{ "success": true, "total": 3, "currentPage": 1, "totalPages": 1, "result": [{ "id": "5701b2fcb3a2162b91e528c7", "registration_number": "818458119", "full_registration_number": "81845811900018", "legal_type": "Siege", "name": "CHEZ AUGUSTA", "activity": "Acquisition et gestion et exploitation de tout fonds de commerce de restauration, acquisition et gestion de toutes valeurs mobilières et la participation par tous moyens, dans toutes sociétés et entreprises, exécution de toutes prestations d'assistance administrative, comptable, financière.", "formatted_address": "75008 Paris", "lng": 2.3522219, "lat": 48.856614 }, { "id": "55f178f2b3a2d5ccd3f46d40", "registration_number": "811685957", "full_registration_number": "81168595700029", "legal_type": "Siege", "name": "VAP MARBEUF", "activity": "Création, exploitation, location, prise a bail de tous établissements ou fonds de commerce constitués par une activité de restauration et de vente à emporter sous l'enseigne va piano", "formatted_address": "75008 Paris", "lng": 2.305482, "lat": 48.869549 }, { "id": "5771b53eb3a24f44829779f8", "registration_number": "820642973", "full_registration_number": "82064297300011", "legal_type": "Siege", "name": "SDG MARIGNAN", "activity": "La création, l'achat, la vente, la prise à bail, la prise en location gérance, l'installation et l'exploitation de tous fonds de commerce de café, bar, brasserie, restaurant, salon de thé, vente à emporter, ainsi que tous autres établissements.", "formatted_address": "75008 Paris", "lng": 2.306589, "lat": 48.869097 }] }


Rechercher une société par SIREN/SIRET/ID   5 crédits/requête


Ce service permet d'obtenir les informations détaillées d'une société (données légales, chiffres clés, contacts, mails, sites webs, réseaux sociaux, marques déposées...)
Si le paramètre registration_number est le SIREN, la réponse est le siège
Si le paramètre registration_number est le SIRET, la réponse est l'établissement

https://societeinfo.com/app/rest/api/v1/company/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètre obligatoire

  • key — Clé d'API. Elle vous identifie à des fins de gestion des quotas.

Paramètre obligatoire (l'un ou l'autre)

  • registration_number — Numéro SIREN/SIRET de l'entreprise
  • id — id obtenu à partir d'une requête query search (plus rapide !)

Paramètres facultatifs

  • withEstablishments (false par défaut) - Ajoutez ce paramètre pour inclure les établissements du siège. Les valeurs possibles sont true ou false

Dans la réponse, les valeurs possibles des champs suivants sont :

  • legal_state Active, Closing, Dead
  • legal_type Siege, PrincipalEstablishment, SecondaryEstablishment, ComplementaryEstablishment, Affiliate
  • legal_person_type Natural, Physical
  • stats.type clotureDate, sales, salesCategory, profit, staff
  • risk.collective_procedures.collective_procedure_type Liquidation judiciaire, Redressement judiciaire, Procédure de sauvegarde
  • lastBodacc.bodacc_type "Immatriculations", "Créations d'établissements", "Vente d'établissements", "Modifications et mutations diverses", "Radiations", "Avis de dépôts des comptes des sociétés", "Jugement"
  • si lastBodacc.bodacc_type = "Avis de dépôts des comptes des sociétés" lastBodacc.balance_sheet_deposit_type "Comptes annuels et rapports","Comptes consolidés et rapports", "Comptes annuels et consolidés et rapports"

Exemple

{ "success": true, "result": { "id": "55f17734b3a2d5ccd3e9f937", "registration_number": "342376332", "full_registration_number": "34237633200082", "vat_number": "FR82342376332", "name": "ILIAD", "commercial_name": "FERMIC - ILIAD ENTREPRISE", "postal_address_additional_name": "ILIAD ENTREPRISE", "ape_code": "7010Z", "ape_label": "Activités des sièges sociaux", "rcs_name": "342376332 RCS Paris", "greffe_name": "Paris", "legal_person_type": "Natural", "legal_state": "Active", "legal_state_date": 1469656800000, "legal_type": "Siege", "legal_status": "Société anonyme", "creation_date": 561250800000, "activity": "Diffusion et édition de toutes informations et services opérations de holding", "street": "16 rue de la Ville L'Évêque", "postal_code": "75008", "city": "Paris", "country_code": "FR", "lng": 2.3522219, "lat": 48.856614, "emails": ["sympa@open.iliad.fr"], "website_url": "http://www.iliad.fr/", "website_urls": [], "capital": "12999215", "contacts": [{ "name": "DELOITTE & ASSOCIES", "role": "Commissaire aux comptes titulaire" }, { "name": "BEAS", "role": "Commissaire aux comptes suppléant" }], "oldContacts": [{ "name": "Brunel Franck Georges Pierre", "role": "Directeur général" }, { "name": "DELOITTE & ASSOCIES", "role": "Commissaire aux comptes titulaire" }, { "name": "BEAS", "role": "Commissaire aux comptes suppléant" }], "stats": [{ "type": "sales", "year": 2013, "value": "26562000" }, { "type": "sales", "year": 2011, "value": "27249000" }, { "type": "profit", "year": 2013, "value": "434233000" }, { "type": "profit", "year": 2011, "value": "329751000" }, { "type": "staff", "year": 2013, "value": "65" }, { "type": "salesCategory", "year": 2013, "value": "E + d 1M" }, { "type": "salesCategory", "year": 2011, "value": "E + d'1M" }, { "type": "sales", "year": 2014, "value": "120506000" }, { "type": "profit", "year": 2014, "value": "307980000" }, { "type": "staff", "year": 2014, "value": "103" }, { "type": "salesCategory", "year": 2014, "value": "E + d 1M" }, { "type": "clotureDate", "year": 2015, "value": "2015-12-31" }, { "type": "clotureDate", "year": 2014, "value": "2014-12-31" }, { "type": "clotureDate", "year": 2013, "value": "2013-12-31" }, { "type": "sales", "year": 2015, "value": "143070000" }, { "type": "profit", "year": 2015, "value": "334957000" }, { "type": "staff", "year": 2015, "value": "100" }, { "type": "staffCategory", "year": 2015, "value": "100 à 199 salariés" }], "marks_details": { "classes": [{ "number": "0", "description": "Communications.Agence de presse et d'informations.Communications radiophoniques, télégraphiques ou téléphoniques.Télescription.Transmission de messages, télégrammes.Services télématiques.Services divers.Hôtellerie, restauration.Maisons de repos et de convalescence.Pouponnières.Accompagnement en société.Agences matrimoniales.Salons de beauté, de coiffure.Pompes funèbres, fours crématoires.Réservation de chambres d'hôtel pour voyageurs.Travaux d'ingénieurs, consultations professionnelles et établissement de plans sans rapport avec la conduite des affaires.Travaux du génie (pas pour la construction).Prospection.Forages.Essais de matériaux.Laboratoires.Location de matériel pour exploitation agricole, de vêtements, de literie, d'appareils distributeurs.Imprimerie.Messagerie télématique.Services de boîtes à lettres télématiques. Services télématiques." }, { "number": "9", "description": " Appareils téléphoniques y compris fils, fibres et transmetteurs téléphoniques terminaux de télécommunication, appareils et postes téléphoniques notamment de caractère public ou personnel ou portatif ou à main libre ou à commande vocale ; récepteurs, émetteurs téléphoniques ; télécopieurs ; logiciels notamment logiciels pour le traitement de l'information, logiciels de création, de gestion, de mise a jour et d'utilisation de base de donnes, logiciels de fourniture d'accès à un service de messagerie électronique ; appareils de saisies de données, de sons et d'images ; ordinateurs notamment serveurs informatiques, terminaux informatiques, télématique et téléphoniques notamment pour les réseaux de communication mondiale (de type Internet) ; modems, connecteurs à un réseau informatique ou téléphonique, câbles électriques ou optiques base de données ; appareils émetteurs et récepteurs informatiques et de communication ; commutateurs téléphoniques, logiciels pour la fourniture d'accès à un réseau informatique ou de transmission de données notamment à un réseau de type communication mondiale (de type Internet)." }, { "number": "35", "description": " Publicité, gestion des affaires commerciales abonnement téléphonique, télématiques, à une base de données, à un serveur de bases de données, abonnement à un centre fournisseur d'accès à un réseau informatique ou de transmission de données notamment de communication mondiale (de type Internet) ; abonnement à des journaux électroniques, à un service de télécommunication. Gestion de fichiers informatiques." }, { "number": "38", "description": " Transmission d'informations par voie télématique, services téléphoniques, de télécommunication et de radiocommunication, de radiotéléphonie mobile, notamment services de transfert d'appels, de renvois d'appels, d'annuaires du téléphone, de messagerie vocale, transmission et diffusions de données, de sons et d'images, transmission et diffusions de données, de sons et d'images assistées par ordinateur notamment dans le cadre de réunions par téléphone et de visio-conférences, services de communication entre terminaux d'ordinateurs services d'accès à des bases de données et à des centres serveurs de base de données informatiques ou télématiques ; services de courrier électronique et de diffusion d'information par voie électronique notamment pour les réseaux de communication mondiale (de type Internet)." }, { "number": "41", "description": " Services de location d'appareils pour l'enregistrement, la transmission, la reproduction et le traitement de données, de sons et d'images agences de presse et d'informations. Télécommunication par tous moyens technologiques y compris par satellite ou par fibres optiques." }, { "number": "42", "description": " Location de temps d'accès à un centre serveur de bases de données notamment pour les réseaux de communication mondiale de type Internet, programmation pour ordinateurs." }], "marks": [{ "name": "SANDRA", "application_date": 545004000000 }, { "name": "GIGABOX", "application_date": 1160431200000 }, { "name": "OPTICBOX", "application_date": 1160431200000 }, { "name": "FIBERBOX", "application_date": 1160431200000 }, { "name": "CLUBA", "application_date": 558309600000 }, { "name": "ROSA", "application_date": 558309600000 }, { "name": "WWW BOURSE", "application_date": 815612400000 }, { "name": "BOURSE", "application_date": 816562800000 }, { "name": "ANNU", "application_date": 854578800000 }, { "name": "SALANGA", "application_date": 951951600000 }, { "name": "CIV", "application_date": 885942000000 }, { "name": "L'ANNUAIRE A L'ENVERS", "application_date": 886546800000 }, { "name": "WWW.DIR.COM", "application_date": 886633200000 }, { "name": "LA PAGE INVERSE", "application_date": 887324400000 }, { "name": "VL SHOW", "application_date": 890175600000 }, { "name": "RETROUVEZ UNE PERSONNE A PARTIR DE SON SIMPLE NOM SUR LA FRANCE ENTIERE TAPEZ 3617 ANNU", "application_date": 893368800000 }, { "name": "UN NUMERO DE TELEPHONE SANS NOM NI ADRESSE TAPEZ 3617 ANNU", "application_date": 893368800000 }, { "name": "RETROUVEZ UNE PERSONNE SUR LA FRANCE ENTIERE A PARTIR DE SON SIMPLE NUMERO DE TELEPHONE TAPEZ 3617 ANNU", "application_date": 893368800000 }, { "name": "EUROASIA", "application_date": 1049839200000 }, { "name": "INTER", "application_date": 901576800000 }, { "name": "AVANTI", "application_date": 907020000000 }, { "name": "VINCI", "application_date": 908748000000 }, { "name": "ILIAD", "application_date": 909615600000 }, { "name": "I-COMMERCE", "application_date": 913071600000 }, { "name": "DIR", "application_date": 913590000000 }, { "name": "ONE TO ONE", "application_date": 913762800000 }, { "name": "PROXAD", "application_date": 918774000000 }, { "name": "LINX TELECOM", "application_date": 921106800000 }, { "name": "Le National au prix du Local.", "application_date": 936914400000 }, { "name": "PROTELCO", "application_date": 1233615600000 }, { "name": "DOROTHY", "application_date": 719622000000 }] }, "lastBodacc": { "type": "Bodacc", "bodacc_type": "Modifications et mutations diverses", "parution_date": 1469656800000, "number": "1108", "rcs_name": "342376332 RCS Paris", "legal_name": "ILIAD", "legal_status": "Société anonyme", "capital": "12999215", "administration": "nomination de l'Administrateur : Vigreux, Corinne", "address": "16 rue de la Ville L'Évêque 75008 Paris", "description": "modification survenue sur l'administration" }, "risk": { "risk_level": 0.0, "collective_procedure_in_progress": false } } }

Si la société n'existe pas ou le siren invalide cette erreur est retournée :

{ "success":false, "errorType":"Functionnal", "errorCode":"API_COMPANY_NOT_FOUND", "errorMessage":"The company is not found" }


Rechercher une société par nom de domaine  10 crédits/requête


Recherchez toutes les sociétés liées au nom de domaine: Mentions légales du site web, Propriétaire du domaine...

https://societeinfo.com/app/rest/api/v1/domainsearch/companies/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètres obligatoires

  • key — Clé d'API. Elle vous identifie à des fins de gestion des quotas.
  • domain_name — Le domaine du site web ou une url à analyser

Paramètres facultatifs

  • withEstablishments (false par défaut) - Ajoutez ce paramètre pour inclure les établissements du siège. Les valeurs possibles sont true ou false

Dans la réponse, les valeurs possibles des champs suivants sont :

  • legal_state Active, Closing, Dead
  • legal_type Siege, PrincipalEstablishment, SecondaryEstablishment, ComplementaryEstablishment, Affiliate
  • legal_person_type Natural, Physical
  • stats.type clotureDate, sales, salesCategory, profit, staff
  • risk.collective_procedures.collective_procedure_type Liquidation judiciaire, Redressement judiciaire, Procédure de sauvegarde
  • lastBodacc.bodacc_type "Immatriculations", "Créations d'établissements", "Vente d'établissements", "Modifications et mutations diverses", "Radiations", "Avis de dépôts des comptes des sociétés", "Jugement"
  • si lastBodacc.bodacc_type = "Avis de dépôts des comptes des sociétés" lastBodacc.balance_sheet_deposit_type "Comptes annuels et rapports","Comptes consolidés et rapports", "Comptes annuels et consolidés et rapports"

Exemple

{ "success": true, "total": 1, "result": [{ "id": "5944b106b3a2f5ecd3658211", "match_type": "WebSiteLegalNoticeOwnerMatch", "registration_number": "830134383", "full_registration_number": "83013438300017", "vat_number": "FR38830134383", "name": "SMART DATA", "ape_code": "6201Z", "ape_label": "Programmation informatique", "rcs_name": "830134383 RCS Nanterre", "greffe_name": "Nanterre", "legal_person_type": "Natural", "legal_state": "Active", "legal_state_date": 1496613600000, "legal_type": "Siege", "legal_status": "Société par actions simplifiée", "creation_date": 1496613600000, "activity": "la société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet.", "street": "176 avenue Charles de Gaulle", "postal_code": "92200", "city": "Neuilly-sur-Seine", "country_code": "FR", "emails": ["contact@societeinfo.com"], "website_url": "http://www.societeinfo.com/", "website_urls": [], "twitter_url": "https://twitter.com/@SocieteInfo", "twitter_urls": [], "phone_numbers": [], "capital": "5000", "contacts": [{ "name": "ONNEN Antoine ", "role": "Président" }, { "name": "CONRAUD Alexandre", "role": "Directeur général" }], "stats": [{ "type": "staffCategory", "year": 2017, "value": "0 salarié" }], "lastBodacc": { "type": "Bodacc", "bodacc_type": "Créations d'établissements", "parution_date": 1497564000000, "number": "1448", "rcs_name": "830134383 RCS Nanterre", "legal_name": "SMART DATA", "legal_status": "Société par actions simplifiée", "capital": "5000 EUR", "administration": "Président : ONNEN Antoine ; Directeur général : CONRAUD Alexandre", "address": "176 avenue Charles de Gaulle 92200 Neuilly-sur-Seine", "establishments": [{ "quality": "Etablissement principal", "activity": "la société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet.", "funds_origin": "Création d'un fonds de commerce" }], "start_date": 1496613600000 }, "risk": { "risk_level": 0.0, "collective_procedure_in_progress": false, "collective_procedures": [] } }], "webSiteInfo": { "website_url": "http://www.societeinfo.com/", "description": "Societeinfo est un moteur de recherche B2B intégrant plus de 9 millions d'entreprises, des millions d'emails et numéros de téléphones. Dopez votre prospection commerciale, générez des leads ou enrichissez vos données !", "twitter_url": "https://twitter.com/@societeinfo" } }

Si la société n'est pas matchée :

{ "success": false, "errorType": "Functionnal", "errorCode": "API_COMPANY_NOT_FOUND", "errorMessage": "The company is not found", "result": [], "webSiteInfo": { "website_url": "http://www.lespepitestech.com/", "description": "Les Pepites Tech, les produits et services des startups de la French Tech, tous les jours. Le product hunt de la French Tech.", "facebook_url": "https://www.facebook.com/lespepitestech", "twitter_url": "https://twitter.com/lespepitestech" } }


Rechercher les annonces BODACC par SIREN/ID   5 crédits/requête


Obtenez l'ensemble des annonces légales du bodacc

https://societeinfo.com/app/rest/api/v1/bodacc/output?parameters

output peut prendre l'une des valeurs suivantes :

  • json (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Paramètre obligatoire

  • key — Clé d'API. Elle vous identifie à des fins de gestion des quotas.

Paramètre obligatoire (l'un ou l'autre)

  • registration_number — Numéro SIREN de l'entreprise
  • id — id obtenu à partir d'une requête query search (plus rapide)

Dans la réponse, les valeurs possibles des champs suivants sont :

  • bodacc_type "Immatriculations", "Créations d'établissements", "Vente d'établissements", "Modifications et mutations diverses", "Radiations", "Avis de dépôts des comptes des sociétés", "Jugement"
  • si bodacc_type = "Avis de dépôts des comptes des sociétés" balance_sheet_deposit_type "Comptes annuels et rapports","Comptes consolidés et rapports", "Comptes annuels et consolidés et rapports"

Exemple

{ "success": true, "result": [{ "type": "Bodacc", "bodacc_type": "Créations d'établissements", "parution_date": 1497564000000, "number": "1448", "rcs_name": "830134383 RCS Nanterre", "legal_name": "SMART DATA", "legal_status": "Société par actions simplifiée", "capital": "5000 EUR", "administration": "Président : ONNEN Antoine ; Directeur général : CONRAUD Alexandre", "address": "176 avenue Charles de Gaulle 92200 Neuilly-sur-Seine", "establishments": [{ "quality": "Etablissement principal", "activity": "la société a pour objet en France et à l'étranger: l'édition, le développement et la commercialisation de logiciels informatiques, bases de données et autres applications internet.", "funds_origin": "Création d'un fonds de commerce" }], "start_date": 1496613600000 }] }

Si la société n'existe pas ou le siren invalide cette erreur est retournée :

{ "success":false, "errorType":"Functionnal", "errorCode":"API_COMPANY_NOT_FOUND", "errorMessage":"The company is not found" }