Informations générales
Données de référence d'une entité
/entreprises
Obtenir des informations concernant une entité du répertoire Sirene telles que les dates de création et de fin ; le code effectif, le numéro de TVA intracommunautaire ; la forme juridique… ou encore les mandataires sociaux et l’état administratif de l’entreprise.
- Périmètre
- Entreprises, entrepreneurs individuels, institutions administratives et certaines associations.
- Ouverture
- Données publiques et protégées pour les non-diffusibles.
Une erreur est repérée dans la base de données Sirene par vous ou vos utilisateurs ? Comment la signaler ?
Lors de la mise à disposition des données de l’endpoint entreprises
dans votre service, une erreur dans la base de données Sirene est repérée.
L’INSEE a mis en place une procédure pour vous permettre de signaler cette inexactitude. Elle met à disposition un formulaire de contact permettant aux utilisateurs de leur adresser une demande de modification d’information.
💡Notamment si vous utilisez cet endpoint pour du pré-remplissage, il peut être utile d’indiquer ce lien https://www.sirene.fr/sirene/public/nous-contacter à vos utilisateurs. Cela leur permettra de demander une rectification directement.
Périmètre
-
L’endpoint
entreprises
vous donne accès :- aux données tirées du Répertoire National d’identification des entreprises et des établissements, géré par l’INSEE au travers du système Sirene ;
- ainsi qu’aux observations d’Infogreffe, quand elles sont disponibles pour le SIREN appelé.
⚠️ Cet endpoint ne concerne pas les établissements, ceux-ci sont appelables avec l’endpoint
etablissement_insee
.Lire la suite
Cet endpoint permet donc d’accéder aux informations de référence concernant :
- ✅ les personnes morales de droit privé : les entreprises.
ℹ️ Toutes les entreprises immatriculées au Registre du Commerce et des Sociétés et au Répertoire des Métiers figurent dans la base Sirene ; - ✅ les personnes morales de droit public : les institutions et services de l’État et les collectivités territoriales ;
- ✅ les entrepreneurs individuels exerçant de manière indépendante une profession non salariée (exemple : un commerçant, un médecin), ayant fait une déclaration d’activité.
❌ Les particuliers employeurs ne font pas partie de la base Sirene ; -
✅ les associations ayant, en plus de leur numéro RNA, un numéro de SIREN/SIRET délivré lorsqu’elles :
- emploient du personnel salarié ;
- sont soumises à la TVA ;
- ont demandé ou bénéficient de transferts financiers publics.
- ✅ Les organismes publics ou privés et les entreprises étrangères qui ont une représentation ou une activité en France.
Périmètre géographique :
La base Sirene concerne les unités implantées en métropole, dans les DOM et dans les collectivités d’Outre-Mer de Saint Pierre et Miquelon, Saint Barthélémy et Saint Martin.
⚠️ Pour la Nouvelle-Calédonie, la Polynésie française, et Wallis-et-Futuna, seul le secteur public administratif, de l’État ou des communes est répertorié ; ❌ les entreprises ne sont donc pas disponibles.Fraicheur de la donnée :
La mise a jour des données est faite quotidiennement entre 0h et 3h à l’INSEE.Pour en savoir plus :
Contexte juridique du Répertoire National d’identification des entreprises et des établissements </details>
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de la personne physique ou morale recherchée.
- Options d’appel à ajouter (voir requête HTTP ↓) :
-
- Une option d'appel vous permet de connaître l'état administratif de l'entreprise, à savoir si l'entreprise est active ou cessée ;
- Une autre vous donne accès aux données des entreprises dîtes non-diffusibles, cette option nécessite une autorisation spécifique, accordée ou non par API Entreprise selon votre cas d'usage.
Qu'est-ce que l'état administratif d'une entreprise ?
Comment y accéder avec API Entreprise ?
L’état administratif d’une entreprise
L’état administratif indique si une entreprise est active (A) ou cessée (C). C’est son état juridique.
L’entreprise est considérée comme juridiquement cessée pour les personnes morales si :
- il y a eu dépôt de la déclaration de disparition de la personne morale ;
- elle a été inscrite sans activité à sa demande. Dans le cas d’une création au répertoire Sirene mais sans avoir encore démarré une activité (activité principale provisoire “0000Z”) ;
- elle n’a plus d’établissement en activité.
L’entreprise est considérée comme juridiquement cessée pour les personnes physiques si :
- l’exploitant de l’entreprise décède ;
- l’exploitant dépose une cessation d’activité.
En dehors de ces cas, l’état administratif de l’entreprise est toujours actif.
ℹ️ Pour les personnes physiques, dans le cas où l’exploitant déclare la cessation de son activité, puis la reprend quelque temps plus tard, cet état est réversible. Il est donc normal d’avoir des périodes successives d’état actif puis cessé pour les personnes physiques. Pour les personnes morales, l’état administratif est en théorie irréversible.
Comment connaître l’état administratif de l’entité demandée ?
Il vous faudra ajouter l’option d’appel with_etat_administratif
, deux champs seront alors disponibles dans la réponse JSON, vous indiquant l’état de l’entité et la date de cessation si tel est le cas.
⚠️ Comment utiliser les données protégées
des entreprises non diffusibles ?
Qu’est-ce qu’un non diffusible ?
Parmi les entités présentes dans le répertoire Sirene, certaines, très majoritairement des personnes physiques, ont explicitement demandé de ne pas figurer en diffusion commerciale, en vertu de l’article A123-96 du Code du Commerce. Cela signifie qu’elles donnent accord de la diffusion de leur données uniquement à des organismes habilités et à des administrations. De fait, leurs données ne sont pas publiques.
ℹ️ Les unités de la Défense Nationale font également partie des non-diffusibles mais ne sont accessibles que sur autorisation du Ministère de la Défense, conformément à l’article A 123-95 du Code du commerce.
Comment utiliser les données des non diffusibles ?
En utilisant l’endpoint entreprises
, vous vous engagez à tenir compte du statut de diffusion le plus récent de l’entité appelée. Dans le cas, où vous utilisez l’endpoint avec l’option d’appel non_diffusables
, et que le champ diffusable_commercialement
de la réponse JSON affiche =false,
cela signifie que l’entreprise est non diffusible et que vous vous engagez à n’utiliser ces informations que dans le cadre strict de vos missions de service public, à ne pas les rediffuser ni les divulguer auprès de tiers non autorisés.
⚠️ Vous ne pouvez pas en faire usage pour du pré-remplissage. Il vous est par contre possible d’indiquer aux entreprises qu’elles peuvent modifier leur statut, même provisoirement, auprès de l’INSEE à l’adresse suivante : https://statut-diffusion-sirene.insee.fr.
Comment accéder aux données des non-diffusibles avec l’API Entreprise ?
Vous pouvez accéder aux entreprises non-diffusibles en ajoutant le paramètre non_diffusables=true
. Un champ supplémentaire apparaît alors diffusable_commercialement
indiquant si l’entreprise est diffusée ou non.
⚠️ Sans l’utilisation de cette option d’appel, si l’entreprise fait partie des non-diffusibles, l’API vous renverra un code HTTP 451
, même si votre token comporte les droits d’accès.
Cas particulier d’unités présentes dans la base Sirene mais non disponibles
Certaines unités ont été immatriculées pour les seuls besoins d’administrations (les impôts, les URSSAF, la DGCP …). Leur diffusion à d’autres administrations n’est pas prévue. Il s’agit :
- des unités de gestion de paye de la fonction publique ;
- des unités provisoires (c’est à dire des entreprises ayant obtenu un numéro SIREN provisoire au gichet du Centre de Formalités des Entreprises (CFE) au moment de leur déclaration ; numéro qui sera par la suite confirmé, à la réception de la déclaration de création, et fera entrer ces entreprises dans le Répertoire.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
entreprises/SirenDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDeL’appel
&object=RaisonDeL’AppelOuIdentifiant
Pour connaître l'état administratif de l’entreprise,
ajouter le paramètre facultatif suivant :
&with_etat_administratif=true
Pour accéder aux entreprises nondiffusibles :
&non_diffusables=true
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse JSON est composée de trois ensembles distincts :
- la partie entreprise, qui contient les données génériques, les mandataires sociaux et l’état administratif de la personne physique ou morale ;
- la partie établissement siège, qui contient les données du siège social, celles-ci étant disponibles également par l’endpoint
etablissements
; - la clé gateway error, indiquant si un fournisseur de données n’a pas fonctionné.
Qu'est qu'un numéro de TVA intracommunautaire ?
Comment est-il calculé ?
Qu’est-ce que c’est ?
Le numéro de TVA intracommunautaire est un numéro d’identification individuel attribué aux entreprises assujetties à la TVA et domiciliées au sein de l’Union européenne. En France, il est constitué du code FR et de 11 chiffres (une clé informatique de 2 chiffres, et le numéro de SIREN à 9 chiffres de l’entreprise.)
Comment est-il calculé par API Entreprise ?
Le numéro de TVA intracommunautaire est calculé par API Entreprise selon la règle officielle. Cette donnée est théorique.
Dans le cas où l’établissement siège est à l’étranger la valeur est systématiquement mise à nul. En effet, dans ce cas le numéro de TVA est probablement calculé par le pays où se situe l’établissement siège et non par la France. La seule source fiable dans ce cas est l’entreprise elle-même.
Quelle type d'adresse est fournie par API Entreprise ?
Depuis 2018, l’INSEE ne fournit plus d’adresse au format RNVP, API Entreprise opère donc une reconstruction de l’adresse à partir des champs disponibles dans leur nouvelle API. Cette reconstruction n’est en aucun cas un traitement RNVP. Des différences minimes résultant de l’arrêt du RNVP peuvent être constatées. Le détail de chaque champ est indiqué en commentaire dans la réponse JSON ci-dessous ⬇️.
Une entreprise est active mais tous ses établissements sont fermés, est-ce un bug ?
Même si tous les établissements d’une entreprise sont fermés (y compris son établissement siège), une entreprise reste active tant que la cessation juridique n’a pas été prononcée. Une réactivation est même encore possible. Le SIREN continue donc d’avoir un statut actif au répertoire.
Par conséquent, dans la réponse JSON, le cas de figure suivant n’est pas un bug :
- Tous les établissements (ainsi que le siège) ont leur
etat_administratif
=F
; - et l’entreprise a son
etat_administratif
=A
(et nonC
si elle était réellement fermée).
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Données de référence d'un établissement
/etablissements
Obtenir des informations générales, géographiques et juridiques concernant un établissement du répertoire Sirene telles que les dates de création et de fin, l’adresse ou l’état administratif.
- Périmètre
- Établissements d’entreprises, d'entrepreneurs individuels, d'institutions administratives et de certaines associations.
- Ouverture
- Données publiques et protégées pour les non-diffusibles.
Une erreur est repérée dans la base de données Sirene par vous ou vos utilisateurs ? Comment la signaler ?
Lors de la mise à disposition des données de l’endpoint etablissements
dans votre service, une erreur dans la base de données Sirene est repérée.
L’INSEE a mis en place une procédure pour vous permettre de signaler cette inexactitude. Elle met à disposition un formulaire de contact permettant aux utilisateurs de leur adresser une demande de modification d’information.
💡Notamment si vous utilisez cet endpoint pour du pré-remplissage, il peut être utile d’indiquer ce lien https://www.sirene.fr/sirene/public/nous-contacter à vos utilisateurs. Cela leur permettra de demander une rectification directement.
Périmètre
-
L’endpoint
etablissements
vous donne accès aux données des établissements tirées du Répertoire National d’identification des entreprises et des établissements (SIRENE), géré par l’INSEE au travers du système Sirene.⚠️ Cet endpoint concerne uniquement les établissements, voir l’endpoint
entreprises
pour les données relatives aux sociétés.Lire la suite
Cet endpoint permet donc d’accéder aux informations de référence concernant les établissements :
- ✅ des personnes morales de droit privé.
ℹ️ Toutes les entreprises immatriculées au Registre du Commerce et des Sociétés et au Répertoire des Métiers figurent dans la base Sirene ; - ✅ des personnes morales de droit public : les institutions et services de l’État et les collectivités territoriales ;
-
✅ des associations ayant, en plus de leur numéro RNA, un numéro de SIREN/SIRET délivré lorsqu’elles :
- emploient du personnel salarié ;
- sont soumises à la TVA ;
- ont demandé ou bénéficient de transferts financiers publics.
- ✅ des organismes publics ou privés et les entreprises étrangères qui ont une représentation ou une activité en France.
Périmètre géographique : La base Sirene concerne les unités implantées en métropole, dans les DOM et dans les collectivités d’Outre-Mer de Saint Pierre et Miquelon, Saint Barthélémy et Saint Martin.
⚠️ Pour la Nouvelle-Calédonie, la Polynésie française, et Wallis-et-Futuna, seul le secteur public administratif, de l’État ou des communes est répertorié ; ❌ les entreprises ne sont donc pas répertoriéesFraicheur de la donnée :
La mise a jour des données est faite quotidiennement entre 0h et 3h à l’INSEE.Pour en savoir plus :
Contexte juridique du Répertoire National d’identification des entreprises et des établissements </details> - ✅ des personnes morales de droit privé.
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l’établissement.
- Options d’appel à ajouter (voir requête HTTP ↓) :
-
- Une option d'appel vous permet d'accéder aux données des établissements dîts non-diffusibles, cette option nécessite une autorisation spécifique, accordée ou non par API Entreprise selon votre cas d'usage.
⚠️ Comment utiliser les données protégées des établissements non diffusibles ?
Qu’est-ce qu’un établissement non diffusible ?
Parmi les entités présentes dans le Répertoires Sirene, certaines, très majoritairement des personnes physiques, ont explicitement demandé de ne pas figurer en diffusion commerciale, en vertu de l’article A123-96 du Code du Commerce. Cela signifie qu’elles donnent accord de la diffusion de leur données et des données de leurs établissements uniquement à des organismes habilités et à des administrations. De fait, ces données ne sont pas publiques.
ℹ️ Les établissements de la Défense Nationale font également partie des non-diffusibles mais ne sont accessibles que sur autorisation du Ministère de la Défense, conformément à l’article A 123-95 du Code du commerce.
Comment utiliser les données des non diffusibles ?
En utilisant l’endpoint etablissements
, vous vous engagez à tenir compte du statut de diffusion le plus récent de l’entité appelée. Dans le cas où vous utilisez l’endpoint avec l’option d’appel non_diffusables
, et que le champ diffusable_commercialement
de la réponse JSON affiche =false,
cela signifie que l’entreprise est non diffusible et que vous vous engagez à n’utiliser les informations de leur établissement que dans le cadre strict de vos missions de service public, à ne pas les rediffuser ni les divulguer auprès de tiers non autorisés.
⚠️ Vous ne pouvez pas donc pas faire usage de ces données pour du pré-remplissage. Il vous est par contre possible d’indiquer aux entreprises qu’elles peuvent modifier leur statut, même provisoirement, auprès de l’INSEE à l’adresse suivante : https://statut-diffusion-sirene.insee.fr.
Comment accéder aux données des non-diffusibles avec l’API Entreprise ?
Vous pouvez accéder aux entreprises non diffusées en ajoutant le paramètre non_diffusables=true
. Un champ supplémentaire apparaît alors diffusable_commercialement
indiquant si l’entreprise est diffusée ou non.
⚠️ Sans l’utilisation de cette option d’appel, si l’entreprise fait partie des non-diffusibles, l’API vous renverra un code HTTP 403, même si votre token comporte les droits d’accès.
Cas particulier d’unités présentes dans la base Sirene mais non disponibles
Les établissements de gestion de paye de la fonction publique ont été immatriculés pour les seuls besoins de certaines administrations (les impôts, les URSSAF, la DGCP …). Leur diffusion à d’autres administrations n’est donc pas prévue.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
etablissements/SiretDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDeL’appel
&object=RaisonDeL’AppelOuIdentifiant
Pour accéder aux entreprises non-diffusibles :
&non_diffusables=true
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse JSON se décompose en trois catégories d’informations :
- les données générales sur l’établissement, telles que la date de création, le nombre de salariés et la tranche effectif, l’activité principale ou encore le statut siège social si l’établissement est concerné.
- les données géographiques : la commune, la région et le pays d’implantation ; ainsi que l’adresse précise reconstruite par API Entreprise.
- une donnée juridique : l’état administratif de l’établissement et la date de fermeture le cas échéant.
Qu'est-ce que l'état administratif d'un établissement ?
L’état administratif d’un établissement a deux modalités : actif (A) ou fermé (F). Lors de son inscription au répertoire, un établissement est, sauf exception, à l’état “ouvert” (A). Le passage à l’état “fermé” découle de la prise en compte d’une déclaration de fermeture.
ℹ️ Un établissement fermé peut être rouvert.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Extrait RCS
/extraits_rcs_infogreffe
Obtenir un extrait des données présentes dans le RCS, registre du commerce et des sociétés ; dont les observations qui permettent de savoir si une entreprise est en redressement judiciaire.
- Périmètre
- Toutes les entreprises présentes dans le RCS.
- Ouverture
- Données publiques.
Périmètre
-
Toutes les entreprises présentes au registre du commerce et des sociétés.
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de l’entreprise.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
extraits_rcs_infogreffe/SirenDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDeL’appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Données structurées JSON
- Timeout :
- 5 secondes
La réponse se compose :
- d’un extrait des données présentes dans le registre du commerce et des sociétés pour un numéro de siren donné. ⚠️ Il ne s’agit donc pas de la totalité des données présentes sur le Kbis mais d’une partie succincte.
- de tous les commentaires laissés par les greffiers. Ces observations concernent entre autres les changements de capital, les transferts de siège, les fusions, les redressements et liquidations judiciaires (si la donnée est publique).
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Informations déclaratives d’une association
/associations
Obtenir les informations déclarées par une association à la préfecture et issues du Répertoire National des Associations (RNA), telles que la date de création, l’adresse du siège et les dirigeants.
- Périmètre
- Toutes les associations.
- Ouverture
- Données publiques.
Périmètre
-
Toutes les associations inscrites au Répertoire National des Associations.
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l’association ou le numéro RNA.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
associations/SIRETdeL’AssociationOuNuméroRNA
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDeL’appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse se compose :
- d’un groupe d’informations générales sur l’association, dont notamment les dates de création/dissolution et l’adresse du siège ;
- des informations sur les dirigeants.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Divers documents d'une association
/documents_associations
Obtenir divers documents, différents selon l’association ; tels que les statuts, la liste des personnes habilitées à représenter l’association ou encore les délibérations pour modification ou dissolution de l’association.
- Cas d’usage
- Périmètre
- Toutes les associations ayant des documents.
- Ouverture
- Données publiques.
Périmètre
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l'association ou son numéro RNA.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
documents_associations/SiretDel’AssociationOuNuméroRNA
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Documents PDF
- Timeout :
- 12 secondes
La réponse JSON indique le nombre de documents à télécharger, l’URL d’accès, le type et la date du/des documents.
Voici différents exemples de documents PDF possiblement renvoyés par cet endpoint.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 50 requêtes/min/jeton cumulées sur tous les endpoints envoyant des documents.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Actes
/actes_inpi
Obtenir les actes d’une entreprise tels que connus par les greffes et archivés à l’Institut National de Propriété Industrielle (INPI). Ces actes comportent des informations générales, desinformations sur le capital social et sa répartition, ou encore des informations sur les associés et tout ce qui est relatif à l’administration de la société.
- Cas d’usage
- Périmètre
- Actes et statuts des personnes morales et physiques depuis 1993.
- Ouverture
- Données publiques.
Périmètre
-
Tous les actes établis par les greffes depuis 1993 sont transmis par cet endpoint. Ce qui représente environ 25 millions d’actes. Théoriquement, les actes sont transmis à l’INPI par le greffe dans un délai de 24h.
ℹ️ Il se peut que certains actes soient manquants, dans ce cas, vous pouvez nous envoyer un mail avec le numéro de SIRET concerné. L’INPI peut essayer de numériser le document manquant.
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de la personne physique ou morale recherchée.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
actes_inpi/SirenDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Archive ZIP contenant PDF et XML
- Timeout :
- 12 secondes
La réponse se compose :
- d’une URL permettant de télécharger une archive ZIP contenant l’ensemble des actes de l’entité appelée ;
- de la liste des actes, accompagnés de leurs informations génériques (identifiant du fichier dans l’archive téléchargée, le code greffe, les dates de dépôt et la nature de l’archive.)
L’archive ZIP fournie permet d’accéder à :
- tous les actes au format PDF (Voici différents exemples de documents PDF possiblement renvoyés par cet endpoint);
- toutes les métadonnées de chaque acte, au format XML, portant le même nom que le PDF associé ;
- un fichier
Response.json
permettant de retrouver le PDF dans l’archive à partir de l’id_fichier
de l’acte indiqué dans la liste JSON des bilans.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 5 requêtes/min. par jeton.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Conventions collectives
/conventions_collectives
Connaître les conventions collectives d’un établissement et obtenir des informations telles que l’identifiant de la convention et le lien vers le texte en vigueur.
- Cas d’usage
- Périmètre
- Tous les établissements ayant au moins une convention et déclaré des salariés.
- Ouverture
- Données publiques.
Périmètre
-
Les liens entre les établissements et les conventions collectives sont issues de la DSN, Déclaration Sociale Nominative, et le périmètre est donc restreint aux ✅ établissements ayant déclaré des salariés et ayant une convention.
❌ Les sociétés unipersonnelles dont le gérant est assimilé salarié ne ressortent au travers de l’API, même si la société en question est rattachée à une convention collective.
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l'établissement
Des données issues de plusieurs sources, une fréquence de mise à jour non précisée.
Cette API est fournie par la fabrique numérique des ministères sociaux qui s’appuie sur plusieurs sources de données :
- les données d’affiliation des établissements d’entreprise aux conventions sont issues de la DARES, direction d’études et statistiques du Ministère du Travail, publiées sur sur data.gouv.fr ;
- Les informations relatives aux conventions collectives (numéro identifiant, titre, lien vers le texte légal, …) sont issues de la base KALI diffusée par la DILA, Direction de l’information légale et administrative.
⚠️ La fréquence de mise à jour du fichier fournie par la DARES n’est pas précisée.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
conventions_collectives/SiretDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse se compose des différentes conventions de l’établissement, listées les unes après les autres, dans le cas où l’établissement en a plusieurs. Les caractéristiques suivantes sont données :
- le titre et le titre court de la convention ;
- l’état en vigueur étendu ou non de la convention ;
- son identifiant IDCC, numéro à 4 chiffres ;
- l’URL Légifrance du texte en vigueur.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Données de référence d'une entreprise artisanale
/entreprises_artisanales_cma
Obtenir des informations concernant une entité du Répertoire National des Métiers (RNM), telles que des données générales et juridiques, le type d’activité, des données sur les dirigeants, les dates clés de l’entreprise et son adresse. Ces données sont fournies par la Chambre des Métiers et de l’Artisanat France (CMA France) et sont également disponibles en API publique et libre d’accès sur api.gouv.fr.
- Périmètre
- Entreprises enregistrées au RNM.
- Ouverture
- Données publiques.
Périmètre
-
Cet endpoint couvre toutes les entreprises enregistrées au Répertoire National des Métiers.
Sont obligatoirement immatriculées au répertoire des métiers :-
✅ les entreprises individuelles et les sociétés qui n’emploient pas plus de dix salariés et exercent à titre principal ou secondaire une activité artisanale de production, de transformation, de réparation ou de prestation de service figurant en annexe du décret du 2 avril 1998.
-
✅ Les personnes qui exercent l’activité de fabrication de plats à consommer sur place peuvent également être immatriculées au répertoire des métiers.
Peuvent être immatriculées au RNM :
- ✅ les entreprises qui dépassent le seuil de dix salariés si leur dirigeant peut se prévaloir de la qualité d’artisan, d’artisan d’art ou de maitre artisan.
-
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de l'établissement
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
entreprises_artisanales_cma/SirenDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse se compose d’une clé ‘entreprise’ regroupant :
- des informations générales et juridiques (nom de l’entreprise, personne physique/morale, forme juridique, effectif, l’origine du fond de commerce, activité permanente/saisonnière, activité ambulante, code du centre de formalité des entreprises (CFE) ayant fait l’inscription et les déclarations, s’il y en a, relatives à un redressement judiciaire ou une liquidation.)
- le type d’activité de l’entreprise (code NAFA et secteur d’activité (NAR)) ;
- des informations géographiques, notamment l’adresse ;
- des informations sur les dirigeants ;
- les dates clés (immatriculation, radiation, début d’activité …)
- des informations en cas de double immatriculation ;
- des informations spécifiques au RNM (identifiants, dates d’import et date de mise à jour des données) ;
Quelle est la fraîcheur de la donnée renvoyée ?
Du côté de l’entreprise
Parmi les événements qui surviennent dans la vie d’une entreprise artisanale, certains d’entre eux doivent être obligatoirement déclarés par l’entreprise à sa chambre de commerce et d’artisanat, c’est à dire son centre de formalité des entreprises. Généralement, étant donné que toute modification du répertoire implique des coûts, l’entreprise met à jour l’ensemble de ses données. Voici la liste des évènements qui impliquent obligatoirement une déclaration : Changement d’adresse, changement de nom commercial, changement d’enseigne, modification d’activité(s) de l’entreprise, mise en location gérance, mention de conjoint collaborateur, ouverture ou fermeture d’un établissement, changement de la forme juridique, changement de dirigeant, dissolution de la société, cessation temporaire ou totale d’activité et régularisation d’immatriculation pour les micro-entrepreneurs.
Il est à noter que l’entrepreneur n’a pas d’obligation légale à déclarer un changement d’effectif. De fait, l’actualisation de cette donnée dépend donc du bon vouloir de l’entrepreneur à revérifier tous les champs du formulaire au moment de sa déclaration d’un événement dit obligatoire.
Du côté de la réponse JSON
La fraîcheur des données communiquées par cet endpoint correspond à la date de mise à jour faite dans le RNM suite aux nouvelles informations déclarées par l’entrepreneur. Cette date est indiquée par la clé rnm_date_mise_a_jour
dans la réponse JSON. Dans le cas où il n’y a pas encore eu de changement répertorié, la date d’import rnm_date_import
fait alors référence.
⚠️ La fraicheur des données d’effectifs effectif_salarie
et effectif_apprenti
est à prendre avec vigilance puisque leur mise à jour n’est pas obligatoire.
Qu'est ce que les codes NAFA, NAR 4 et NAR 20 ?
Le code NAFA
Le code NAFA est un identifiant permettant de naviguer dans la Nomenclature d’Activités Françaises de l’Artisanat qui décrit les activités artisanales. Il est composé de six caractères, quatre chiffres et deux lettres. Les cinq premiers caractères sont ceux de l’Activité Principale de l’Entreprise (APE) et correspondent au code NAF. La lettre située en sixième position permet de préciser le contenu du poste NAFA par rapport à la classe NAF.
Pour en savoir plus :
La page dédiée du Ministère de l’économie, des finances et de la relance détaille les lois ayant défini cette nomenclature. Vous y trouverez également plus d’informations sur le lien entre code NAF et NAFA.
CMA France propose un registre de la nomenclature, qui donne un descriptif précis de chaque activité.
Les codes NAR 4 et 20
Les codes NAR sont issus des Nomenclatures Artisanales Regroupées. Ils permettent de connaître le secteur d’activité de l’entreprise artisanale. Le numéro associé correspond au degré de précision en nombre de secteurs. La NAR 4 comprend quatre secteurs d’activités, qui regroupent les vingt secteurs plus précis de la NAR 20.
Pour en savoir plus :
Le site de CMA France tient un registre de tous les codes NAFA, accompagné des codes NAR 4 et 20, et même des code NAR 8 et 80.
Une liste (non-officielle) est consultable.
Quelles sont les subtilités des différents noms envoyés ?
La réponse JSON vous délivre plusieurs noms et prénoms du dirigeants. Voici l’explication détaillée de trois clés qui peuvent poser question.
Le nom de naissance
La clé dirigeant_nom_de_naissance
délivre le nom de famille donné à la personne le jour de la déclaration de sa naissance. Ce peut être soit le nom du père, soit le nom de la mère, soit leurs deux noms accolés dans l’ordre choisi par eux dans la limite d’un nom de famille pour chacun d’eux (Article 311-21 du code civil). C’est aussi le nom qui figure au registre de l’état civil. Cette législation est récente et a pris effet au 1er septembre 2003. Ce nom peut être différent du nom de famille (qui n’est pas donné par l’API) dans le cas où la personne à demander un changement de nom.
Le nom d’usage
La clé dirigeant_nom_usage
indique le nom que la personne a choisi d’utiliser dans la vie quotidienne. Toutefois, ne sont autorisées que trois formes de noms d’usage : - un double nom composé du nom de famille de la personne et du nom du parent qui n’a pas transmis son nom à la naissance. - un double nom composé du nom de famille de la personne et du nom de la personne avec qui elle est mariée. - le nom de la personne avec qui la personne est mariée, ce nom peut alors aussi être dénommé “nom marital”.
Le nom d’usage ne figure ni à l’état civil ni sur le livret de famille ; il peut figurer sur la carte d’identité ou le passeport. Les administrations se doivent de l’utiliser si cela est demandé par la personne.
Le pseudonyme
La clé dirigeant_pseudonyme
indique le nom d’emprunt utilisé dans l’exercice de son activité par le dirigeant pour se désigner, généralement littéraire ou artistique. Le pseudonyme ne correspond pas à un changement de nom, et son choix doit remplir certaines conditions. Il ne doit pas porter atteinte à l’ordre public et il ne doit pas permettre à la personne de s’approprier la renommée ou la parenté d’une personne tiers. Le pseudonyme peut être protégé en étant déposé sous la forme d’une marque à l’INPI.
Quelles sont les différents types de déclarations renvoyées ?
La clé declaration_procedures
permet d’obtenir différents types de déclarations :
- les déclarations de cessation des paiements et les décisions intervenues dans les procédures de règlement judiciaire et de liquidation des biens en application de la loi n° 67-563 du 13 juillet 1967 ;
- les déclarations intervenues dans les procédures ouvertes en application de l’ordonnance n° 67-820 du 23 septembre 1967 tendant à faciliter le redressement économique et financier ;
- les déclarations de cessation des paiements et les décisions suivantes intervenues dans les procédures de redressement ou de liquidation judiciaires des entreprises ouvertes avant le 1er janvier 2006 en application du code de commerce ;
- les déclarations intervenues dans les procédures de sauvegarde, de redressement judiciaire ou de liquidation judiciaire ouvertes à compter du 1er janvier 2006.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Effectifs d'une entreprise
/effectifs_..._acoss_covid
Dans le cadre du volet 2 des aides régionales aux TPE pour faire face au Covid-19, API Entreprise a mis temporairement à disposition trois endpoints permettant de connaître les effectifs mensuels ou annuels d’une entreprise ou d’un établissement. Ces informations sont délivrées par la caisse nationale de l’URSSAF (anciennement ACOSS).
- Périmètre
- Toutes les entreprises sauf exceptions.
- Ouverture
- Données protégées.
Périmètre
-
Cette API permet d’accéder à ✅ tous les effectifs des entreprises, à l’exception :
- ❌ des administrations et collectivités territoriales ;
- ❌ des entreprises de Mayotte (ce qui représente 3500 établissements) ;
- ❌ des entreprises des marins ;
- ❌ des entreprises des cultes ;
- ❌ des junior-entreprises (environ 200).
Le calcul des effectifs se fait en prenant en compte ✅ l’ensemble des contrats établis dans l’entreprise, ❌ mis à part les :
Lire la suite
- convention de stage ;
- contrat d’apprentissage ;
- contrat de volontariat de service civique ;
- contrat d’initiative emploi ;
- contrat d’accompagnement ;
- contrat de professionnalisation ;
- contrat CDD en remplacement d’un salarié absent ;
- contrat CDD en remplacement d’un salarié en formation professionnelle ;
- contrat de soutien et d’aide par le travail ;
- ligne de service ;
- mandat d’élu ;
- fonctionnaire en détachement ;
- vendeur à domicile indépendant ;
- mandat social ;
- contrat colporteurs de presse ;
- voyageurs et représentants de commerce multi-carte ;
- contrat collaborateur occasionnel du service public ;
- militaires de réserve ;
- parcours d’accès aux carrières (Pacte). </details>
Service 1 : Effectifs annuels d'une entreprise
/effectifs_annuels_acoss_covid/
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de l'entreprise
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
effectifs_annuels_acoss_covid/SirenDeL’entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse JSON se compose de l’effectif de l’année précédente. La date ainsi que l’effectif de l’entreprise sont indiqués pour un SIREN donné. L’effectif peut être un décimal.
Réponse JSON
Service 2 : Effectifs mensuels d'une entreprise
/effectifs_mensuels_acoss_covid/.../entreprise/
Votre appel
- Paramètre d’appel :
- Le mois recherché (année et mois) + le numéro de SIREN de l'entreprise
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
effectifs_mensuels_acoss_covid/Année/Mois
/entreprise/SirenDeL’entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse JSON se compose de l’effectif du mois indiqué en paramètre d’appel. La date ainsi que l’effectif de l’entreprise sont indiqués pour un SIREN donné. L’effectif peut être un décimal.
Les effectifs étant mis à jour le 15 de chaque mois, avant cette date, il n’est possible de demander les effectifs que du mois précédent. Si la donnée est indisponible pour le mois demandé, l’API renverra un 404 avec un message d’erreur explicite.
Réponse JSON
Service 3 : Effectifs mensuels d'un établissement
/effectifs_mensuels_acoss_covid/.../etablissement/
Votre appel
- Paramètre d’appel :
- Le mois recherché (année et mois) + le numéro de SIRET de l'établissement
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
effectifs_mensuels_acoss_covid/Année/Mois
/etablissement/SiretDeL’entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse JSON se compose de l’effectif du mois indiqué en paramètre d’appel. La date ainsi que l’effectif de l’établissement sont indiqués pour un SIREN donné. L’effectif peut être un décimal.
Les effectifs étant mis à jour le 15 de chaque mois, avant cette date, il n’est possible de demander les effectifs que du mois précédent. Si la donnée est indisponible pour le mois demandé, l’API renverra un 404 avec un message d’erreur explicite.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min. par jeton.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Immatriculation EORI
/eori_douanes
Savoir si une entreprise est immatriculée auprès des douanes dans le cadre de l’import/export en Union Européenne, en vérifiant si elle possède un numéro actif EORI (Economic Operator Registration and Identification).
- Cas d’usage
- Périmètre
- Entreprises important/exportant en Union Européenne.
- Ouverture
- Données publiques.
Périmètre
-
L’endpoint
/eori_douanes
couvre ✅ toutes les entreprises faisant des échanges commerciaux entrant et sortant au sein de l’Union européenne.Appel avec un numéro EORI :
À condition de connaître le numéro EORI de l’entreprise recherchée, vous pouvez accéder au statut de l’immatriculation de ✅ toutes les entreprises de la base des douanes.
Appel avec un numéro de SIRET :
- Pour les ✅ entreprises ayant réalisé leur immatriculation EORI en France, vous pouvez utiliser le numéro de SIRET comme paramètre d’appel.
- Pour les ❌ entreprises françaises ayant été fait leur immatriculation EORI dans un autre pays européen ; l’appel par SIRET ne fonctionne pas, et vous renverra toujours un négatif, même si l’entreprise possède un numéro EORI actif.
ℹ️ Plus d’informations sur le site des douanes ou sur le site de l’Union Européenne.
Votre appel
- Paramètre d’appel :
- Numéro EORI de l'entreprise ou son SIRET si elle a été immatriculée en France.
À quoi ressemble un numéro EORI ?
Pour les entreprises françaises ayant fait leur demande de numéro EORI auprès des douanes française celui-ci est FR+SIRET (par exemple : FR16002307300010).
Sinon le numéro est composé de deux lettres du pays émetteur suivi d’un code ou d’un numéro unique dans cet État membre (par exemple : ES12345678).
Je ne connais pas le numéro EORI de l'entreprise
Vous pouvez appeler cette API avec le SIRET de l’entreprise, si celle-ci a effectuée sa demande d’attribution de numéro EORI en France nous la trouverons.
Cependant si cette entreprise a fait sa demande d’attribution de numéro EORI dans un autre pays membre de l’Union Européenne, il vous faudra demander ce numéro directement à l’entreprise. Il n’existe aucun moyen de trouver ce numéro.
⚠️ Si vous ne savez pas si l’entreprise française a effectué son immatriculation en France, une réponse négative de l’endpoint peut être un faux négatif.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
eori_douanes/NuméroEORIouSiret
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse se compose principalement :
- du status actif ou non du numéro EORI, s’il est à
false
cette entreprise n’est plus autorisée à importer ou exporter en Union Européenne ; - la raison sociale de l’entreprise telle qu’enregistrée auprès des douanes ;
- l’adresse de l’entreprise telle qu’enregistrée auprès des douanes, c’est une information importante quand l’entreprise est étrangère.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Informations financières
Chiffre d'affaires
/exercices
Obtenir les déclarations de chiffre d’affaire faites auprès de la DGFIP, et portées sur la liasse fiscale.
- Cas d’usage
- Périmètre
- Entreprises soumises à l'IS, en régime normal ou simplifié.
- Ouverture
- Données protégées.
Périmètre
-
Sont disponibles uniquement les chiffres d’affaire des entreprises qui vérifient les deux conditions suivantes :
- ✅ être soumises à l’impôt sur les sociétés selon les règles des régimes d’imposition réels, normal ou simplifié ;
- ✅ avoir transmis ses comptes annuels aux greffes.
Seuls les trois derniers exercices sont renvoyés.
ℹ️ Ceux-ci ne sont pas forcément les exercices des trois dernières années car il peut y avoir plusieurs exercices dans une même année.
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l'entreprise.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
exercices/SiretDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
Les exercices renvoyés par la DGFIP sont listés les uns après les autres, le premier étant le plus récent. Le nombre d’exercices renvoyés varie de 1 à 3. Pour chaque exercice, deux informations sont transmises :
- le chiffre d’affaire en euros ;
- la date de fin de l’exercice, communiquée au format textuel AAAA-MM-JJ et au format timestamp UNIX.
Quelle est la définition du chiffre d'affaire transmis ?
Le cas du régime réel normal
Le chiffre d’affaire correspond au montant porté en case FL du formulaire 2052 - compte de résultat de l’exercice, c’est-à-dire, le total des chiffres d’affaire nets de France et d’exportations et livraisons intracommunautaires.
Le cas du régime réel simplifié
Le chiffre d’affaire correspond à la somme des montants indiqués dans les cases 210, 214 et 218 du formulaire 2033B - compte de résultat simplifié de l’exercice ; c’est à dire le total :
- des ventes de marchandises (dont export et livraisons intracommunautaires) ;
- de la production vendue des biens ;
- de la production vendue des services, c’est à dire “du montant des travaux, études et prestations de services exécutés, comprenant le cas échéant les produits des activités annexes (services exploités dans l’intérêt du personnel, commissions et courtages, locations diverses, mises à disposition de personnel facturées, ports et frais accessoires facturés, boni sur remises d’emballages consignés).”
Source : impôts.gouv
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 23h/24
- Indisponibilités types :
- Opérations de maintenance toutes les nuits entre 1h et 2h.
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Bilans annuels
/bilans_inpi
Obtenir les comptes annuels d’une entreprise tels que transmis par les greffes à l’Institut National de Propriété Industrielle (INPI).
- Cas d’usage
- Périmètre
- Certaines entreprises.
Tous les bilans depuis 2017. - Ouverture
- Données publiques et protégées.
Périmètre
-
Cette API permet d’accéder à tous les bilans annuels depuis 2017 des entreprises ayant décider de le déposer au greffe, y compris les bilans confidentiels.
✅ Toutes les entreprises sont concernées sauf :
- ❌ les sociétés en micro-BNC ou micro-BIC ;
- ❌ les entrepreneurs individuels (commerçants, artisans, profession libérale, micro-entrepreneurs notamment) ;
ℹ️ Chaque année, il y a environ 1,2 million d’inscriptions par an, dont 45% avec déclaration de confidentialité.
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de l'entreprise.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
bilans_inpi/SirenDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Archive ZIP contenant PDF et XML
- Timeout :
- 12 secondes
La réponse se compose :
- d’une URL permettant de télécharger une archive ZIP contenant l’ensemble des bilans au format PDF de l’entité appelée ;
- de la liste des bilans, accompagnés de leurs informations génériques (identifiant du fichier dans l’archive téléchargée, le code greffe, les dates de dépôt et clôture, la nature de l’archive, son degré de confidentialité, et le numéro de gestion.)
L’archive ZIP fournie par l’URL se compose de :
- de tous les comptes annuels au format PDF (Voici un exemple de document) ;
- de toutes les métadonnées de chaque bilan, au format XML, portant le même nom que le PDF associé ;
- d’un fichier
Response.json
permettant de retrouver le PDF dans l’archive à partir de l’id_fichier
du bilan indiqué dans la liste JSON des bilans.
Comment utiliser les bilans confidentiels
et les bilans partiellement confidentiels ?
Certaines entreprises (PME) peuvent décider de ne pas publier leurs comptes annuels. Elles ont toutefois l’obligation de les déposer. Leurs bilans sont donc présents à l’INPI et cet endpoint permet d’y accéder.
Bilans confidentiels
Lorsque le champ confidentiel
est égal à 1
, cela signifie que le bilan est totalement confidentiel et implique que vous vous engagez à n’utiliser ces informations que dans le cadre strict de vos missions de service public, à ne pas les rediffuser ni les divulguer auprès de tiers non autorisés.
Bilan partiellement confidentiels
Lorsque le champ confidentiel
est égal à 2
, cela signifie qu’une partie du document est confidentielle et que l’autre est publique. Depuis 2019, l’INPI a rendu les PDF séparables, ce qui permet aux personnes n’ayant pas d’habilitation spécifique de télécharger les informations publiques disponibles.
Dans le cadre de l’utilisation de l’API Entreprise, les bilans partiellement confidentiels de l’INPI sont à traiter comme les bilans confidentiels puisque la distinction n’est pas faite entre données publiques et secrètes. Vous vous engagez à n’utiliser ces informations que dans le strict cadre de vos missions de service publics, à ne pas les rediffuser ni les divulguer à des tiers non autorisés.
Quel est le délai de mise à disposition des bilans dans l'API INPI ?
Les bilans PDF disponibles dans l’archive ZIP sont transmis théoriquement par le greffe 24h après leur dépôt.
Les données du bilan mises à disposition sous forme XML nécessitent un délai plus long de deux semaines.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 5 requêtes/min. par jeton.
- Disponibilité normale :
- Indisponibilités types :
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
3 derniers bilans annuels
/bilans_entreprises_bdf
Obtenir les trois derniers bilans d’une entreprise détenus par la Banque de France. Ces bilans permettent d’accéder à certaines informations contenues dans la liasse fiscale : bilans, compte de résultat et annexes confondus. Ces données proviennent de la base FIBEN (Fichier bancaire des entreprises) - hors cotation.
- Cas d’usage
- Périmètre
- Les entreprises ayant au moins 3 bilans et réalisant plus 750 000€ de CA.
- Ouverture
- Données protégées.
Périmètre
-
Entreprises concernées
Les données Banque de France ne couvrent pas de manière exhaustive tous les SIREN. Notamment, seules les entreprises réalisant un chiffre d’affaire supérieur à 750 000 euros et ayant a minima trois bilans sont disponibles.
Bilans renvoyés
Les bilans retenus sont ceux dont la date d’arrêté est comprise entre le mois en cours [MM/AAAA], et 4 ans en arrière [MM+1/AAAA-4].
Par exemple pour un appel le 17 janvier 2020, les bilans retenus ont une date d’arrêt comprise entre le 1er février 2016 et le 17 janvier 2020.⚠️ Même si la Banque de France connaît un à deux bilans de l’entité appelée mais pas les trois derniers, aucune données sera transmise et l’erreur 404 sera renvoyée.
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de l'entreprise.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
bilans_entreprises_bdf/SirenDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
Les trois bilans de la Banque de France sont listés les uns après les autres, le premier étant le plus récent. Chacun d’eux est accompagné d’informations en majeure partie tirées :
- des bilans (passif de l’entreprise - liasse 2051) ;
- des comptes de résultat (liasse 2052 et liasse 2053) ;
- et de l’annexe 2057 concernant l’état des échéances des créances et des dettes à la clôture de l’exercice.
La Banque de France délivre également une évolution des montants de l’exercice concerné avec l’année N-1, quand les durées d’exercices sont identiques.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7 jours/7, de 8h à 23h.
- Indisponibilités types :
- Opérations de maintenance toutes les nuits entre 23h et 8h. Durant ce laps de temps, la base de données ou une partie de l'applicatif peut être affecté. Il nous est dans ce cas renvoyé divers codes d'erreurs que nous regroupons sous le code HTTP 503 (Service Indisponible) auquel est adjoint un message spécifique expliquant le souci côté Banque De France quand celui ci est connu avec précision. Vous pouvez toutefois faire des appels après 22h mais devrez prendre en compte ces opérations de maintenance.
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Déclarations de résultat
/liasses_fiscales_dgfip
Obtenir les données contenues dans les liasses fiscales, issues des déclarations de résultat d’une entreprise auprès de la Direction génénrale des finances publiques (DGFIP). Cet endpoint renvoyant beaucoup de données, plusieurs services sont disponibles, les déclarations seules, le dictionnaire seul, ou les deux réunis pour une entreprise donnée.
- Cas d’usage
- Périmètre
- Entreprises BIC, BA, BNC, ou soumises à l'IS, IS groupe.
- Ouverture
- Données protégées.
Périmètre
-
La liasse fiscale est limitée aux entreprises :
- ✅ soumises à l’impôt sur les sociétés (IS)* ;
- ✅ soumises à l’impôt sur les sociétés dû par le groupe (IS GROUPE)*;
- ✅ aux bénéfices industriels et commerciaux (BIC)* ;
- ✅ aux bénéfices non commerciaux (BNC)* ;
- ✅ aux bénéfices agricoles (BA)*.
*selon les règles des régimes réels normal ou simplifié.
ℹ️ Les entreprises anciennement aux forfaits BIC/BNC/BA , désormais ❌ régimes micro-BIC, micro-BNC et micro-BA ne déposent pas de déclaration de résultat mais des éléments spécifiques dans la déclaration 2042C qui relève de d’impôt sur le revenu et ne sont donc pas dans le périmètre de cet endpoint.
Service 1 : Déclaration d’une entreprise
/declarations/
Votre appel
- Paramètre d’appel :
- L'année de la liasse fiscale demandée + le paramètre "declarations" + le numéro de SIREN de l'entreprise.
Quelles sont les dates de dépôt des liasses fiscales par les entreprises ?
La date limite de dépôt des déclarations de résultat est fixée au 2ème jour ouvré qui suit le 1er mai pour les entreprises qui clôturent à la fin de l’année civile.
En cas d’exercice à cheval, la date limite de dépôt est positionnée exactement 3 mois après la date de clôture de l’exercice déclaré.
Quel est le délai de mise à disposition des données d'une déclaration déposée par une entreprise ?
Les déclarations de résultat sont disponibles :
- à compter du lendemain de la date de dépôt (J+1) ;
- trois jours plus tard (J+3) si le dépôt intervient une veille de week-end.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
liasses_fiscales_dgfip/AnneeDeLaLiasseDemandée
/declarations/SirenDeL’entreprise
?token=JetonD’Habilitation
&email=(optionnel)EmailUtilisateurFaisantLaDemande
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
Comment faire le lien avec le dictionnaire ?
Chaque liasse fiscale renvoyée est accompagnée d’un millésime, et chaque valeur est indiquée par un code_nref
. Ce dernier est une suite de 6 chiffres. Le dictionnaire de liasses fiscales, disponible avec l’option d’appel Annee/dictionnaire
, vous permet de retrouver la signification du code : “l’intitulé de la donnée”.
ℹ️ Il vous faudra à chaque fois préciser le millésime, car les nomenclatures évoluent chaque année.
Comment distinguer l'imprimé rectificatif de l'initial ?
Il peut arriver que pour un même exercice il y ait plusieurs fois le même imprimé ; il s’agit de corrections qui ont été apportées par une déclaration ultérieure.
Les déclarations dans le JSON sont triées de l’imprimé le plus récent au plus ancien. Ainsi le premier imprimé est toujours le plus récent.
Par ailleurs, les deux imprimés auront toujours la même date_declaration
qui correspond à la date du correctif. Celle-ci ne vous permet donc pas de distinguer l’imprimé rectificatif de l’imprimé initial, pour lequel il n’est pas possible de connaître la date de déclaration.
Réponse JSON
Service 2 : Dictionnaire des liasses fiscales
/dictionnaire/
Votre appel
- Paramètre d’appel :
- L'année de la liasse fiscale demandée.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
liasses_fiscales_dgfip/AnneeDeLaLiasseDemandée
/dictionnaire/
?token=JetonD’Habilitation
&email=(optionnel)EmailUtilisateurFaisantLaDemande
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
Réponse JSON
Service 3 : Liasses fiscales d'une entreprise et dictionnaire pour une année donnée
/complete/
Votre appel
- Paramètre d’appel :
- L'année de la liasse fiscale demandée
⚠️ "Complete" ne signifie pas que toutes les liasses fiscales sont retournées
Le paramètre d’appel complete
de ce service permet de retourner les déclarations disponibles d’une entreprise avec le dictionnaire de l’année demandée. Ce paramètre ne veut pas dire que toutes les liasses fiscales seront renvoyées. En effet, les déclarations disponibles sont restreintes par décret.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
liasses_fiscales_dgfip/AnnéeDeLaLiasseDemandée
/complete/SirenDeL’Entreprise
?token=JetonD’Habilitation
&email=(optionnel)EmailUtilisateurFaisantLaDemande
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 23h/24
- Indisponibilités types :
- Opérations de maintenance toutes les nuits entre 1h et 2h.
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Attestations sociales et fiscales
Attestation fiscale
/attestations_fiscales_dgfip
Obtenir l’attestation fiscale, délivrée par la Direction générale des finances publiques, indiquant que l’entreprise est à jour de ses obligations fiscales.
- Cas d’usage
- Périmètre
- Entreprises soumises à l'IS.
- Ouverture
- Données protégées.
Périmètre
-
L’attestation de régularité fiscale est limitée aux ✅ entreprises soumises à l’impôt sur les sociétés (IS) à l’exclusion des :
- ❌ bénéfices industriels et commerciaux (BIC) ;
- ❌ bénéfices non commerciaux (BNC) ;
- ❌ bénéfices agricoles (BA) ;
Sont aussi exclues, même si les obligations fiscales sont respectées, les :
- ❌ entreprises individuelles ;
- ❌ sociétés de personnes ;
- ❌ groupements passibles de l’impôt sur le revenu (entrepreneurs individuels).
⚠️ L’attestation est délivrée si les obligations déclaratives et de paiement d’IS et de TVA de la société sont en règle. Ainsi, les sociétés bénéficiant d’un plan de règlement, redressement, sauvegarde ou conciliation ainsi que les sociétés ayant formulé un recours contentieux assorti d’un sursis de paiement ne peuvent pas se voir délivrer une attestation fiscale.
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de l'entreprise.
- Options d’appel à ajouter (voir requête HTTP ↓) :
-
- Dans le cas où l'entreprise recherchée appartient à un groupe de sociétés imposé selon régime fiscal d’intégration visé à l’article 223 A du CGI, dit groupe IS, c'est cette société mère qui est en charge des obligations fiscales. Il vous faudra donc indiquer également le SIREN du groupe IS.
- Dans le cas où l'entreprise recherchée appartient à un groupe de sociétés ayant opté pour la consolidation du paiement de la TVA définie à l’article 1693 ter du CGI, dit groupe TVA, c'est cette société mère qui est en charge des obligations fiscales. Il vous faudra donc indiquer également le SIREN du groupe TVA.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
attestations_fiscales_dgfip/SirenDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
Si l'entreprise appartient à un groupe IS, ajoutez le SIREN référent du groupe avec le paramètre suivant :
&siren_is=SirenDuGroupeIS
Si l'entreprise appartient à un groupe TVA, ajoutez le SIREN référent du groupe avec le paramètre suivant :
&siren_tva
La réponse de l’API
- Format :
- Document PDF
- Timeout :
- 12 secondes
La réponse est composée d’une URL permettant de télécharger l’attestation en PDF, dont voici un exemple.
Qu'atteste ce document ? et quelle est sa durée de validité ?
L’attestation fiscale atteste que l’entreprise est à jour des ses obligations fiscales à la date du 31/12 de l’année précédente.
Par exemple si vous demandez une attestation en mars 2015, l’attestation fiscale vous indiquera que l’entreprise est à jour de ses obligations fiscale lui incombant au 31/12/2014.
L’attestation fiscale est valide un an sur une année civile (jusqu’au 31/12/AAAA).
L’api ne renvoie pas de pièce, est ce que ça veut dire que l’entreprise n’est pas à jour ?
Non, dans certains cas particuliers, nous ne pouvons pas renvoyer l’attestation. Ça ne veut pas dire que l’entreprise n’est pas à jour. Il faut se rapprocher de l’entreprise pour lui demander la pièce directement.
L’api ne renvoie pas la pièce, est ce que ça veut dire qu’elle ne sera jamais disponible ?
Non, si une entreprise se voit refuser la délivrance de l’attestation pour cause de carence de ses déclarations ou de ses paiements, cette non délivrance n’est pas définitive pour toute l’année N. Si ensuite elle régularise sa situation pour les années N-1 et antérieures, alors l’attestation de régularité lui sera délivrée.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 5 requêtes/min. par jeton.
- Disponibilité normale :
- 7jours/7 et 23h/24
- Indisponibilités types :
- Opérations de maintenance toutes les nuits entre 1h et 2h.
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Attestation de vigilance
/attestations_sociales_acoss
Obtenir l’attestation validant que l’entreprise s’acquitte de ses obligations déclaratives et du paiement des cotisations et contributions sociales auprès de l’URSSAF Caisse nationale (anciennement ACOSS). L’attestation de vigilance permet également de prouver que l’entreprise respecte les règles applicables en matière de lutte contre le travail dissimulé.
- Cas d’usage
- Périmètre
- Toutes les entreprises.
- Ouverture
- Données protégées.
Conformité emploi des travailleurs handicapés
/attestations_agefiph
Obtenir la dernière année connue de conformité d’une entreprise au regard de l’obligation d’emploi des travailleurs handicapés.
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l'établissement.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
attestations_agefiph/SiretDeL’Etablissement
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse se compose de :
- la dernière année de conformité connue de l’entreprise ;
- la dernière date de validité des informations renvoyées. ℹ️ Cette donnée étant issue d’un dump fourni par l’AGEFIPH,API Entreprise vous la transmet.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Cotisations de sécurité sociale agricole
/cotisations_msa
Savoir si une entreprise est à jour de ses cotisations sociales auprès de la sécurité sociale agricole (MSA).
- Cas d’usage
- Périmètre
- Entreprises d'agriculture, élevage, pèche et forestier.
- Ouverture
- Données protégées.
Périmètre
-
Sont éligibles à la MSA les entreprises de :
- l’agriculture
- l’élevage
- la pèche
- le forestier.
Depuis 2021, l’attestation de vigilance n’est délivrée que si la contribution annuelle de l’OETH (Obligation d’Emploi de Travailleur Handicapé) a été acquittée par l’entreprise. Cette compétence était auparavant attribuée à l’AGEFIPH.
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l'etablissement recherché.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
cotisations_msa/SiretDeL’Etablissement
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse indique si l’entreprise est à jour de ses cotisations employeurs auprès de la MSA. Dans certains cas et sur un laps de temps limité, l’entreprise peut faire l’objet d’une analyse manuelle par un agent de la MSA, ce qui sera indiqué dans la réponse.
Quelles sont les trois situations possibles pour une entreprise ?
Il existe donc 3 situations possibles pour une entreprise :
- L’entreprise est à jour de ses cotisations sociales auprès de la MSA.
- L’entreprise n’est pas à jour de ses cotisations sociales.
- La régularité de l’entreprise est inconnue. Une analyse est à effectuer par un agent caisse de la MSA pour savoir si le débiteur est à jour ou pas.
ℹ️ Ces trois situations correspondent à un fonctionnement normal de l’endpoint, quand il n’y a pas d’erreur à signaler. S’il y a une erreur, les champs seront vides et un code erreur HTTP vous sera envoyé.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Cotisations retraite bâtiment
/cotisation_retraite_probtp
Savoir si une entreprise est à jour de ses cotisations retraite à la Protection Sociale du Bâtiment et des Travaux publics (PROBTP) et obtenir l’attestation de l’entreprise si celle-ci est éligible.
- Cas d’usage
- Périmètre
- Entreprises.
- Ouverture
- Données protégées.
Nouvelle option disponible
Périmètre
Service 1 : Savoir si l'entreprise est à jour de ses cotisations
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l'entreprise.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
eligibilites_cotisation_retraite_probtp/SiretDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse indique, par un champ true
/false
, si l’entreprise est éligible à l’attestation de cotisation retraite,
ℹ️ Si l’entreprise est éligible, cela signifie en creux qu’elle est en règle de ses cotisations retraites.
Que signifie le code erreur 404 ?
Lorsque l’entreprise est inconnue de PROBTP, un code erreur (404) est renvoyé.
Réponse JSON
Service 2 : Obtenir l'attestation de l'entreprise
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l'entreprise.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
attestations_cotisation_retraite_probtp/SiretDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Document PDF
- Timeout :
- 12 secondes
La réponse se compose de l’URL d’accès à l’attestation de l’entreprise au format PDF quand celle-ci est disponible.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Carte professionnelle travaux publics
/cartes_professionnelles_fntp
Récupérer la carte professionnelle d’entrepreneur de travaux publics, délivrée à une entreprise de travaux publics en règle de ses obligations sociales, administratives et juridiques.
- Cas d’usage
- Périmètre
- Entreprises de travaux publics en règle, ayant fait la demande.
- Ouverture
- Données publiques.
Périmètre
-
Toute entreprise de travaux publics peut demander une carte professionnelle à la FNTP. Celle-ci lui est délivrée lorsque l’entreprise est en règle de ses obligations sociales, administratives et juridiques.
À ce jour, la FNTP a délivré des cartes professionnelles à plus de 9000 entreprises.
ℹ️ Plus d’informations sur le site de la FNTP
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de l'entreprise.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
cartes_professionnelles_fntp/SirenDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Document PDF
- Timeout :
- 12 secondes
La réponse se compose de l’URL d’accès à la carte professionnelle de l’entreprise au format PDF, dont voici un exemple.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 50 requêtes/min/jeton cumulées sur tous les endpoints envoyant des documents.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Cotisations congés payés & chômage intempéries
/certificats_cnetp
Obtenir l’attestation de cotisation des congés payés et chômage intempéries d’une entreprise, délivrée par la Caisse Nationale des Entrepreneurs de Travaux Publics (CNETP).
- Cas d’usage
- Périmètre
- Entreprises de travaux publics et bâtiment,
de certaines conventions collectives. - Ouverture
- Données protégées.
Périmètre
-
L’endpoint de la CNETP couvre l’ensemble des entreprises exerçant une ou plusieurs activités entrant dans le champ d’application des conventions collectives nationales étendues des Travaux Publics et du Bâtiment :
- ✅ Convention Collective Nationale des Ouvriers des Travaux Publics du 15 décembre 1992 (étendue par arrêté du 27 mai 1993) ;
- ✅ Convention Collective Nationale des ETAM des Travaux Publics du 12 juillet 2006 (étendue par arrêté du 28 juin 2007)
- ✅ Convention Collective Nationale des Cadres des Travaux Publics du 20 novembre 2015 (étendue par arrêté du 5 juin 2020).
Toutes les attestations sont disponibles pour les entreprises en situation régulière ❌ sauf pour celles qui règlent les cotisations dues à la CNETP à l’URSSAF dans le cadre du Titre Emploi Service Entreprise (TESE).
Lire la suite
ℹ️ Plus d’informations sur https://www.cnetp.org/category/affiliation/
La CNETP, une caisse à compétence nationale
L’article D.3141-12 du code du travail définit les entreprises qui sont tenues d’adhérer auprès d’une Caisse de Congés Payés du BTP : “Dans les entreprises exerçant une ou plusieurs activités entrant dans le champ d’application des conventions collectives nationales étendues du bâtiment et des travaux publics, le service des congés est assuré, sur la base de celles-ci, par des caisses constituées à cet effet.”
L’article D.3141-20 du code du travail dispose quant à lui que “dans les entreprises dont l’activité principale relève des travaux publics, ce service est assuré par une caisse à compétence nationale.” </details>
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de l'entreprise.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
certificats_cnetp/SirenDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Document PDF
- Timeout :
- 12 secondes
La réponse délivre une URL de téléchargement de l’attestation au format PDF quand celle-ci est disponible, dont voici un exemple.
Quelles sont les conditions de délivrance de l'attestation ?
L’attestation est délivrée à l’entreprise sous réserve que celle-ci :
- soit à jour de ses déclarations exigibles servant à l’assiette des cotisations de congés payés et des cotisations de chômage-intempéries ;
- soit à jour du paiement des cotisations citées.
L'api ne renvoie pas de pièce, peut-on considérer que l'entreprise n'est pas à jour ?
Non, dans certains cas nous ne pouvons pas récupérer l’attestation. Notamment, certaines entreprises règlent leurs cotisations dues à la CNETP à l’URSAFF (dans le cadre du TESE) ; leurs attestations ne sont pas accessibles depuis cette API.
Comment utiliser ces données protégées ?
Les attestations de la CNETP, protégées au titre du secret des affaires
Dans le cadre d’un Marché public, les attestations de Marché ont pour objet de prouver à l’acheteur public que le candidat a satisfait à ses obligations fiscales et sociales. Il en est ainsi des attestations de Marchés délivrées par la CNETP aux entreprises de Travaux Publics.
Or, conformément au code de la commande publique, l’acheteur public ne peut communiquer les informations protégées dont il a eu connaissance lors de la procédure de passation et notamment celles dont la divulgation violerait le secret des affaires.
C’est pourquoi, les attestations délivrées par la CNETP constituent des données protégées et non publiques.
Des informations à ne pas divulguer
En utilisant l’endpoint certificats_cnetp
, vous vous engagez à n’utiliser ces informations que dans le cadre strict de vos missions de service public, à ne pas les rediffuser ni les divulguer auprès de tiers non autorisés.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 50 requêtes/min/jeton cumulées sur tous les endpoints envoyant des documents.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Certifications professionnelles
Certification en BIO
/certificats_agence_bio
Connaître les certifications biologiques en cours d’une entreprise ou d’une association. Ces données sont fournies par l’Agence Française pour le Développement et la Promotion de l’Agriculture Biologique (Agence BIO) qui agrège les données de l’ensemble des organismes certificateurs.
- Cas d’usage
- Périmètre
- Les entités ayant une certification BIO.
- Ouverture
- Données publiques.
Périmètre
-
Cette API renvoie l’état des certifications de :
- ✅ toutes les entreprises certifiées BIO ;
- ✅ des associations certifiées BIO ayant un numéro de SIRET.
Les données disponibles sont issues de l’annuaire officiel de l’Agence BIO, lui même alimenté par les différents organismes certificateurs : la donnée JSON renvoyée est elle-même certifiée.
❌ 10% des certificats PDF ne sont pas accessibles :
Lire la suite
- Aujourd’hui, l’endpoint permet d’accéder à 90% des certificats au format PDF correspondant aux opérateurs des ✅ six organismes certificateurs (Ecocert, Bureau Veritas, Certipaq, Alpes contrôles, Certis et Control Union) ayant mis en ligne ces documents.
- Pour ❌ les 10% de cas restants, le certificat PDF n’est pas disponible. En cas de besoin, il est nécessaire de contacter l’organisme certificateur pour obtenir la pièce justificative.
ℹ️ L’accès aux certificats n’est pas direct comme pour les autres endpoints API Entreprise. Les documents sont accessibles en suivant le lien transmis, permettant de se rendre sur la page HTML de l’organisme certificateur, sur laquelle il est possible de télécharger le certificat.
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l'entreprise ou de l'association.
Est-ce que je peux appeler une association sans numéro de SIRET ?
L’unique paramètre d’appel de l’API est actuellement le numéro de SIRET. Il n’est donc pas possible d’interroger l’API avec un numéro RNA.
Par conséquent, seules les associations ayant été immatriculées au Répertoire Sirene, et donc dotées d’un numéro de SIRET, sont accessibles depuis cet endpoint.
ℹ️ Pour trouver le numéro de SIRET d’une association, vous pouvez vous aider de l’annuaire des entreprises. En entrant le nom de l’association, si celle-ci est enregistrée, vous la retrouverez.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
certificats_agence_bio/SiretDeL’entité
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDeL’appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse se compose :
- d’informations générales sur l’opérateur (l’entreprise ou l’association certifiée), telles que sa raison sociale, son numéro BIO et ses adresses postales ;
- de la liste des activités et des produits certifiés ;
- et enfin des informations sur les différents certificats (état de la certification, nom de l’organisme, dates clés) accompagnées d’une URL pour télécharger le certificat.
La réponse JSON fait-elle foi ? Est-elle certifiante ?
Cela dépend de l’information renvoyée :
✅ l’état de la certification fait foi, il permet de savoir si l’entité est bien certifiée. Cette information est indiquée dans la réponse JSON par la clé etat_certification
;
❌ Concernant la liste des produits certifiés renvoyée, un décalage avec la réalité du terrain peut subvenir car les données correspondent actuellement à la déclaration de l’opérateur. L’Agence BIO travaille avec les organismes certificateurs pour récupérer de façon automatique les productions certifiées.
Il n'y a aucun lien pour télécharger le certificat, est-ce normal ?
Oui, le certificat au format PDF n’est pas disponible pour tous les opérateurs, 10% des certificats ne sont pas accessibles.
Dans le cas où celui-ci est disponible, cet endpoint vous renvoie l’URL d’accès à la page HTML de l’organisme certificateur permettant de télécharger le certificat. Aujourd’hui, six organismes certificateurs (Ecocert, Bureau Veritas, Certipaq, Alpes controles, Certis et Control Union) ont mis en ligne les certificats.
L'appel de certains SIRET renvoie plusieurs réponses, laquelle choisir ?
Dans certains cas très minoritaires (environ 700 cas sur 90 000 opérateurs), cet endpoint est susceptible de renvoyer plusieurs items au lieu d’un. Ce doublon est un résidu de migration que l’Agence BIO est en train de progressivement résorber.
- Dans le cas où sur les deux items, l’un présente un
"etat_certification" = "ARRETEE"
/"SUSPENDUE"
/"RETIREE"
; et le doublon, un"etat_certification" = "ENGAGEE"
. Vous pouvez tenir compte uniquement de ce dernier. La section présentant un état engagé prévalant sur l’autre. - Dans le cas où les deux items présentent un
'etat_certification'
engagé. Il n’y aucun moyen de savoir lequel est à jour. L’Agence BIO elle-même résorbe progressivement ces doublons en collaboration avec les organismes certificateurs.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Certification RGE
/certificats_rge_ademe
Obtenir le certificat “Reconnu Garant de l’Environnement” d’une entreprise, attestant de compétences spécifiques en travaux de rénovation énergétique. Si vous avez besoin uniquement du certificat Qualibat, un endpoint dédié existe.
- Cas d’usage
- Périmètre
- Entreprises de rénovation énergétique.
- Ouverture
- Données publiques.
Périmètre
-
Les données concernent les entreprises de rénovation énergétique, ayant fait la demande d’une qualification RGE et remplissant les critères défini par le label.
L’endpoint renvoit les fichiers de 95% des entreprises en base chez l’ADEME.
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l'entreprise.
- Options d’appel à ajouter (voir requête HTTP ↓) :
-
- Une option d'appel vous permet de ne pas appeler les fichiers PDF si seules les données brutes vous intéressent. Cela réduira le temps de réponse de l'API.
Qu'est ce que le label RGE ? Quand est-il délivré à une entreprise ?
Le label RGE (« Reconnu Garant de l’Environnement ») est délivré à une entreprise qui remplit certains critères lors de la réalisation de travaux d’économie d’énergie dans les logements (isolation des murs ou de la toiture, installation d’un équipement utilisant une énergie renouvelable, etc.). Il s’agit d’un dispositif reconnu par l’État.
Quels sont les différents types de certifications ?
- Qualit’EnR pour les installations d’équipements valorisant les énergies renouvelables.
- Qualifelec pour les travaux électriques en matière d’efficacité énergétique et/ou d’installation des énergies renouvelables.
- RGE Eco-artisan pour des prestations de conseil dans le domaine de la performance énergétique, par le biais d’une évaluation thermique ou des travaux d’efficacité énergétique.
- Qualibat pour des travaux liés à la performance énergétique (construction ou rénovation).
- Céquami délivre des certifications à des professionnels à même de proposer des travaux de rénovation lourde dans le cadre d’une rénovation énergétique globale du logement.
- Certibat délivre des certifications aux professionnels du bâtiment en mesure de réaliser des offres globales de rénovation énergétique.
Pourquoi exclure les liens de PDF ?
Lorsque l’API récupère les informations auprès de l’ADEME, le système télécharge par défaut les PDFs directement depuis les serveurs de l’ADEME. Cela peut prendre du temps dans le cas où l’entreprise possède plusieurs certificats.
Exclure les PDFs à l’aide de l’option skip_pdf
, permet d’améliorer drastiquement le temps de réponse de l’endpoint (de l’ordre de plusieurs secondes dans le cas où il y a plusieurs certificats).
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
certificats_rge_ademe/SiretDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
Pour appeler uniquement les données brutes, sans les PDFs :
&skip_pdf=boolean (false par défaut)
La réponse de l’API
- Format :
- Nom du certificat et documents PDF
- Timeout :
- 12 secondes
La réponse se compose du nom de la qualification de l’entreprise, de l’URL de téléchargement de l’attestation au format PDF quand celle-ci est disponible (et non exclue via l’option skip_pdf
), du nom du certificat et du domaine. Voici différents exemples de certificats au format PDF.
Pourquoi certains certificats ne sont pas disponibles ?
L’ADEME demande aux organismes de certifications (Qualit’EnR, Qualifelec, …) de mettre à disposition les adresses URL vers les certificats mais tous les développements n’ont pas encore été réalisés. De fait certains documents ne sont pas accessibles. Cependant, les fichiers sont disponibles pour 95% des entreprises en base chez l’ADEME. L’endpoint API Entreprise vous renvoie alors le message suivant : le champ url_certificat
indique : Une erreur est survenue lors de la récupération du fichier PDF
.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 50 requêtes/min/jeton cumulées sur tous les endpoints envoyant des documents.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Certificat de qualification bâtiment
/certificats_qualibat
Obtenir le certificat Qualibat, apportant l’avis de l’association sur la qualification d’une entreprise dans le bâtiment. Si vous cherchez d’autres certificats de qualification, l’endpoint certification RGE regroupe tous les certificats, dont les Qualibats.
- Cas d’usage
- Périmètre
- Entreprises de travaux publics et bâtiment.
- Ouverture
- Données publiques.
Périmètre
Votre appel
- Paramètre d’appel :
- Le numéro de SIRET de l'entreprise.
Quelles sont les différentes certifications/qualifications ?
- Qualification « Mesurage dans le bâtiment » ;
- Qualification « Audits énergétiques » - Certifications « Traitement des bois » ;
- Certification « Métallerie feu » ;
- Certification « Travaux d’accès difficile à la corde » ;
- Certification « Traitement de l’amiante » ;
- Certifications de systèmes qualité ;
- Certifications environnementales.
ℹ️ Toutes les informations concernant ces différentes certifications et qualifications sont disponibles sur le site Qualibat
Quelle est la différence entre une certification et une qualification ?
Les qualifications professionnelles Qualibat
Elles constituent la reconnaissance des compétences de l’entreprise, de sa capacité à réaliser des travaux dans une activité donnée, à un niveau de technicité défini. Elles donnent à l’entreprise les moyens de faire-valoir son expertise technique et permettent au maître d’ouvrage d’identifier précisément les professionnels capables de répondre à sa demande.
Les certifications métiers Qualibat
Elles caractérisent les entreprises aptes à répondre à certaines activités nécessitant le respect de réglementations particulières en matière d’environnement, de sécurité ou de protection de la santé. Elles sont attribuées à partir de référentiels techniques spécifiques. En plus de la reconnaissance du savoir-faire, elles supposent la mise en place d’un système d’organisation et de procédures au sein de l’entreprise.
ℹ️ Source : Qualibat
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
certificats_qualibat/SiretDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Document PDF
- Timeout :
- 12 secondes
La réponse se compose de l’URL de téléchargement de l’attestation au format PDF quand celle-ci est disponible. Voici un exemple de certificat au format PDF.
Quelles informations figurent sur le certificat ou la qualification ?
Les informations génériques :
- Le millésime ;
- La durée de validité, de date à date ;
- Un numéro d’identification.
Les informations recueillies et contrôlées sur l’entreprise :
-
La situation administrative et juridique :
- la raison sociale de l’entreprise ;
- ses coordonnées complètes ;
- le nom et la fonction de ses dirigeants responsables ;
- sa date de création ;
- sa forme juridique ;
- le montant de son capital social ;
- son numéro de registre de commerce ou de répertoire des métiers
- son code NACE ;
- son numéro d’affiliation à la caisse de congés payés ;
- ses compagnies d’assurances ;
- la régularité de sa situation fiscale et sociale.
-
La classification :
- son effectif ;
- son classement dans une catégorie d’entreprise ;
- son chiffre d’affaires hors taxes / son classement dans une catégorie d’entreprise
-
La qualification :
- Le code à quatre chiffre de la capacité technique reconnue à l’entreprise dans une activité donnée ;
- Le titre de cette capacité ;
- Le niveau de technicité.
-
La classification partielle : les moyens humains dont dispose l’entreprise dans l’activité pour laquelle elle est qualifiée sont précisés.
-
Les dates de validité :
- La date d’attribution : la date à laquelle la qualification a été attribuée ou du plus récent renouvellement.
- La date d’échéance : est portée la date d’expiration de validité de la qualification.
-
Le système qualité : dans la mesure où l’entreprise a mis en place une démarche qualité certifiée par QUALIBAT, la certification de son système qualité est mentionnée en annexe.
ℹ️ Source : Qualibat
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 50 requêtes/min/jeton cumulées sur tous les endpoints envoyant des documents.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Certification de qualification d'ingénierie
/certificats_opqibi
Obtenir le certificat délivré par l’OPQIBI attestant de la capacité d’une entreprise à réaliser une prestation d’ingénierie.
- Cas d’usage
- Périmètre
- Presque 2000 entreprises.
- Ouverture
- Données publiques.
Périmètre
-
Au 31 décembre 2019, l’OPQIBI compte 1962 entreprises qualifiées.
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de l'entreprise.
Qu'est ce que certifie l'OPQBI ?
Ce certificat permet de connaitre les qualifications et les qualifications probatoires qu’une entreprise maitrise.
Une qualification atteste de la capacité d’une entreprise d’ingénierie à réaliser une prestation déterminée. Elle est attribuée sur la base de critères légaux, administratifs, juridiques, financiers et techniques (moyens (humains, matériels, méthodologiques) et références).
Une qualification probatoire est attribuée à une entreprise nouvellement créée ou en cours de diversification qui ne dispose pas encore de référence ou en nombre insuffisant mais satisfait aux critères légaux, administratifs, juridiques et moyens.
Une entreprise possède au moins une qualification ou une qualification probatoire.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
certificats_opqibi/SirenDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse se compose :
- des informations génériques du certificat ;
ℹ️ Précisant notamment la date de délivrance du certificat et sa durée de validité. - des qualifications et qualifications probatoires de l’entreprise.
ℹ️ Indiquant le code de la qualification, son nom et sa définition, le statut “RGE” s’il est reconnu, et les dates de validité.
Quelles sont les durées de validité ?
- Un certificat est valable 1 an ;
- Une qualification est valable 4 ans sous réserve de 3 contrôles annuels ;
- Une qualification probatoire est valable 1 an.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes
Propriété intellectuelle
Brevets, modèles et marques déposés
/extraits_courts_inpi
Récupérer certaines informations sur les derniers brevets, modèles et marques d’une entreprise enregistrés à l’INPI ; ainsi que le nombre de dépôts pour chacune de ces catégories.
⚠️ Le périmètre de cet endpoint n’est pas exhaustif, les données doivent donc être utilisées de manière qualitative et indicative.
- Cas d’usage
- Périmètre
- Les brevets, marques et modèles enregistrés avec SIREN.
- Ouverture
- Données publiques.
Périmètre
-
Cet endpoint appelle les informations à partir d’un SIREN. Le SIREN étant une information facultative lors du dépôt de dossier à l’INPI, le taux de sirénage est donc incomplet.
Taux de sirénage des déposants (sur personnes morales FR) :
- Brevets France et brevets Europe délivrés : environ 80% sur les demandes de brevets publiées ces 20 dernières années ;
- Marques France : 60% ;
- Marques européennes : 0 % (marques déposées à l’EUIPO) ;
- Marques internationales : 0% (marques déposées à l’OMPI) ;
- Dessins & Modèles France : 50% ;
- Dessins & Modèles internationaux : 0% (dessins & modèles déposés à l’OMPI).
ℹ️ Pour information, seule la raison sociale compte lors du dépôt pour une personne morale.
Votre appel
- Paramètre d’appel :
- Le numéro de SIREN de la personne physique ou morale.
Requête HTTP
Swagger
https://entreprise.api.gouv.fr/v2/
extraits_courts_inpi/SirenDeL’Entreprise
?token=JetonD’Habilitation
&context=CadreDeLaRequête
&recipient=BénéficiaireDel’Appel
&object=RaisonDeL’AppelOuIdentifiant
La réponse de l’API
- Format :
- Donnée structurée JSON
- Timeout :
- 5 secondes
La réponse se compose de trois parties :
- les derniers brevets déposés (titre, date de publication, date de dépôt, numéro de publication) ;
- des derniers modèles déposés (titre, date de publication, date de dépôt, numéro d’identification)
- des dernières marques déposées (numéro d’identification, nom de la marque, statut de la marque, dépositaire, clé).
Chaque partie est introduite par le nombre total de dépôts effectués par l’entreprise.
⚠️ Les données présentes ne peuvent être considérées comme exhaustives.
Que conclure d'une absence de données ?
Actuellement, un retour vide peut avoir deux significations :
- soit le SIREN n’existe pas et est inconnu des services de l’INPI ;
- soit aucune donnée n’est enregistrée auprès du fournisseur pour cette société.
Vous pouvez si vous le souhaiter coupler vos appels avec une vérification de l’existence dans la base Sirene d’un SIREN en particulier qui permettra de trancher entre les deux options. À noter que certaines personnes peuvent demander à être retirées de la diffusion Sirene dans de très rares cas.
Réponse JSON
- Disponibilité actuelle :
-
OK
- Volumétrie :
- max. 250 requêtes/min/jeton cumulées sur tous les endpoints renvoyant du JSON.
- Disponibilité normale :
- 7jours/7 et 24h/24
- Indisponibilités types :
- /
Historique des 6 derniers mois :
- Nombre d'appel :
- Erreur fournisseur :
Dans une journée, l'endpoint fonctionne :
- au delà de 99,5%
- au delà de 90%
- au delà de 80%
- en dessous de 80%
- statistiques insuffisantes