---
openapi: 3.0.1
info:
title: API Entreprise
version: 3.0.0
description: "Cette page contient la documentation technique pour accéder à API
Entreprise. Les API étant accessible uniquement sous habilitation, l'interaction
avec l'environnement de production n'est possible que si vous êtes **en possession
d'une clé d'accès (jeton).\n\n### Comment tester l'API ?\n\nIl est possible de
tester les API via notre environnement de **staging** qui vous retournera systématiquement
des données fictives. Référez vous à la [documentation](https://entreprise.api.gouv.fr/developpeurs#tester-api-preproduction).\n\nIl
est nécessaire d'utiliser un jeton de staging. Plus d'infos ici: https://github.com/datagouv/apistration/tree/develop/mocks/tokens\n
\ "
termsOfService: https://entreprise.api.gouv.fr/cgu/
contact:
name: Support API Entreprise
email: support@entreprise.api.gouv.fr
url: https://entreprise.api.gouv.fr/
tags:
- name: Informations générales
- name: Informations financières
- name: Attestations sociales et fiscales
- name: Certifications professionnelles
- name: Propriété intellectuelle
- name: Disponibilité
- name: Jeton
paths:
"/v3/errors":
get:
summary: Nomenclature des codes erreurs
tags:
- Disponibilité
description: |-
Retourne la nomenclature complète des codes erreurs : les préfixes fournisseurs, les sous-codes communs, les codes de la plateforme et, pour chaque opération, les erreurs qu'elle peut renvoyer groupées par statut HTTP.
Cet endpoint **ne nécessite pas d'authentification**.
security: []
parameters:
- name: operation_id
in: query
required: false
description: Restreint `endpoints` à cette seule opération (valeur du `x-operationId`
d'un endpoint)
example: api_entreprise_v3_insee_unites_legales
schema:
type: string
responses:
'200':
description: Nomenclature des codes erreurs
content:
application/json:
schema:
type: object
properties:
api:
type: string
example: entreprise
providers:
type: object
description: Préfixe à deux chiffres de chaque fournisseur de
données
additionalProperties:
type: string
generic_subcodes:
type: object
description: Sous-codes communs à tous les fournisseurs
additionalProperties:
type: object
properties:
title:
type: string
detail:
type: string
platform_codes:
type: object
description: Erreurs groupées par statut HTTP
additionalProperties:
type: array
items:
type: object
properties:
code:
type: string
example: '04501'
title:
type: string
detail:
type: string
meta:
type: object
required:
- code
- title
- detail
endpoints:
type: object
additionalProperties:
type: object
properties:
provider:
type: string
errors:
type: object
description: Erreurs groupées par statut HTTP
additionalProperties:
type: array
items:
type: object
properties:
code:
type: string
example: '04501'
title:
type: string
detail:
type: string
meta:
type: object
required:
- code
- title
- detail
required:
- provider
- errors
required:
- api
- providers
- generic_subcodes
- platform_codes
- endpoints
'404':
description: Opération inconnue
content:
application/json:
examples:
operation_inconnue_00404:
value:
errors:
- code: '00404'
title: Opération inconnue
detail: Cette opération n'existe pas sur cette API (api_particulier_v3_cnav_prime_activite_with_civility)
source:
meta: {}
summary: Opération inconnue
description: Cette opération n'existe pas sur cette API (api_particulier_v3_cnav_prime_activite_with_civility)
schema:
"$ref": "#/components/schemas/Error"
"/v3/ping":
get:
summary: Ping de l'API
tags:
- Disponibilité
description: |-
Vérifie que l'API est accessible et fonctionnelle. Retourne un code HTTP 200 si l'API est opérationnelle.
Cet endpoint **ne nécessite pas d'authentification**.
security: []
responses:
'200':
description: L'API est opérationnelle
"/pings":
get:
summary: Liste des pings fournisseurs disponibles
tags:
- Disponibilité
description: |-
Retourne la liste des fournisseurs disposant d'un endpoint de ping, avec leur nom et l'URL du ping associé.
Cet endpoint **ne nécessite pas d'authentification**.
security: []
responses:
'200':
description: Liste des pings fournisseurs
content:
application/json:
schema:
type: array
items:
type: object
properties:
name:
type: string
description: Nom du fournisseur sur la page de statut
example: INSEE - Sirene
url:
type: string
description: URL du ping fournisseur
example: https://entreprise.api.gouv.fr/ping/insee/sirene
required:
- name
- url
"/ping/{provider}":
get:
summary: Ping d'un fournisseur de données
tags:
- Disponibilité
description: |-
Vérifie la disponibilité d'un fournisseur de données spécifique. Retourne le statut du fournisseur ainsi que la date de dernière vérification.
Cet endpoint **ne nécessite pas d'authentification**.
security: []
parameters:
- name: provider
in: path
required: true
description: Identifiant du fournisseur (tel que retourné par `/pings`)
example: insee/sirene
schema:
type: string
responses:
'200':
description: Le fournisseur est disponible
content:
application/json:
schema:
type: object
properties:
status:
type: string
enum:
- ok
- maintenance
- unknown
description: Statut du fournisseur
last_update:
type: string
format: date-time
description: Date de la dernière vérification
last_ok_status:
type: string
format: date-time
description: Date du dernier statut OK connu
until:
type: string
format: date-time
description: Date de fin de maintenance (uniquement si status=maintenance)
'404':
description: Fournisseur inconnu
"/privileges":
get:
summary: Privileges associés au jeton
description: Renvoi la liste des droits associé au jeton
security:
- jwt_bearer_token: []
responses:
'200':
description: Liste des droits
x-operationId: api_entreprise_privileges
'401':
description: Non autorisé
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
'403':
description: Accès interdit
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'409':
description: Conflit
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: Paramètre(s) invalide(s)
content:
application/json:
examples:
missing_mandatory_param_error:
value:
errors:
- code: '00203'
title: Entité non traitable
detail: Le paramètre recipient est obligatoire
source:
parameter: recipient
meta: {}
summary: Entité non traitable
description: Le paramètre recipient est obligatoire
schema:
"$ref": "#/components/schemas/Error"
'429':
description: Trop de requêtes
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/privileges"
"/v3/urssaf/unites_legales/{siren}/attestation_vigilance":
get:
summary: Attestation de vigilance
tags:
- Attestations sociales et fiscales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
deprecated: true
security:
- jwt_bearer_token: []
description: Attestation sociale délivrée à une entreprise acquittée de ses
obligations de cotisations et contributions sociales auprès de l'URSSAF Caisse
nationale.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/v3/attestation_vigilance#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/v3/attestation_vigilance#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/v3/attestation_vigilance#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise found
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). Le cache est valide jusqu'au lendemain
8h.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_acoss_attestations_sociales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
document_url:
type: string
title: URL de téléchargement de l'attestation de vigilance
description: "Ce lien délivre l'attestation de vigilance de
l'entreprise au format PDF. La date du document dépend de
la situation de chaque entreprise, et de la dernière déclaration
enregistrée dans le système. Elle est donc variable d'une
entreprise à l'autre. \n \n Plus d'informations sur le site
de l'URSSAF : https://www.urssaf.fr/portail/home/employeur/declarer-et-payer/obtenir-une-attestation/attestation-de-vigilance.html"
example: https://raw.githubusercontent.com/datagouv/apistration/refs/heads/develop/mocks/payloads/api_entreprise_v4_acoss_attestations_sociales/attestation_vigilance_test.pdf
expires_in:
type: integer
example: 7889238
description: 'Nombre de secondes avant l''expiration de l''url
associée à l''attribut document_url : cette durée correspond
généralement à 24h.'
required:
- document_url
- expires_in
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/v3/attestation_vigilance#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/v3/attestation_vigilance#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_04999:
value:
errors:
- code: '04999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: ACOSS
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Entreprise non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/v3/attestation_vigilance#erreurs.
content:
application/json:
examples:
entite_non_trouvee_04003:
value:
errors:
- code: '04003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: ACOSS
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/v3/attestation_vigilance#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '04002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: ACOSS
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/v3/attestation_vigilance#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/v3/attestation_vigilance#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '04020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: ACOSS
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/v3/attestation_vigilance#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/urssaf/unites_legales/130025265/attestation_vigilance?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/ademe/etablissements/{siret}/certification_rge":
get:
summary: Certification RGE
tags:
- Certifications professionnelles
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: limit
in: query
description: Limite le nombre de résultats retournés. Valeur entre 1 et 1000
(Défault 1000)
example: 100
schema:
type: number
security:
- jwt_bearer_token: []
description: Certifications RGE (Reconnu Garant de l'Environnement) d'un établissement,
délivrées par l'Ademe.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_ademe_certificats_rge, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ademe/certifications_rge#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_ademe_certificats_rge, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ademe/certifications_rge#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_ademe_certificats_rge, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ademe/certifications_rge#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
x-operationId: api_entreprise_v3_ademe_certificats_rge
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
data:
type: object
properties:
url:
title: URL Certificat
description: URL de téléchargement du certificat
type: string
example: https://raw.githubusercontent.com/datagouv/apistration/refs/heads/develop/mocks/payloads/api_entreprise_v3_ademe_certificats_rge/exemple-ademe-rge-certificat_qualibat.pdf
nom_certificat:
title: Nom du certificat
description: libéllé du certificat
type: string
example: Qualisol CESI
domaine:
title: Domaine de travaux
description: Domaine des travaux sur lesquelles porte
la qualification du certificat
type: string
enum:
- Fenêtres, volets, portes extérieures 2020
- Isolation du toit 2020
- Isolation des murs et planchers bas 2020
- Chaudière condensation ou micro-cogénération gaz ou
fioul 2020
- 'Equipements électriques hors ENR : chauffage, eau
chaude, éclairage 2020'
- Isolation par l'intérieur des murs ou rampants de
toitures ou plafonds
- Isolation des combles perdus
- 'Pompe à chaleur : chauffage'
- Fenêtres, volets, portes donnant sur l'extérieur
- Isolation des planchers bas
- Chaudière condensation ou micro-cogénération gaz ou
fioul
- Ventilation 2020
- Poêle ou insert bois
- Isolation des murs par l'extérieur
- Radiateurs électriques, dont régulation.
- Chauffe-Eau Thermodynamique
- Isolation des toitures terrasses ou des toitures par
l'extérieur
- Fenêtres de toit
- Chaudière bois
- Pompe à chaleur et/ou Chauffe-eau thermodynamique
2020
- Architecte
- Chauffage et/ou eau chaude solaire
- Panneaux solaires photovoltaïques
- Ventilation mécanique
- Chauffage et/ou eau chaude au bois 2020
- Audit énergétique
- Panneaux photovoltaïques 2020
- Etude thermique reglementaire
- Chauffage et/ou eau chaude solaire 2020
- Projet complet de rénovation
- Etude solaire photovoltaïque
- Etude bois énergie
- Etude forage géothermique
- Etude solaire thermique
- Etude système technique bâtiment
- Etude eclairage
- Forage géothermique
- Etude ACV
- Inconnu
- Non renseigné
- Etude enveloppe du bâtiment
- Commisionnement
meta_domaine:
title: Méta domaine
description: Le Méta domaine explicite le contexte de
la qualification du certificat
type: string
example: anciens domaines avant 2021
enum:
- anciens domaines avant 2021
- Travaux d'efficacité énergétique
- Installations d'énergies renouvelables
- Rénovation globale
- Etudes énergétiques
- Inconnu
- Non renseigné
qualification:
title: Qualification
description: Informations sur la qualification du présent
certificat
type: object
additionalProperties: false
properties:
code:
title: Code qualification
description: Code de la qualification du présent
certificat
type: string
example: '32'
nom:
title: Nom qualification
description: Nom de la qualification du présent
certificat
type: string
example: QualiPV Elec - Pose de générateur photovoltaïque
raccordé au réseau (32)
required:
- code
- nom
organisme:
title: Organisme de certification
description: Organisme ayant délivré le certificat
type: string
example: qualibat
enum:
- Non renseigné
- qualibat
- qualitenr
- cnoa
- opqibi
- qualifelec
- cequami
- certibat
- afnor
- Inconnu
date_attribution:
title: Date d'attribution
description: Date à laquelle a été attribué le certificat
type: string
example: '2020-12-24'
date_expiration:
title: Date d'expiration
description: Date à laquelle le présent certificat expire
type: string
example: '2025-08-01'
meta:
title: Informations ADEME
description: informations sur l'enregistrement de ce
certificat dans la base ADEME
type: object
additionalProperties: false
properties:
internal_id:
title: Identifiant interne
description: Identifiant unique du certificat dans
la base ADEME
type: string
example: Q112379-8611M12D10-2017-03-23
updated_at:
title: Date de mise à jour
description: Date à laquelle cette information à
été mise à jour dans la base ADEME
type: string
example: '2021-02-25'
archived:
title: Archivé
description: Indique si le présent certificat est
archivé dans la base ADEME et donc invalide. "True"
signifie archivé donc invalide.
type: boolean
example: false
required:
- internal_id
- updated_at
- archived
required:
- url
- nom_certificat
- domaine
- meta_domaine
- qualification
- organisme
- date_attribution
- date_expiration
- meta
links:
type: object
meta:
type: object
meta:
type: object
links:
type: object
required:
- data
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_ademe_certificats_rge, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ademe/certifications_rge#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_ademe_certificats_rge, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ademe/certifications_rge#erreurs.
content:
application/json:
examples:
entite_non_trouvee_19003:
value:
errors:
- code: '19003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: ADEME
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_ademe_certificats_rge, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ademe/certifications_rge#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_19999:
value:
errors:
- code: '19999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: ADEME
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_ademe_certificats_rge, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ademe/certifications_rge#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '19002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: ADEME
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_ademe_certificats_rge, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ademe/certifications_rge#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_ademe_certificats_rge, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ademe/certifications_rge#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '19020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: ADEME
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_ademe_certificats_rge, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ademe/certifications_rge#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/ademe/etablissements/13002526500013/certification_rge?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/banque_de_france/unites_legales/{siren}/bilans":
get:
summary: 3 derniers bilans annuels
tags:
- Informations financières
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: siren
in: path
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Obtenir les trois derniers bilans d’une entreprise détenus par
la Banque de France.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_banque_de_france_bilans_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/banque_de_france/bilans#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_banque_de_france_bilans_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/banque_de_france/bilans#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_banque_de_france_bilans_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/banque_de_france/bilans#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). Le cache est valide jusqu'à la
fin de la journée.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_banque_de_france_bilans_entreprise
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
data:
type: object
properties:
annee:
title: Année du bilan
type: string
example: '2020'
date_arrete_exercice:
title: Date d’arrêté de l’exercice
description: Le format est YYYY-MM, le jour du mois
n'est pas renseigné.
type: string
example: '202012'
valeurs_calculees:
type: array
items:
type: object
additionalProperties: false
properties:
disponibilites:
type: object
additionalProperties: false
title: Disponibilités
description: "Correspond aux disponibilités présentés
à l'actif du bilan diminués des provisions constatées
sur ce poste. \n Les disponibilités font référence
à toutes les formes de trésorerie dont l'entreprise
est capable de disposer instantanément, il s'agit
de l'actif liquide de l'entreprise. \n Les disponibilités
peuvent servir à financer le besoin en fonds
de roulement d'exploitation."
properties:
valeur:
title: Valeur en euros
type: string
example: '9001'
evolution:
title: Évolution en pourcentage
type: number
example: 12.34
nullable: true
total_dettes_stables:
type: object
additionalProperties: false
title: Total des dettes stables
properties:
valeur:
title: Valeur en euros
type: string
example: '9001'
evolution:
title: Évolution en pourcentage
type: number
example: 12.34
nullable: true
valeur_ajoutee_bdf:
type: object
additionalProperties: false
title: Valeur ajoutée
description: 'La valeur ajoutée est un solde intermédiaire
de gestion issu du compte de résultat définie
comme tel : il correspond à la différence entre
la valeur finale de la production (valorisée
par le chiffre d''affaires) et la valeur des
biens qui ont été consommés par le processus
de production (consommations intermédiaires,
comme les matières premières).'
properties:
valeur:
title: Valeur en euros
type: string
example: '9001'
evolution:
title: Évolution en pourcentage
type: number
example: 12.34
nullable: true
besoin_en_fonds_de_roulement:
type: object
additionalProperties: false
title: Besoin en fonds de roulement
description: Représente le montant nécessaire
au financement du cycle d'exploitation qui est
né du décalage entre les encaissements (clients)
et les décaissements (fournisseurs, salaires
et charges sociales) et du portage des stocks
avant leur utilisation dans le cycle de production
ou de commercialisation.
properties:
valeur:
title: Valeur en euros
type: string
example: '9001'
evolution:
title: Évolution en pourcentage
type: number
example: 12.34
nullable: true
excedent_brut_exploitation:
type: object
additionalProperties: false
title: Excédent brut d’exploitation
description: "Solde intermédiaire de gestion issu
du compte de résultat défini comme tel : il
correspond principalement à la différence entre
la valeur ajoutée augmentée des subventions
d'exploitation et diminuées de la charge du
personnel et des impôts et taxes. \n Il mesure
la rentabilité d'exploitation brute de l'entreprise"
properties:
valeur:
title: Valeur en euros
type: string
example: '9001'
evolution:
title: Évolution en pourcentage
type: number
example: 12.34
nullable: true
capacite_autofinancement:
type: object
additionalProperties: false
title: Capacité d’autofinancement
description: "Correspond à la somme du résultat
net et des charges non décaissables diminuées
des produits non encaissables (les éléments
non décaissables et non encaissables correspondent
essentiellement aux dotations nettes aux amortissements
et aux provisions). \n La capacité d'autofinancement
représente l'essentiel du flux de trésorerie
d'exploitation généré par l'entreprise. Elle
contribue au financement des dépenses autres
que celles enregistrées dans le compte de résultat
(dividendes, investissements, remboursement
emprunts etc...)"
properties:
valeur:
title: Valeur en euros
type: string
example: '9001'
evolution:
title: Évolution en pourcentage
type: number
example: 12.34
nullable: true
fonds_roulement_net_global:
type: object
additionalProperties: false
title: Fonds de roulement net global
description: Correspond à la part des capitaux
permanents non absorbée par le financement des
valeurs immobilisées et qui est disponible pour
le financement des besoins lié au cycle d'exploitation
(besoins en fonds de roulement) (1) Capitaux
permanents = capitaux propres + autres fonds
propres + prov. pour risques et charges + total
dettes financieres - dettes financières CT à
l'origine (concours bancaires courants et soldes
créditeurs de banque notamment)
properties:
valeur:
title: Valeur en euros
type: string
example: '9001'
evolution:
title: Évolution en pourcentage
type: number
example: 12.34
nullable: true
ratio_fonds_roulement_net_global_sur_besoin_en_fonds_de_roulement:
type: object
additionalProperties: false
title: Ratio fonds de roulement net global sur
besoin en fonds de roulement
properties:
valeur:
title: Valeur en pourcentage
type: number
example: 23.45
evolution:
title: Évolution en pourcentage
type: number
example: 12.34
nullable: true
dettes4_maturite_a_un_an_au_plus:
type: object
additionalProperties: false
title: Dettes à maturité à un an au plus
description: Correspond à la somme des références
fiscales 2057VG2 et 2057VH2
properties:
valeur:
title: Valeur en euros
type: string
example: '9001'
evolution:
title: Évolution en pourcentage
type: number
example: 12.34
nullable: true
declarations:
type: array
items:
type: object
additionalProperties: false
required:
- numero_imprime
- donnees
properties:
numero_imprime:
title: Numéro d'imprimé
type: string
description: Numéro du formulaire de la liasse
fiscale souscrit par unité légale.
example: '2051'
donnees:
type: array
items:
type: object
additionalProperties: false
title: Données de l'imprimé
description: Chaque entrée du tableau correspondant
à couple code / valeur, spécifique au numéro
d'imprimé référencé à la clé `numero_imprime`
required:
- code_nref
- valeurs
- evolution
properties:
code:
title: Code
type: string
description: Code permettant d'identifier
la donnée, constitué de 2 lettres de AA
à ZZ (cf. Code EDI)
example: GR
code_EDI:
title: Code EDI
type: string
description: 'Le code EDI est utilisé lorsque
la liasses fiscale a été souscrite via
la filière EDI/TDFC. Il permet l’échange
des données de nature comptable et/ou
fiscale avec la norme EDIFACT entre la
DGFIP et les utilisateurs des téléprocédures
EDI '
example: GR:C889:7111:1:TBX
evolution:
title: Évolution de la donnée
type: number
example: 4.56
nullable: true
code_absolu:
title: Code absolu
type: string
description: Ce code interne à la DGFIP
identifie une seule donnée sur un seul
formulaire
example: '2006744'
code_type_donnee:
title: Code Type Donnée
description: Ce code détermine la nature
de la donnée, le nombre et type des caractères
qu’elle peut contenir
type: string
example: CCI
intitule:
title: Intitulé
description: Intitulé de la donnée. Désigne
une donnée correspondant à une case à
cocher présente en haut de certains tableaux
de la liasse fiscale
type: string
example: Déposé néant
code_nref:
title: A un code N-REF correspond un code
absolu pour les liasses fiscales. Ces
deux codes désignent une seule donnée
présente sur un seul formulaire
type: string
example: '304651'
valeurs:
title: Valeurs associés à l'entrée
description: Si une entrée de l'imprimé
est répétable, le tableau contient plusieurs
entrées et sont ordonnées en fonction
de l'indice de répétition.
type: array
minItems: 1
items:
type: string
example:
- '4245'
required:
- annee
- date_arrete_exercice
- valeurs_calculees
- declarations
links:
type: object
meta:
type: object
meta:
type: object
properties:
count:
title: Nombre de bilans
type: integer
example: 1
required:
- count
additionalProperties: false
links:
type: object
required:
- data
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_banque_de_france_bilans_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/banque_de_france/bilans#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_banque_de_france_bilans_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/banque_de_france/bilans#erreurs.
content:
application/json:
examples:
entite_non_trouvee_17003:
value:
errors:
- code: '17003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: Banque de France
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_banque_de_france_bilans_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/banque_de_france/bilans#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_17999:
value:
errors:
- code: '17999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: Banque de France
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_banque_de_france_bilans_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/banque_de_france/bilans#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '17002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: Banque de France
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_banque_de_france_bilans_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/banque_de_france/bilans#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_banque_de_france_bilans_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/banque_de_france/bilans#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '17020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: Banque de France
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_banque_de_france_bilans_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/banque_de_france/bilans#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-maintenances:
from_hour: '22:04'
to_hour: '22:08'
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/banque_de_france/unites_legales/130025265/bilans?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/carif_oref/etablissements/{siret}/certifications_qualiopi_france_competences":
get:
summary: Qualiopi & habilitations France compétences
tags:
- Certifications professionnelles
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Certifications Qualiopi et habilitations France compétences attestant
que l'établissement est habilité à délivrer une formation certifiante.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_carif_oref_certifications_qualiopi_france_competences, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/carif_oref/certifications_qualiopi_france_competences#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_carif_oref_certifications_qualiopi_france_competences, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/carif_oref/certifications_qualiopi_france_competences#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_carif_oref_certifications_qualiopi_france_competences, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/carif_oref/certifications_qualiopi_france_competences#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_carif_oref_certifications_qualiopi_france_competences
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siret:
title: Siret de l'établissement
type: string
example: '12000101100010'
code_uai:
title: Code UAI de l'établissement
description: Code UAI de l'établissement agrée. Cet identifiant
unique est affecté aux établissements de l'éducation nationale.
example: 0123456A
type: string
nullable: true
unite_legale_avec_plusieurs_nda:
title: Indique si l'unité légale de l'établissement a plusieurs
NDA
description: Dans de rares cas, l'unité légale d'un établissement
peut avoir plusieurs numéros de déclaration d'activité (NDA).
Tous ces numéros d'activités (qui ne sont pas fournis par
cette API délivrant uniquement les NDA d'un établissement)
ne sont pas forcément propagés sur les établissements.
example: false
nullable: false
type: boolean
declarations_activites_etablissement:
type: array
description: Informations relatives au numéro de déclaration
d'activité de l'établissement (NDA) si celui-ci en possède
un. Cette clé renvoie un tableau car, dans de rares cas,
un établissement peut avoir plusieurs NDA (environ 30 établissements
sur 120 000).
items:
type: object
properties:
numero_de_declaration:
title: Numéro de déclaration d'activité
description: Numéro de déclaration d'activité (NDA)
de l'établissement.
type: string
example: '11910843391'
actif:
title: Indique que le NDA est actif
description: Ce champ indique le numéro de déclaration
d'activité (NDA) de l'établissement est actif. Cette
valeur est toujours égale à 'true' et est conservée
pour des raisons de retrocompatibilité
type: boolean
example: true
date_derniere_declaration:
title: Date de dernière déclaration
description: Cette date indique le jour où l'établissement
a transmi son bilan pédagogique et financier (BPF),
indispensable pour maintenir actif le numéro de déclaration
d'activité (NDA). Cette date est transmise au format
AAAA-MM-DD.
type: string
format: date
example: '2021-01-30'
date_debut_exercice:
title: Date de début d'exercice fiscal
description: Cette date correspond au début du dernier
exercice fiscal analysé pour le bilan pédagogique
et financier. Cette date est transmise au format AAAA-MM-DD.
type: string
format: date
example: '2021-01-30'
date_fin_exercice:
title: Date de fin d'exercice fiscal
description: Cette date correspond à la fin du dernier
exercice fiscal analysé pour le bilan pédagogique
et financier. Cette date est transmise au format AAAA-MM-DD.
type: string
format: date
example: '2021-01-30'
certification_qualiopi:
type: object
description: Informations relatives à la certification
Qualiopi. Cette certification est liée à une numéro
de déclaration d'activité.
properties:
action_formation:
title: Certication Action Formation
description: Indique si l'établissement est certifié
Action Formation.
type: boolean
example: false
bilan_competences:
title: Certification Bilan Compétences
description: Indique si l'établissement est certifié
Bilan Compétences.
type: boolean
example: false
validation_acquis_experience:
title: Certification VAE
description: Indique si l'établissement est certifié
VAE (Validation des Acquis de l'Experience).
type: boolean
example: false
apprentissage:
title: Certification Apprentissage
description: Indique si l'établissement est certifié
Action de Formation par Apprentissage.
type: boolean
example: false
obtention_via_unite_legale:
title: Indique si le certificat Qualiopi est propagé
depuis le SIREN de l'unité légale
description: 'Lorsqu''une unité légale a un seul
NDA et donc un seul Qualiopi, celui-ci est automatiquement
propagé à tous ses établissements, d''après les
règles de la délégation générale à l''emploi et
à la formation professionnelle (DGEFP), ce champ
est alors à `true` et indique que le NDA associé
à l''établissement est issu de l''unité légale.
Dans le cas contraire, si le NDA ne provient pas
d''une propagation depuis le SIREN, ce champ est
à `false`. Ce second cas est bien plus rare car
il intervient lorsqu''il existe plusieurs NDA
associés à plusieurs SIRET, la propagation est
alors uniquement faite pour certains SIRET déclarés.
Enfin, ce champ peut être à "null" si l''organisme
n''a pas fait de demande Qualiopi.
'
type: boolean
example: true
nullable: true
specialites:
type: object
description: 'Informations relatives aux spécialités
relevant du numéro de déclaration d''activité et figurant
dans le bilan pédagogique et financier. Un établissement
peut ne pas avoir de spécialités, et l''API en transmet
jusqu''à trois, leur ordre n''a pas d''importance.
Les spécialités possibles sont détaillées dans la
documentation métier de l''API : https://entreprise.api.gouv.fr/catalogue/carif_oref/certifications_qualiopi_france_competences#faq_entry_answer_1_api_entreprise_endpoint_carif_oref_certifications_qualiopi_france_competences'
properties:
specialite_1:
type: object
description: Informations relatives à la première
spécialité
properties:
code:
title: Code spécialité 1
description: Code de la première spécialité
de l'établissement agrée
type: string
example: '313'
nullable: true
libelle:
title: Libellé spécialité 1
description: Libellé de la première spécialité
de l'établissement agrée
type: string
example: Finances, banque, assurances
nullable: true
specialite_2:
type: object
description: Informations relatives à la seconde
spécialité
properties:
code:
title: Code spécialité 2
description: Code de la seconde spécialité de
l'établissement agrée
type: string
example: '326'
nullable: true
libelle:
title: Libellé spécialité 2
description: Libellé de la seconde spécialité
de l'établissement agrée
type: string
example: Informatique, traitement de l'information,
réseaux de transmission des données
nullable: true
specialite_3:
type: object
description: Informations relatives à la troisième
spécialité
properties:
code:
title: Code spécialité 3
description: Code de la troisième spécialité
de l'établissement agrée
type: string
example: '327'
nullable: true
libelle:
title: Libellé spécialité 3
description: Libellé de la troisième spécialité
de l'établissement agrée
type: string
nullable: true
example: Langues
habilitations_france_competence:
type: array
description: Informations relatives aux habilitations France
Compétences obtenues par l'établissement lorsque celui-ci
a demandé à être certifié. La liste des habilitations France
Compétences n'est pas figée et est mise à jour régulièrement
par les organismes certificateurs.
items:
type: object
properties:
code:
title: Code de l'habilitation
description: Code de l'habilitation France Compétences.
type: string
example: RNCP10013
actif:
title: Indique si l'habilitation est active
description: 'Une habilitation est active lorsque l''enregistrement
de la certification en en cours. '
type: boolean
example: true
date_actif:
title: Date à laquelle l'habilitation est passée en
état active
type: string
format: date
nullable: true
example: '2030-01-30'
date_fin_enregistrement:
title: Date de fin d'enregistrement
description: Date de fin d'enregistrement de l'habilitation
de l'établissement agrée. Cette date est transmise
au format AAAA-MM-DD.
type: string
format: date
nullable: true
example: '2030-01-30'
date_decision:
title: Date de décision
description: Date de décision de l'habilitation de l'établissement
agrée. Cette date est transmise au format AAAA-MM-DD.
type: string
format: date
nullable: true
example: '2020-01-30'
habilitation_pour_former:
title: Habilitation à former
description: Indique que cette habilitation autorise
à former/préparer les candidats à une certification
inscrite au répertoire national des compétences professionnelles
(RNCP) ou au répertoire spécifique (RS). Cette habilitation
vise à s'assurer que les organismes de formation proposant
des offres de formation certifiantes, sont bien habilités
à préparer des élèves à cette certification.
type: boolean
example: true
habilitation_pour_organiser_l_evaluation:
title: Habilitation à organiser l'évaluation
description: Indique que cette habilitation autorise
à mettre en place des épreuves pour évaluer les compétences
des candidats visant une certification inscrite au
répertoire national des compétences professionnelles
(RNCP) ou au répertoire spécifique (RS).
type: boolean
example: true
sirets_organismes_certificateurs:
type: array
description: Liste des SIRETs des organismes certificateurs
ayant délivré à l'établissement les habilitations
à former et/ou organiser l'évaluation de leur certification.
items:
type: string
example: '12345678901234'
required:
- siret
- code_uai
- unite_legale_avec_plusieurs_nda
- declarations_activites_etablissement
- habilitations_france_competence
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_carif_oref_certifications_qualiopi_france_competences, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/carif_oref/certifications_qualiopi_france_competences#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_carif_oref_certifications_qualiopi_france_competences, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/carif_oref/certifications_qualiopi_france_competences#erreurs.
content:
application/json:
examples:
entite_non_trouvee_33003:
value:
errors:
- code: '33003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: CARIF-OREF
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_carif_oref_certifications_qualiopi_france_competences, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/carif_oref/certifications_qualiopi_france_competences#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_33999:
value:
errors:
- code: '33999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: CARIF-OREF
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_carif_oref_certifications_qualiopi_france_competences, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/carif_oref/certifications_qualiopi_france_competences#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '33002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: CARIF-OREF
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_carif_oref_certifications_qualiopi_france_competences, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/carif_oref/certifications_qualiopi_france_competences#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_carif_oref_certifications_qualiopi_france_competences, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/carif_oref/certifications_qualiopi_france_competences#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '33020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: CARIF-OREF
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_carif_oref_certifications_qualiopi_france_competences, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/carif_oref/certifications_qualiopi_france_competences#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/carif_oref/etablissements/13002526500013/certifications_qualiopi_france_competences?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/cibtp/etablissements/{siret}/attestation_cotisations_conges_payes_chomage_intemperies":
get:
summary: Certificat cotisations CIBTP
tags:
- Attestations sociales et fiscales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siret
in: path
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Certificat indiquant qu'une entreprise du bâtiment, affiliée à
la majorité des caisses du réseau CIBTP France, est en règle de ses cotisations
congés payés et chômage-intempéries.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cibtp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cibtp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cibtp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
document_url:
title: Lien vers le certificat CIBTP
type: string
nullable: true
description: Ce lien délivre l'attestation au format PDF.
Ce document est automatiquement supprimé après 10 minutes.
example: https://raw.githubusercontent.com/datagouv/apistration/refs/heads/develop/mocks/payloads/api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies/test_cibtp_certificat.pdf
expires_in:
title: Expiration du lien
description: Nombre de secondes avant expiration du document
référencé dans 'document_url'. Il s'agit d'une expiration
technique. Ce champ n'est pas une date de fin de validité
de l'attestation
type: integer
nullable: true
example: 600
required:
- document_url
- expires_in
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cibtp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cibtp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
schema:
"$ref": "#/components/schemas/Error"
examples:
erreur_inconnue_du_fournisseur_de_donnees_38999:
value:
errors:
- code: '38999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: CIBTP
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cibtp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
attestation_non_disponible_38422:
value:
errors:
- code: '38422'
title: Attestation non disponible
detail: L'attestation ne peut être délivrée car l'entreprise
n'est pas en règle de ses cotisations CIBTP.
source:
meta:
provider: CIBTP
summary: Attestation non disponible
description: L'attestation ne peut être délivrée car l'entreprise
n'est pas en règle de ses cotisations CIBTP.
entite_non_trouvee_38003:
value:
errors:
- code: '38003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: CIBTP
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cibtp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '38002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: CIBTP
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cibtp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cibtp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '38020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: CIBTP
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cibtp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cibtp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/cibtp/etablissements/13002526500013/attestation_cotisations_conges_payes_chomage_intemperies?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/cnetp/unites_legales/{siren}/attestation_cotisations_conges_payes_chomage_intemperies":
get:
summary: Certificat cotisations CNETP
tags:
- Attestations sociales et fiscales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren
in: path
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Certificat indiquant qu'une entreprise de travaux publics affiliée
à la caisse CNETP est en règle de ses cotisations congés payés et chômage-intempéries.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cnetp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cnetp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cnetp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Certificat trouvé
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
document_url:
type: string
title: Lien vers le certificat CNETP
description: Ce lien délivre l'attestation au format PDF.
Ce document est automatiquement supprimé après 24h.
example: https://raw.githubusercontent.com/datagouv/apistration/refs/heads/develop/mocks/payloads/api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies/test_cnetp_certificat.pdf
expires_in:
type: integer
example: 7889238
description: 'Nombre de secondes avant l''expiration de l''url
associée à l''attribut document_url : cette durée correspond
généralement à 24h.'
required:
- document_url
- expires_in
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cnetp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cnetp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_08999:
value:
errors:
- code: '08999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: CNETP
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cnetp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
entite_non_trouvee_08003:
value:
errors:
- code: '08003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: CNETP
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cnetp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '08002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: CNETP
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cnetp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cnetp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '08020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: CNETP
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_cnetp_attestation_cotisations_conges_payes_chomage_intemperies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cnetp/attestations_cotisations_conges_payes_chomage_intemperies#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-maintenances:
from_hour: '06:00'
to_hour: '06:30'
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/cnetp/unites_legales/130025265/attestation_cotisations_conges_payes_chomage_intemperies?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/data_subvention/associations/{siren_or_siret_or_rna}/subventions":
get:
summary: Subventions des associations
tags:
- Subventions des associations
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren_or_siret_or_rna
in: path
description: Siren, Siret ou RNA de l'association dont vous souhaitez obtenir
les subventions.
example: '12345678901234'
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Listes des subventions accordées et distribuées aux associations
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_data_subvention_subventions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/data_subvention/subventions#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_data_subvention_subventions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/data_subvention/subventions#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_data_subvention_subventions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/data_subvention/subventions#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_data_subvention_subventions
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
data:
type: object
properties:
demande_subvention:
title: Liste des demandes de subventions de l'association
et leur informations.
type: object
nullable: true
properties:
fournisseur:
title: Fournisseur distribuant la donnée à Data
Subvention
description: Origine de la donnée transmise (OSIRIS,
Chorus, etc.)
type: string
example: OSIRIS
date_mise_a_jour_information:
title: Date de dernière mise à jour
description: Date de dernière mise à jour des informations.
La fréquence d'actualisation des données varie
selon le fournisseur, elle est décrite dans la
fiche métier de l'API.
type: string
format: date-time
example: '2019-01-01T00:00:00.000Z'
annee_exercice_demande:
title: Année de la demande de subvention
description: Année durant laquelle la subvention
a été demandée par l'association.
type: number
example: 2019
identifiant_engagement_juridique:
title: Numéro EJ
description: Numéro d'engagement juridique (EJ)
associé à la demande. Cet identifiant est présent
pour toutes les demandes de subventions, sauf
celles issues du FONJEP.
type: string
nullable: true
example: 19/0003456
jointure_demandes_et_versements:
title: Identifiant de jointure entre demande et
versement
description: Identifiant créé par DataSubvention
pour faire le lien entre une demande figurant
dans cette liste et un paiement figurant dans
la liste suivante. Pour toutes les demandes de
subventions, sauf celle issues du FONJEP, cet
identifiant est identique au numéro EJ. Pour les
demandes issues du FONJEP, ce numéro correspond
au code poste.
type: string
nullable: true
example: 19/0003456
subvention_demandee:
title: Informations sur la subvention demandée
type: object
properties:
dispositif:
title: Nom du dispositif
type: string
example: ANS - Projets Sportifs Territoriaux
sous_dispositif:
title: Nom du sous-dispositif
type: string
example: Aides territoriales (hors emploi)
montant_demande:
title: Montant de subvention demandé
description: Montant en euros de subvention
demandé par l'association.
type: number
example: 2000
required:
- dispositif
- sous_dispositif
- montant_demande
description_des_projets:
title: Éléments déclaratifs des projets
description: Description détaillée par l'association
des projets qui visent à être financés par l'association.
type: object
properties:
estimation_cout_total:
title: Estimation du coût total du projet
description: Lorsqu'il est renseigné, ce montant
indique le coût global du ou des projets évalué
par le déclarant afin d'informer l'instructeur
de l'ampleur du projet.
type: number
example: 8500
projet:
title: Liste des projets et actions proposés
type: array
items:
title: Détails d'un projet ou action proposée
type: object
properties:
rang:
title: Rang du projet
description: Numéro d'ordre du projet
par rapport aux autres projets.
type: number
example: 1
intitule:
title: Titre du projet
type: string
example: Développement du football féminin
objectifs:
title: Objectif du projet
description: Description de l'objectif
du projet
type: string
example: Notre objectif est de continuer
à faire connaitre [...]
objectifs_operationnels:
title: Objectifs opérationnels
type: string
example: Développement de la pratique
description:
title: Description détaillée du projet
type: string
example: Depuis plusieurs années nous
intervenons auprès [...]
aide:
title: Description de l'aide
description: TODO
type: object
properties:
nature:
title: Type d'aide
type: string
example: Projets sportifs territoriaux
modalite:
title: Modalité d'aide
type: string
example: Aide au projet
modalite_ou_dispositif:
title: Modalité ou dispositif
type: string
example: Développer la pratique féminine
indicateurs:
title: Indicateurs de performance
type: string
nullable: true
cofinanceurs:
title: Co-financeurs
description: Co-financeurs séparés par
';'
type: string
example: Conseil départemental du Nord;Ville
de Lille;Fédération française d'aviron
- Hauts-de-France
required:
- estimation_cout_total
- projet
instruction:
title: Informations et résultats de l'instruction
de la demande
type: object
properties:
service_instructeur:
title: Code du service instructeur
description: TODO
type: string
example: DD59
date_commission:
title: Date de commission
description: Date à laquelle la commission d'instruction
a eu lieu.
type: string
format: date-time
nullable: true
example: '2019-06-15T00:00:00.000Z'
statut_demande:
title: Statut de la demande
description: Statut de la demande accordé par
le service instructeur.
type: string
enum:
- Accordé
- En instruction
- Refusé
- En attente
example: Accordé
montant_accorde:
title: Montant accordé à l'association
description: Montant en euros de la subvention
accordée à l'association.
type: number
example: 1800
required:
- service_instructeur
- date_commission
- statut_demande
- montant_accorde
required:
- fournisseur
- date_mise_a_jour_information
- annee_exercice_demande
- identifiant_engagement_juridique
- jointure_demandes_et_versements
- subvention_demandee
- description_des_projets
- instruction
paiements:
title: Liste des paiements effectués
type: array
items:
title: Informations du paiement effectué
type: object
properties:
fournisseur:
title: Fournisseur distribuant la donnée à Data
Subvention
description: Origine de la donnée transmise, il
s'agit toujours de Chorus.
type: string
example: Chorus
date_mise_a_jour_information:
title: Date de dernière mise à jour
description: Date de dernière mise à jour des
informations. Les données de Chorus sont mises
à jour tous les lundis.
type: string
format: date-time
example: '2021-03-15T00:00:00.000Z'
jointure_demandes_et_versements:
title: Identifiant de jointure entre demande et
versement
description: Identifiant créé par DataSubvention
pour faire le lien entre un paiement figurant
dans cette liste et une demande figurant dans
la liste précédente.
type: string
nullable: true
example: 19/0003456
montant_verse:
title: Montant versé
description: Montant en euros qui a été versé
à l'association.
type: number
example: 1250
date_versement:
title: Date de versement
description: Date du versement à l'association.
type: string
format: date-time
example: '2021-03-15T00:00:00.000Z'
centre_financier:
title: Nom du centre financier
description: Centre ayant effectué le versement
de la subvention. Il ne s'agit pas forcément
de celui qui donne la subvention.
type: string
example: UO Region BFC-FC
domaine_fonctionnel:
title: Domaine fonctionnel
type: string
example: sport handicap
activitee:
title: Type d'activité
type: string
example: handisport
numero_bop:
title: Numéro BOP
description: Numéro du budget opérationnel de
programme (BOP) qui détermine la catégorie du
poste de dépense de l'État.
type: string
example: '219'
programme:
title: Programme budgétaire
description: Libellé et numéro du programme budgétaire
auquel est rattaché le versement. Ces informations
sont tirées du fournisseur Data Bretagne à partir
du numéro BOP du versement.
type: object
properties:
numero:
title: Numéro de programme
type: string
example: '219'
libelle:
title: Nom du programme
type: string
example: Sport
fournisseur:
title: Fournisseur distribuant la donnée à
Data Subvention
description: Origine de la donnée transmise,
il s'agit toujours de Data Bretagne.
type: string
example: OSIRIS
date_mise_a_jour_information:
title: Date de dernière mise à jour
description: Date de dernière mise à jour
des informations.
type: string
format: date-time
example: '2019-01-01T00:00:00.000Z'
required:
- demande_subvention
- paiements
links:
type: object
meta:
type: object
meta:
type: object
links:
type: object
required:
- data
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_data_subvention_subventions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/data_subvention/subventions#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00330'
title: Entité non traitable
detail: Le numéro de siren ou le numéro de siret ou le numéro
d'association indiqué n'est pas correctement formatté
source:
parameter: id
meta: {}
summary: Entité non traitable
description: Le numéro de siren ou le numéro de siret ou le numéro
d'association indiqué n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_data_subvention_subventions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/data_subvention/subventions#erreurs.
content:
application/json:
examples:
entite_non_trouvee_52003:
value:
errors:
- code: '52003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: DataSubvention
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_data_subvention_subventions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/data_subvention/subventions#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_52999:
value:
errors:
- code: '52999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: DataSubvention
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_data_subvention_subventions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/data_subvention/subventions#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '52002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: DataSubvention
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_data_subvention_subventions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/data_subvention/subventions#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_data_subvention_subventions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/data_subvention/subventions#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '52020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: DataSubvention
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_data_subvention_subventions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/data_subvention/subventions#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/data_subvention/associations/13002526500013/subventions?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/douanes/etablissements/{siret_or_eori}/immatriculations_eori":
get:
summary: Immatriculation EORI
tags:
- Informations générales
parameters:
- name: siret_or_eori
in: path
description: Siret ou numéro EORI de l'entreprise
examples:
french_siret:
value: '16002307300010'
summary: Siret français
french_eori:
value: FR16002307300010
summary: Numéro EORI français
spanish_eori:
value: ESA08536583
summary: Numéro EORI espagnol
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: État du numéro EORI d'une entreprise indiquant si celle-ci est
immatriculée auprès des douanes dans le cadre de l’import/export en Union
Européenne.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgddi_eori, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/douanes/immatriculation_eori#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgddi_eori, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/douanes/immatriculation_eori#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entité trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_dgddi_eori
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
id:
title: Identifiant EORI
description: 'Numéro EORI (Economic Operator Registration
and Identification) de l''entité: un numéro unique communautaire
permettant d’identifier chaque opérateur économique dans
ses relations avec les autorités douanières.'
type: string
example: FR16002307300010
actif:
title: Actif
type: boolean
description: Indique si ce numéro est encore actif (true)
ou non (false)
example: true
code_pays:
title: Code Pays
type: string
example: FR
code_postal:
title: Code Postal
type: string
example: '95520'
libelle:
title: Libellé de l'entité
type: string
description: Libellé de l'entreprise tel que connu par les
douanes, équivalent à la Raison Sociale pour une entreprise
Française.
example: CENTRE INFORMATIQUE DOUANIER
pays:
title: Pays
type: string
description: Pays de résidence de l'établissement telle que
connue par les douanes
example: FRANCE
rue:
title: Rue
type: string
description: Rue de l'établissement telle que connue par les
douanes
example: 27 R DES BEAUX SOLEILS
ville:
title: Ville
type: string
description: Ville de l'établissement telle que connue par
les douanes
example: OSNY
required:
- id
- actif
- code_pays
- code_postal
- libelle
- pays
- rue
- ville
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgddi_eori, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/douanes/immatriculation_eori#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00304'
title: Entité non traitable
detail: Le numéro de siret ou le numéro EORI n'est pas correctement
formatté
source:
parameter: id
meta: {}
summary: Entité non traitable
description: Le numéro de siret ou le numéro EORI n'est pas correctement
formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgddi_eori, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/douanes/immatriculation_eori#erreurs.
content:
application/json:
examples:
entite_non_trouvee_16003:
value:
errors:
- code: '16003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: DGDDI
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgddi_eori, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/douanes/immatriculation_eori#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_16999:
value:
errors:
- code: '16999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: DGDDI
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgddi_eori, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/douanes/immatriculation_eori#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '16002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: DGDDI
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgddi_eori, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/douanes/immatriculation_eori#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgddi_eori, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/douanes/immatriculation_eori#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgddi_eori, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/douanes/immatriculation_eori#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '16020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: DGDDI
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgddi_eori, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/douanes/immatriculation_eori#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/douanes/etablissements/13002526500013/immatriculations_eori?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/dgfip/unites_legales/{siren}/attestation_fiscale":
get:
summary: Attestation fiscale
deprecated: true
tags:
- Attestations sociales et fiscales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Attestation fiscale délivrée par la Direction générale des finances
publiques (DGFIP), indiquant que l’entreprise est à jour de ses obligations
fiscales.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/attestations_fiscales#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/attestations_fiscales#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/attestations_fiscales#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Attestation fiscale trouvée
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). Le cache est valide jusqu'au lendemain
8h.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_dgfip_attestations_fiscales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
document_url:
type: string
title: URL de téléchargement de l'attestation fiscale (.pdf)
description: Ce lien donne accès à l'attestation fiscale au
format PDF.
example: https://entreprise.api.gouv.fr/files/attestation-fiscale-dgfip-exemple.pdf
expires_in:
type: integer
example: 7889238
description: 'Nombre de secondes avant l''expiration de l''url
associée à l''attribut document_url : cette durée correspond
généralement à 24h.'
required:
- document_url
- expires_in
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/attestations_fiscales#erreurs.
content:
application/json:
examples:
entite_non_trouvee_03003:
value:
errors:
- code: '03003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: DGFIP - Adélie
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/attestations_fiscales#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/attestations_fiscales#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_03999:
value:
errors:
- code: '03999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: DGFIP - Adélie
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/attestations_fiscales#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '03002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: DGFIP - Adélie
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/attestations_fiscales#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/attestations_fiscales#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '03020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: DGFIP - Adélie
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/attestations_fiscales#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-maintenances:
from_hour: '01:00'
to_hour: '02:00'
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/dgfip/unites_legales/130025265/attestation_fiscale?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/dgfip/unites_legales/{siren}/attestation_fiscale":
get:
summary: Attestation fiscale
tags:
- Attestations sociales et fiscales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Attestation fiscale délivrée par la Direction générale des finances
publiques (DGFIP), indiquant que l’entreprise est à jour de ses obligations
fiscales.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/attestations_fiscales#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/attestations_fiscales#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/attestations_fiscales#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Attestation fiscale trouvée
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). Le cache est valide jusqu'au lendemain
8h.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_dgfip_attestations_fiscales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
document_url:
title: URL de téléchargement de l'attestation fiscale (.pdf)
type: string
description: Ce lien donne accès à l'attestation fiscale au
format PDF.
example: https://entreprise.api.gouv.fr/files/attestation-fiscale-dgfip-exemple.pdf
document_url_expires_in:
title: Délai avant expiration de l'URL de téléchargement du
document'
description: Nombre de secondes avant expiration de l'URL
de téléchargement du document. Il s'agit d'une expiration
purement technique.
type: integer
example: 86400
date_delivrance_attestation:
title: Date de délivrance de l'attestation
description: Date à laquelle l'attestation a été délivrée.
Il s'agit en général de la date du jour de l'appel.
type: date
example: '2023-04-11'
date_periode_analysee:
title: Date de la période analysée
description: "La situation est appréciée au dernier jour du
mois précédant la demande de délivrance de l'attestation.
\n \n Source: https://bofip.impots.gouv.fr/bofip/8485-PGP.html/identifiant=BOI-DJC-ARF-20220209#Modalites_de_controle_des_o_26"
example: '2023-03-31'
type: date
required:
- document_url
- document_url_expires_in
- date_delivrance_attestation
- date_periode_analysee
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/attestations_fiscales#erreurs.
content:
application/json:
examples:
entite_non_trouvee_03003:
value:
errors:
- code: '03003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: DGFIP - Adélie
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/attestations_fiscales#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/attestations_fiscales#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_03999:
value:
errors:
- code: '03999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: DGFIP - Adélie
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/attestations_fiscales#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '03002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: DGFIP - Adélie
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/attestations_fiscales#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/attestations_fiscales#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '03020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: DGFIP - Adélie
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_attestations_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/attestations_fiscales#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-maintenances:
from_hour: '01:00'
to_hour: '02:00'
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/dgfip/unites_legales/130025265/attestation_fiscale?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/dgfip/etablissements/{siret}/chiffres_affaires":
get:
summary: Chiffre d'affaires
tags:
- Informations financières
parameters:
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Déclarations de chiffre d’affaires, des trois derniers exercices,
faites auprès de la Direction générale des finances publiques (DGFIP).
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_chiffres_affaires, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/chiffres_affaires#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_chiffres_affaires, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/chiffres_affaires#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_chiffres_affaires, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/chiffres_affaires#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Exercices trouvés
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). La durée du cache est de 1 heure.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_dgfip_chiffres_affaires
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
data:
type: object
properties:
chiffre_affaires:
title: Chiffre d'affaires en euros
type: number
example: 900001
date_fin_exercice:
title: Date de fin de l'exercice
type: string
example: '2015-12-01'
required:
- chiffre_affaires
- date_fin_exercice
links:
type: object
meta:
type: object
meta:
type: object
links:
type: object
required:
- data
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_chiffres_affaires, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/chiffres_affaires#erreurs.
content:
application/json:
examples:
entite_non_trouvee_03003:
value:
errors:
- code: '03003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: DGFIP - Adélie
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_chiffres_affaires, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/chiffres_affaires#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_chiffres_affaires, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/chiffres_affaires#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_03999:
value:
errors:
- code: '03999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: DGFIP - Adélie
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_chiffres_affaires, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/chiffres_affaires#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '03002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: DGFIP - Adélie
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_chiffres_affaires, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/chiffres_affaires#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_chiffres_affaires, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/chiffres_affaires#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '03020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: DGFIP - Adélie
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_chiffres_affaires, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/chiffres_affaires#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-maintenances:
from_hour: '01:00'
to_hour: '02:00'
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/dgfip/etablissements/13002526500013/chiffres_affaires?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/dgfip/unites_legales/{siren}/liasses_fiscales/{year}":
get:
summary: Liasses fiscales
deprecated: true
tags:
- Informations financières
parameters:
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren
in: path
required: true
schema:
type: string
- name: year
in: path
required: true
schema:
type: integer
security:
- jwt_bearer_token: []
description: Informations renseignées dans les liasses fiscales, issues des
déclarations de résultat d’une entreprise auprès de la Direction générale
des finances publiques (DGFIP).
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/liasses_fiscales#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/liasses_fiscales#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/liasses_fiscales#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). La durée du cache est de 1 heure.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_dgfip_liasses_fiscales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
obligations_fiscales:
type: array
title: Règles d’imposition applicables au résultat de l'unité
légale (nommé obf en interne)
description: Une entité légale peut posséder plusieurs règles
d'impositions, notamment si celle-ci fait partie d'un groupe.
items:
type: object
additionalProperties: false
required:
- id
- code
- libelle
- reference
- regime
properties:
id:
title: Identifiant interne dénommé OCFI de la DGFIP
description: 'Identifiant technique interne de la DGFIP
OCFI: Numéro d’OCcurrences FIscales, déterminé par
le siren et par les obligations fiscales'
type: string
example: '100209489259'
code:
type: string
title: Code des règles d'imposition applicables au siren
description: "Les valeurs possibles sont les suivantes:
\n \n - IS: Impôt sur les sociétés \n - BIC: Bénéfices
industriels et commerciaux \n - IS GROUPE: Impôt sur
les sociétés dû par le groupe \n - BA: Bénéfices agricoles
\n - BNC: Bénéfices non commerciaux"
example: IS
enum:
- IS
- BIC
- IS GROUPE
- BA
- BNC
libelle:
type: string
title: Libellé des règles d'impositions applicables
à l'unité légale.
description: La liste exhaustive se trouve dans la description
du code.
example: Impôt sur les sociétés
reference:
title: Référence d'Obligation Fiscale (ROF)
type: string
description: Il s'agit du code d'Obligation Fiscale
(OBF) suivi d'un numéro d'identifiant qui définit
et individualise les obligations fiscales de l'unité
légale en fonction de ses activités
enum:
- IS1
- IS2
- IS3
- ISGROUPE1
- ISGROUPE2
- ISGROUPE3
- BA1
- BA2
- BA3
- BNC1
- BNC2
- BNC3
- BIC1
- BIC2
- BIC3
regime:
title: Régime d'imposition
type: string
description: Désigne les règles d’imposition du résultat
fiscal de l’entreprise obtenu du référentiel des occurrences
fiscales (R-OCFI)
declarations:
type: array
items:
type: object
additionalProperties: false
required:
- numero_imprime
- regime
- date_declaration
- date_fin_exercice
- duree_exercice
- millesime
- donnees
properties:
numero_imprime:
title: Numéro d'imprimé
type: string
description: Numéro du formulaire de la liasse fiscale
souscrit par l’unité légale.
example: 2033A
regime:
title: Régime d’imposition applicable au résultat fiscal
de l'unité légale
type: object
additionalProperties: false
required:
- code
- libelle
properties:
code:
title: Code du régime d’imposition applicable au
résultat fiscal de l'unité légale
type: string
description: "Les valeurs possibles sont les suivantes:
\n \n - RN: Réel normal \n - RSI ou RS: Réel simplifié
FIXME: A CONFIRMER le RS \n - RNMEMBRE: Réel normal
groupe (groupe) \n - RNGROUPE: Réel normal groupe
(tête) FIXME: Quel est la différence tête/groupe
\n - DECC: Déclaration contrôlée"
enum:
- RN
- RS
- RSI
- RNMEMBRE
- RNGROUPE
- DECC
libelle:
title: Libellé du régime d’imposition applicable
au résultat fiscal de l'unité légale.
description: La liste exhaustive se trouve dans
la description du code
type: string
example: Réel simplifié
date_declaration:
title: Date de dépôt de la déclaration
type: string
description: " - Si télédéclaration : date de saisie
\n - Si dépôt papier : date de réception par les Services
des Impôts des Entreprises"
example: '2012-12-26'
date_fin_exercice:
title: Date de fin d’exercice fiscal de l'unité légale
type: string
description: Équivalent à la date de fin de la période
d'imposition
example: '2012-12-31'
duree_exercice:
title: Durée de l'exercice en jours
type: number
description: "Durée de l’exercice fiscal calculée à
partir des dates de début et de fin de la période
d’imposition déclarées sur la déclaration souscrite
par l'unité légale. \n \n Généralement cette valeur
est de 365 jours, mais parfois 180 jours. Il y a une
obligation fiscale déclarative au 31/12 de chaque
année même s’il s’agit d’un dépôt provisoire."
example: 365
millesime:
title: Millesime
type: string
description: "Code composé de 6 caractères: \n - 4 caractères
correspondant à l'année de création ou modification
du formulaire. Les valeurs possibles vont de 2006
à l'année courante dès avril, l'année précédente sinon.
\n - 2 caractères correspondant au numéro de version
du formulaire, commençant à 01"
example: '201701'
donnees:
title: Données de l'imprimé
type: array
description: Chaque entrée du tableau correspondant
à couple code / valeur, spécifique au numéro d'imprimé
référencé à la clé `numero_imprime`
items:
type: object
additionalProperties: false
required:
- code_nref
- valeurs
properties:
code:
title: Code
type: string
description: Code permettant d'identifier la donnée,
constitué de 2 lettres de AA à ZZ (cf. Code
EDI)
example: GR
code_EDI:
title: Code EDI
type: string
description: 'Le code EDI est utilisé lorsque
la liasses fiscale a été souscrite via la filière
EDI/TDFC. Il permet l’échange des données de
nature comptable et/ou fiscale avec la norme
EDIFACT entre la DGFIP et les utilisateurs des
téléprocédures EDI '
example: GR:C889:7111:1:TBX
code_absolu:
title: Code absolu
type: string
description: Ce code interne à la DGFIP identifie
une seule donnée sur un seul formulaire
example: '2006744'
code_type_donnee:
title: Code Type Donnée
description: Ce code détermine la nature de la
donnée, le nombre et type des caractères qu’elle
peut contenir
type: string
example: CCI
intitule:
title: Intitulé
description: Intitulé de la donnée. Désigne une
donnée correspondant à une case à cocher présente
en haut de certains tableaux de la liasse fiscale
type: string
example: Déposé néant
code_nref:
title: A un code N-REF correspond un code absolu
pour les liasses fiscales. Ces deux codes désignent
une seule donnée présente sur un seul formulaire
type: string
example: '304651'
valeurs:
title: 'Valeurs associés à l''entrée '
description: Si une entrée de l'imprimé est répétable,
le tableau contient plusieurs entrées et sont
ordonnées en fonction de l'indice de répétition.
Les indices ne sont pas forcément continue,
il peut y avoir des valeurs manquantes. Lors
que c'est le cas, celle-ci est remplacée par
la valeur `null`
type: array
minItems: 1
items:
type: string
example:
- '4245'
-
- '5672'
required:
- obligations_fiscales
- declarations
additionalProperties: false
links:
type: object
meta:
type: object
properties:
internal_id_itip:
title: Identifiant interne dénommé ITIP de la DGFIP
type: string
description: 'Identifiant technique interne de la DGFIP ITIP:
Identifiant Transversal Informatique de la Personne'
example: '100004763104'
required:
- internal_id_itip
additionalProperties: false
required:
- data
- links
- meta
'404':
description: |-
Pas de liasses fiscales pour cette unité légale
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/liasses_fiscales#erreurs.
content:
application/json:
examples:
entite_non_trouvee_03003:
value:
errors:
- code: '03003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: DGFIP - Adélie
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/liasses_fiscales#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/liasses_fiscales#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_03999:
value:
errors:
- code: '03999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: DGFIP - Adélie
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/liasses_fiscales#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '03002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: DGFIP - Adélie
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/liasses_fiscales#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/liasses_fiscales#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '03020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: DGFIP - Adélie
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/v3/liasses_fiscales#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-maintenances:
from_hour: '01:00'
to_hour: '02:00'
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/dgfip/unites_legales/130025265/liasses_fiscales/2019?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/dgfip/unites_legales/{siren}/liasses_fiscales/{year}":
get:
summary: Liasses fiscales
tags:
- Informations financières
parameters:
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren
in: path
required: true
schema:
type: string
- name: year
in: path
required: true
schema:
type: integer
security:
- jwt_bearer_token: []
description: Informations renseignées dans les liasses fiscales, issues des
déclarations de résultat d’une entreprise auprès de la Direction générale
des finances publiques (DGFIP).
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). La durée du cache est de 1 heure.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_dgfip_liasses_fiscales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
obligations_fiscales:
type: array
title: Règles d’imposition applicables au résultat de l'unité
légale (nommé obf en interne)
description: Une entité légale peut posséder plusieurs règles
d'impositions, notamment si celle-ci fait partie d'un groupe.
items:
type: object
additionalProperties: false
required:
- id
- code
- libelle
- reference
- regime
properties:
id:
title: Identifiant interne dénommé OCFI de la DGFIP
description: 'Identifiant technique interne de la DGFIP
OCFI: Numéro d’OCcurrences FIscales, déterminé par
le siren et par les obligations fiscales'
type: string
example: '100209489259'
code:
type: string
title: Code des règles d'imposition applicables au siren
description: "Les valeurs possibles sont les suivantes:
\n \n - IS: Impôt sur les sociétés \n - BIC: Bénéfices
industriels et commerciaux \n - IS GROUPE: Impôt sur
les sociétés dû par le groupe \n - BA: Bénéfices agricoles
\n - BNC: Bénéfices non commerciaux"
example: IS
enum:
- IS
- BIC
- IS GROUPE
- BA
- BNC
libelle:
type: string
title: Libellé des règles d'impositions applicables
à l'unité légale.
description: La liste exhaustive se trouve dans la description
du code.
example: Impôt sur les sociétés
reference:
title: Référence d'Obligation Fiscale (ROF)
type: string
description: Il s'agit du code d'Obligation Fiscale
(OBF) suivi d'un numéro d'identifiant qui définit
et individualise les obligations fiscales de l'unité
légale en fonction de ses activités
enum:
- IS1
- IS2
- IS3
- ISGROUPE1
- ISGROUPE2
- ISGROUPE3
- BA1
- BA2
- BA3
- BNC1
- BNC2
- BNC3
- BIC1
- BIC2
- BIC3
regime:
title: Régime d'imposition
type: string
description: Désigne les règles d’imposition du résultat
fiscal de l’entreprise obtenu du référentiel des occurrences
fiscales (R-OCFI)
declarations:
type: array
items:
type: object
additionalProperties: false
required:
- numero_imprime
- regime
- date_declaration
- date_fin_exercice
- duree_exercice
- millesime
- donnees
properties:
numero_imprime:
title: Numéro d'imprimé
type: string
description: Numéro du formulaire de la liasse fiscale
souscrit par l’unité légale.
example: 2033A
regime:
title: Régime d’imposition applicable au résultat fiscal
de l'unité légale
type: object
additionalProperties: false
required:
- code
- libelle
properties:
code:
title: Code du régime d’imposition applicable au
résultat fiscal de l'unité légale
type: string
description: "Les valeurs possibles sont les suivantes:
\n \n - RN: Réel normal \n - RSI ou RS: Réel simplifié
FIXME: A CONFIRMER le RS \n - RNMEMBRE: Réel normal
groupe (groupe) \n - RNGROUPE: Réel normal groupe
(tête) FIXME: Quel est la différence tête/groupe
\n - DECC: Déclaration contrôlée"
enum:
- RN
- RS
- RSI
- RNMEMBRE
- RNGROUPE
- DECC
libelle:
title: Libellé du régime d’imposition applicable
au résultat fiscal de l'unité légale.
description: La liste exhaustive se trouve dans
la description du code
type: string
example: Réel simplifié
date_declaration:
title: Date de dépôt de la déclaration
type: string
description: " - Si télédéclaration : date de saisie
\n - Si dépôt papier : date de réception par les Services
des Impôts des Entreprises"
example: '2012-12-26'
date_fin_exercice:
title: Date de fin d’exercice fiscal de l'unité légale
type: string
description: Équivalent à la date de fin de la période
d'imposition
example: '2012-12-31'
duree_exercice:
title: Durée de l'exercice en jours
type: number
description: "Durée de l’exercice fiscal calculée à
partir des dates de début et de fin de la période
d’imposition déclarées sur la déclaration souscrite
par l'unité légale. \n \n Généralement cette valeur
est de 365 jours, mais parfois 180 jours. Il y a une
obligation fiscale déclarative au 31/12 de chaque
année même s’il s’agit d’un dépôt provisoire."
example: 365
millesime:
title: Millesime
type: string
description: "Code composé de 6 caractères: \n - 4 caractères
correspondant à l'année de création ou modification
du formulaire. Les valeurs possibles vont de 2006
à l'année courante dès avril, l'année précédente sinon.
\n - 2 caractères correspondant au numéro de version
du formulaire, commençant à 01"
example: '201701'
donnees:
title: Données de l'imprimé
type: array
description: Chaque entrée du tableau correspondant
à couple code / valeur, spécifique au numéro d'imprimé
référencé à la clé `numero_imprime`
items:
type: object
additionalProperties: false
required:
- code_nref
- valeurs
properties:
intitule:
title: Intitulé
description: Intitulé de la donnée. Désigne une
donnée correspondant à une case à cocher présente
en haut de certains tableaux de la liasse fiscale
type: string
example: Déposé néant
code_nref:
title: A un code N-REF correspond un code absolu
pour les liasses fiscales. Ces deux codes désignent
une seule donnée présente sur un seul formulaire
type: string
example: '304651'
valeurs:
title: 'Valeurs associés à l''entrée '
description: Si une entrée de l'imprimé est répétable,
le tableau contient plusieurs entrées et sont
ordonnées en fonction de l'indice de répétition.
Les indices ne sont pas forcément continue,
il peut y avoir des valeurs manquantes. Lors
que c'est le cas, celle-ci est remplacée par
la valeur `null`
type: array
minItems: 1
items:
type: string
example:
- '4245'
-
- '5672'
required:
- obligations_fiscales
- declarations
additionalProperties: false
links:
type: object
meta:
type: object
properties:
internal_id_itip:
title: Identifiant interne dénommé ITIP de la DGFIP
type: string
description: 'Identifiant technique interne de la DGFIP ITIP:
Identifiant Transversal Informatique de la Personne'
example: '100004763104'
required:
- internal_id_itip
additionalProperties: false
required:
- data
- links
- meta
'404':
description: |-
Pas de liasses fiscales pour cette unité légale
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales#erreurs.
content:
application/json:
examples:
entite_non_trouvee_03003:
value:
errors:
- code: '03003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: DGFIP - Adélie
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_03999:
value:
errors:
- code: '03999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: DGFIP - Adélie
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '03002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: DGFIP - Adélie
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '03020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: DGFIP - Adélie
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_dgfip_liasses_fiscales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-maintenances:
from_hour: '01:00'
to_hour: '02:00'
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/dgfip/unites_legales/130025265/liasses_fiscales/2019?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/dgfip/unites_legales/{siren}/liens_capitalistiques/{year}":
get:
summary: Liens capitalistiques
tags:
- Informations financières
parameters:
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren
in: path
required: true
schema:
type: string
- name: year
in: path
required: true
schema:
type: integer
security:
- jwt_bearer_token: []
description: Actionnaires et filiales de l'entreprise déclarés dans les CERFA
2059F et 2059G des liasses fiscales de la DGFIP.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liens_capitalistiques, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liens_capitalistiques#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liens_capitalistiques, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liens_capitalistiques#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liens_capitalistiques, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liens_capitalistiques#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Liens capitalistiques trouvées
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). La durée du cache est de 1 heure.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_dgfip_liens_capitalistiques
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
capital:
title: Composition du capital social
description: 'Informations extraites du CERFA 2059F (nref:
2059F). Si la liasse est absente, l''ensemble des valeurs
sont à null'
type: object
additionalProperties: false
required:
- actionnaires
- repartition
- depose_neant
properties:
actionnaires:
title: Liste des actionnaires
description: 'Liste des actionnaires avec une structure
normalisée (nref: structure standardisée issue du serializer)'
type: array
items:
type: object
additionalProperties: false
required:
- type
- pourcentage
- nombre_parts
- personne_physique_attributes
- personne_morale_attributes
- adresse
properties:
type:
title: Type d'actionnaire
description: 'Type de l''actionnaire, ''personne_morale''
ou ''personne_physique'' (nref: valeur fixe)'
type: string
enum:
- personne_morale
- personne_physique
pourcentage:
title: Pourcentage de détention
description: 'Pourcentage de détention de l''actionnaire
(nref: 304861 pour personne morale, 304871 pour
personne physique)'
type: number
example: 51.0
nombre_parts:
title: Nombre de parts
description: 'Nombre de parts détenues par l''actionnaire
(nref: 304860 pour personne morale, 304870 pour
personne physique)'
type: number
example: 510
personne_physique_attributes:
title: Attributs de la personne physique
description: 'Attributs spécifiques pour une personne
physique. Si l''actionnaire n''est pas de type
''personne_physique'', tous les champs seront
null (nref: 306874, 304868, 304869, 304878, 905900,
905901, 905902)'
type: object
additionalProperties: false
required:
- civilite
- nom_patronymique_et_prenoms
- nom_marital
- date_naissance
properties:
civilite:
title: Civilité
description: 'Civilité de la personne physique
(nref: 306874)'
type: string
example: M
nullable: true
nom_patronymique_et_prenoms:
title: Nom patronymique et prénoms
description: 'Nom patronymique et prénoms (nref:
304868)'
type: string
example: CHIRAC Jacques
nullable: true
nom_marital:
title: Nom marital
description: 'Nom marital (nref: 304869)'
type: string
example: NS
nullable: true
date_naissance:
title: Date de naissance
description: 'Date de naissance (nref: 304878),
le jour n''est pas renvoyé'
additionalProperties: false
type: object
required:
- annee
- mois
properties:
annee:
title: Année de la date de naissance
type: string
example: '1932'
nullable: true
mois:
title: Mois de la date de naissance
type: string
example: '11'
nullable: true
personne_morale_attributes:
title: Attributs de la personne morale
description: 'Attributs spécifiques pour une personne
morale. Si l''actionnaire n''est pas de type ''personne_morale'',
tous les champs seront null ou ''NS'' (nref: 304859,
304857, 304858, 306875)'
type: object
additionalProperties: false
required:
- siren
- denomination
- complement_denomination
- forme_juridique
properties:
siren:
title: SIREN
description: 'Identifiant SIREN de la personne
morale (nref: 304859)'
type: string
example: '110001013'
nullable: true
denomination:
title: Dénomination
description: 'Dénomination de la personne morale
(nref: 304857)'
type: string
example: GOUVERNEMENT PREMIER MINISTRE
nullable: true
complement_denomination:
title: Complément de dénomination
description: 'Complément de dénomination de
la personne morale (nref: 304858)'
type: string
nullable: true
forme_juridique:
title: Forme juridique
description: 'Forme juridique (nref: 306875)'
type: string
example: NS
nullable: true
adresse:
title: Adresse de l'actionnaire
description: 'Adresse de l''actionnaire (nref: pour
personne morale [304862-304867] et pour personne
physique [304872-304877])'
type: object
additionalProperties: false
required:
- numero
- voie
- lieu_dit_hameau
- code_postal
- ville
- pays
properties:
numero:
title: Numéro
description: 'Numéro de l''adresse (nref personne
morale: 304862, 304872)'
type: string
example: '0057'
nullable: true
voie:
title: Voie
description: 'Voie de l''adresse (nref personne
morale: 304863, personne physique: 304873)'
type: string
example: RUE DE VARENNE
nullable: true
lieu_dit_hameau:
title: Lieu-dit / Hameau
description: 'Lieu-dit ou hameau (nref personne
morale: 304864, personne physique: 304874)'
type: string
nullable: true
code_postal:
title: Code postal
description: 'Code postal (nref personne morale:
304865, personne physique: 304875)'
type: string
example: '75007'
nullable: true
ville:
title: Ville
description: 'Ville (nref personne morale: 304866,
personne physique: 304876)'
type: string
example: PARIS
nullable: true
pays:
title: Pays
description: 'Pays, code iso 3166 (nref personne
morale: 304867, personne physique: 304877)'
type: string
example: FR
nullable: true
repartition:
title: Répartition des actions
description: 'Répartition des actions entre personnes
physiques et personnes morales (nref: 309326 et 309325
pour personnes physiques, 309324 et 309323 pour personnes
morales). Si la liasse est absente, l''ensemble des
valeurs sont à null'
type: object
additionalProperties: false
required:
- personnes_physiques
- personnes_morales
properties:
personnes_physiques:
title: Personnes physiques
description: 'Détail des actions détenues par les
personnes physiques (nref: total_actions 309326,
nombre 309325)'
type: object
additionalProperties: false
required:
- total_actions
- nombre
properties:
total_actions:
title: Total des actions
description: 'Total des actions des personnes
physiques (nref: 309326)'
type: number
example: 490
nullable: true
nombre:
title: Nombre d'actions
description: 'Nombre d''actions répertoriées pour
les personnes physiques (nref: 309325)'
type: number
example: 2
nullable: true
personnes_morales:
title: Personnes morales
description: 'Détail des actions détenues par les
personnes morales (nref: total_actions 309324, nombre
309323)'
type: object
additionalProperties: false
required:
- total_actions
- nombre
properties:
total_actions:
title: Total des actions
description: 'Total des actions des personnes
morales (nref: 309324)'
type: number
example: 510
nullable: true
nombre:
title: Nombre d'actions
description: 'Nombre d''actions répertoriées pour
les personnes morales (nref: 309323)'
type: number
example: 1
nullable: true
depose_neant:
title: État du dépôt du formulaire 2059F
description: "Indique l'état du dépôt du formulaire 2059F
concernant la composition du capital social : \n \n
- false : l’imprimé est bien déposé et contient des
données. \n - true : l’imprimé est déposé à néant (vide).
\n - null : l’imprimé est complètement absent. \n \n
(nref: 305767)"
type: boolean
example: false
nullable: true
participations:
title: Participations
description: 'Informations sur les participations de l''entreprise
(nref: 2059G)'
type: object
additionalProperties: false
required:
- filiales
- nombre_filiales
- depose_neant
properties:
filiales:
title: Liste des filiales
description: 'Liste des filiales de l''entreprise (nref:
siren 304960, denomination 304958, complement_denomination
304959, forme_juridique 306876, pourcentage_detention
304967, adresse [304961 à 304966])'
type: array
items:
type: object
additionalProperties: false
required:
- siren
- denomination
- complement_denomination
- forme_juridique
- pourcentage_detention
- adresse
properties:
siren:
title: SIREN de la filiale
description: 'Identifiant SIREN de la filiale (nref:
304960)'
type: string
example: '130007669'
denomination:
title: Dénomination
description: 'Dénomination de la filiale (nref:
304958)'
type: string
example: ANSII
complement_denomination:
title: Complément de dénomination
description: 'Complément de dénomination de la filiale
(nref: 304959)'
type: string
nullable: true
forme_juridique:
title: Forme juridique
description: 'Forme juridique de la filiale (nref:
306876)'
type: string
example: SA
pourcentage_detention:
title: Pourcentage de détention
description: 'Pourcentage de détention dans la filiale
(nref: 304967)'
type: number
example: 42.0
adresse:
title: Adresse de la filiale
description: 'Adresse de la filiale (nref: numéro
304961, voie 304962, lieu_dit_hameau 304963, code_postal
304964, ville 304965, pays 304966)'
type: object
additionalProperties: false
required:
- numero
- voie
- lieu_dit_hameau
- code_postal
- ville
- pays
properties:
numero:
title: Numéro
description: 'Numéro de l''adresse (nref: 304961)'
type: string
example: 0051 BOULEVARD DE LA TOUR-MAUBOURG
voie:
title: Voie
description: 'Voie de l''adresse (nref: 304962)'
type: string
nullable: true
lieu_dit_hameau:
title: Lieu-dit / Hameau
description: 'Lieu-dit ou hameau (nref: 304963)'
type: string
nullable: true
code_postal:
title: Code postal
description: 'Code postal (nref: 304964)'
type: string
example: '75007'
ville:
title: Ville
description: 'Ville (nref: 304965)'
type: string
example: PARIS
pays:
title: Pays
description: 'Pays, code iso 3166 (nref: 304966)'
type: string
example: FR
nullable: true
nombre_filiales:
title: Nombre de filiales
description: 'Nombre de filiales déclarées (nref: 309327)'
type: number
example: 1
depose_neant:
title: État du dépôt du formulaire 2059G
description: "Indique l'état du dépôt du formulaire 2059G
concernant les filiales et participations : \n \n -
false : l’imprimé est bien déposé et contient des données.
\n - true : l’imprimé est déposé à néant (vide). \n
- null : l’imprimé est complètement absent. \n \n (nref:
305768)"
type: boolean
example: false
required:
- capital
- participations
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'404':
description: |-
Non trouvé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liens_capitalistiques, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liens_capitalistiques#erreurs.
content:
application/json:
examples:
entite_non_trouvee_03003:
value:
errors:
- code: '03003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: DGFIP - Adélie
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liens_capitalistiques, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liens_capitalistiques#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liens_capitalistiques, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liens_capitalistiques#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_03999:
value:
errors:
- code: '03999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: DGFIP - Adélie
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liens_capitalistiques, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liens_capitalistiques#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '03002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: DGFIP - Adélie
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liens_capitalistiques, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liens_capitalistiques#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liens_capitalistiques, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liens_capitalistiques#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '03020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: DGFIP - Adélie
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_liens_capitalistiques, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/liens_capitalistiques#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-maintenances:
from_hour: '01:00'
to_hour: '02:00'
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/dgfip/unites_legales/130025265/liens_capitalistiques/2019?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/dgfip/unites_legales/{siren}/numero_tva":
get:
summary: Numéros de TVA intracommunautaire français
tags:
- Informations financières
parameters:
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Numéro de TVA intracommunautaire français, issu des extractions
publiées par la Direction générale des finances publiques (DGFIP) sur data.gouv.fr.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_tva, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/numero_tva#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_tva, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/numero_tva#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Numéro de TVA trouvé
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: 'Secondes avant que le cache n''expire. Si le cache est
vide, ce header est vide (mais présent). '
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_dgfip_tva
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
numero_tva:
title: Numéro de TVA intracommunautaire français
description: 'Numéro de TVA français, préfixé par FR, suivi
de la clé de contrôle sur 2 caractères (chiffres, ou chiffres
et lettres) puis du SIREN sur 9 chiffres. Si l''unité légale
a plusieurs numéros, un seul est délivré : le numéro calculé
avec la clé numérique s''il existe, sinon le plus récemment
attribué.'
type: string
example: FR72217500016
required:
- numero_tva
additionalProperties: false
links:
type: object
meta:
type: object
properties:
date_derniere_mise_a_jour:
title: Date de la dernière mise à jour des données
description: Date de la dernière publication de l'extraction
DGFIP sur data.gouv.fr. Les données sont mises à jour avec
un délai d'environ un jour (J+1). Peut être `null` si la
date n'a pas pu être récupérée.
type: string
format: date
example: '2026-06-11'
nullable: true
required:
- date_derniere_mise_a_jour
additionalProperties: false
required:
- data
- links
- meta
'404':
description: |-
Non trouvé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_tva, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/numero_tva#erreurs.
content:
application/json:
examples:
entite_non_trouvee_43003:
value:
errors:
- code: '43003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: DGFIP - TVA
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_tva, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/numero_tva#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_tva, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/numero_tva#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_43999:
value:
errors:
- code: '43999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: DGFIP - TVA
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_tva, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/numero_tva#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '43002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: DGFIP - TVA
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_tva, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/numero_tva#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_tva, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/numero_tva#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_tva, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/numero_tva#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '43020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: DGFIP - TVA
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_dgfip_tva, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/dgfip/numero_tva#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-maintenances:
from_hour: '01:00'
to_hour: '02:00'
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/dgfip/unites_legales/130025265/numero_tva?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/djepva/api-association/associations/{siren_or_rna}":
get:
summary: Données association
tags:
- Informations générales
parameters:
- name: siren_or_rna
in: path
description: Siren de l'association ou le numéro RNA
examples:
openstreetmap_france:
value: W751212517
summary: ID RNA Openstreetmap France
croix_rouge:
value: '775672272'
summary: SIREN de la Croix-Rouge France
required: true
schema:
type: string
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Informations et documents de référence d'une association et de
ses établissements, issues du répertoire national des associations (RNA) et
des documents administratifs complémentaires (DAC).
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Association trouvée
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). La durée du cache est de 1 heure.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_mi_unites_legales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
rna:
type: string
title: Numéro RNA
description: "Numéro identifiant de toute association inscrite
au répertoire national des associations (RNA). Il est constitué
de la lettre W suivie de 9 chiffres. \n \n Cas particulier
: Si l'association relève du droit local d'Alsace-Moselle,
elle n'est pas immatriculée au RNA et ne possède donc pas
de numéro RNA. Dans ce cas, le champ est vide."
example: W751080001
nullable: true
ancien_id:
type: string
title: Ancien identifiant de l'entité avant l'arrêté du 14
octobre 2009 portant la création du RNA
example: '1234567890'
nullable: true
siren:
type: string
title: Numéro SIREN
description: 'Numéro identifiant des associations inscrites
au répertoire Sirene. Cet enregistrement n''est pas obligatoire
: pour les associations qui n''ont pas de numéro SIREN,
le champ est vide.'
example: '751080001'
nullable: true
nom:
title: Nom de l'association (raison sociale)
description: Ce nom provient du répertoire national des associations
(RNA) ou du répertoire Sirene. Si le régime de l'association
est indiqué "Loi 1901", le nom provient toujours du RNA.
type: string
example: LA PRÉVENTION ROUTIERE
active:
title: État de l'association
type: boolean
example: true
description: L'association est active si elle est enregistrée
à la Préfecture et si elle n'a pas été dissoute. Si le régime
de l'association est "Loi 1901" l'information provient du
RNA, autrement elle est issue du répertoire Sirene.
sigle:
title: Sigle de l'association
description: Ce sigle provient du répertoire national des
associations (RNA) ou du répertoire Sirene. Si le régime
de l'association est indiqué "Loi 1901", le nom provient
toujours du RNA.
type: string
example: LPR
nullable: true
reconnue_utilite_publique:
title: Indique si l'association est reconnue d'utilité publique
type: boolean
example: false
siret_siege:
title: Numéro SIRET du siège social
description: 'Les établissements sièges des associations
inscrites au répertoire Sirene ont un numéro identifiant
: le SIRET. Pour les associations qui ne sont pas répertoriées,
le champ est vide.'
type: string
example: '75108000100013'
nullable: true
forme_juridique:
type: object
additionalProperties: false
title: Forme juridique
required:
- code
- libelle
properties:
code:
title: Code de la forme juridique de l'unité légale
type: string
example: '9220'
description: 'Nomenclature exhaustive fournie par l''Insee
: https://www.insee.fr/fr/information/2028129'
nullable: true
libelle:
title: Libellé associé au code de la forme juridique de
l'unité légale
type: string
example: Association déclarée
description: "indique le libellé correspondant au code
juridique. Si le code ne correspond à aucun libellé
la valeur 'non référencé' est utilisée. \n \n Nomenclature
exhaustive fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
nullable: true
regime:
title: Régime de l'association
type: string
description: "Les deux régimes possibles sont 'Loi 1901' et
'Alsace-Moselle'. \n \n Le régime \"Loi 1901\" est le cas
général des associations établies en France. Les associations
dont le siège se trouve en Alsace et en Moselle sont régies
par un droit local, dit \"régime Alsace-Moselle\". \n \n
Cette information provient des documents administratifs
complémentaires (DAC). \n \n Pour en savoir plus sur les
particularités du régime Alsace-Moselle : https://www.associations.gouv.fr/le-droit-local-des-associations-en-alsace-moselle.html"
example: Loi 1901
enum:
- Loi 1901
- Alsace-Moselle
groupement:
title: Type de groupement
description: "Une association peut faire partie d'un groupement
de type union ou fédération. \n \n Ce champ est à 'Simple'
si l'association n'est pas membre d'un groupement."
type: string
example: Simple
enum:
- Simple
- Fédération
- Union
nullable: true
eligibilite_cec:
title: Indique si l'association est éligible au CEC
description: "Indique si l'association est éligible au compte
d'engagement citoyen (CEC). Ce dispositif permet de bénéficier
de droits à formation supplémentaires et vise valoriser
l'engagement bénévole de responsables associatifs.\nPour
en savoir plus sur le CEC : https://www.associations.gouv.fr/le-compte-d-engagement-citoyen-qu-est-ce-que-c-est.html "
type: boolean
example: false
enum:
- true
- false
raison_non_eligibilite_cec:
title: Raison de l'inéligibilité au CEC
description: Ce champ est vide si l'association est éligible
au CEC.
type: string
example: L’association n’a pas trois ans d’existence
enum:
- L’association n’a pas trois ans d’existence
- L’objet de l’association ne rentre pas dans les critères
d’éligibilité au CEC
- L’association n’a pas trois ans d’existence et son objet
ne rentre pas dans les critères d’éligibilité au CEC
nullable: true
impots_commerciaux:
title: Indique si l'association est assujettie aux impôts
commerciaux
description: "En fonction de ses missions et de ses activités,
une association peut être soumise aux impôts commerciaux
(à la TVA ou à l’impôt sur les sociétés). Ce cas particulier
concerne notamment les associations exerçant une activité
lucrative. \n \n En savoir plus : https://www.associations.gouv.fr/l-association-et-les-impots-commerciaux.html"
type: boolean
example: true
date_creation:
title: Date de création de l'association
description: La date de création provient en priorité de la
base RNA si celle-ci est présente, sinon de la base Sirene.
type: string
format: date
example: '2015-01-01'
nullable: true
date_dissolution:
title: Date de dissolution de l'association
description: La date de dissolution provient en priorité de
la base RNA si celle-ci est présente, sinon de la base Sirene.
type: string
format: date
example: '2016-01-01'
nullable: true
date_publication_reconnue_utilite_publique:
title: Date de publication de la reconnaissance d'utilité
publique
type: string
format: date
example: '2017-01-01'
nullable: true
date_publication_journal_officiel:
title: Date de publication au Journal Officiel de la création
de l'association
description: Cette information est exclusive aux associations
"Loi 1901" et provient du répertoire national des associations
(RNA).
type: string
format: date
example: '2018-01-01'
nullable: true
adresse_siege:
type: object
additionalProperties: false
title: Adresse du siège social de l'association
properties:
complement:
title: Complément d'adresse
type: string
example: ''
nullable: true
numero_voie:
title: Numéro de voie
type: string
example: '33'
nullable: true
type_voie:
title: Type de voie
type: string
example: rue
nullable: true
libelle_voie:
title: Libellé de la voie
type: string
example: de Modagor
nullable: true
distribution:
title: Distribution
type: string
nullable: true
code_insee:
title: Code INSEE de la commune
type: string
example: '75108'
nullable: true
code_postal:
title: Code postal de la commune
type: string
example: '75009'
nullable: true
commune:
title: Nom de la commune
type: string
example: Paris
nullable: true
required:
- complement
- numero_voie
- type_voie
- libelle_voie
- distribution
- code_insee
- code_postal
- commune
adresse_gestion:
type: object
additionalProperties: false
title: Adresse de gestion de l'association
description: L'adresse de gestion est l'adresse à laquelle
se trouve les bureaux administratifs.
properties:
complement:
title: Complément d'adresse
type: string
example: ''
nullable: true
numero_voie:
title: Numéro de voie
type: string
example: '33'
nullable: true
type_voie:
title: Type de voie
type: string
example: rue
nullable: true
libelle_voie:
title: Libellé de la voie
type: string
example: de Modagor
nullable: true
distribution:
title: Distribution
type: string
nullable: true
code_insee:
title: Code INSEE de la commune
type: string
example: '75108'
nullable: true
code_postal:
title: Code postal de la commune
type: string
example: '75009'
nullable: true
commune:
title: Nom de la commune
type: string
example: Paris
nullable: true
required:
- complement
- numero_voie
- type_voie
- libelle_voie
- distribution
- code_insee
- code_postal
- commune
alsace_moselle:
title: Attributs relatifs aux associations de droit local
d'Alsace-Moselle
description: Ces information proviennent des documents administratifs
complémentaires (DAC). Les attributs sont vides si l'association
est une association "Loi 1901".
type: object
additionalProperties: false
required:
- tribunal_instance
- volume
- folio
- date_publication_registre_association
properties:
tribunal_instance:
title: Tribunal d'instance
type: string
example: Tribunal d'instance de Strasbourg
nullable: true
enum:
- Tribunal d'instance de Metz
- Tribunal d'instance de Saint-Avold
- Tribunal d'instance de Sarrebourg
- Tribunal d'instance de Sarreguemines
- Tribunal d'instance de de Thionville
- Tribunal d'instance de Haguenau
- Tribunal d'instance d’Illkirch
- Tribunal d'instance de Molsheim
- Tribunal d'instance de Saverne
- Tribunal d'instance de Schiltigheim
- Tribunal d'instance de Sélestat
- Tribunal d'instance de Strasbourg
- Tribunal d'instance de Colmar
- Tribunal d'instance de Guebwiller
- Tribunal d'instance de Mulhouse
- Tribunal d'instance de Thann
volume:
title: Volume du registre du tribunal d'instance
type: string
example: '122'
nullable: true
folio:
title: Folio du volume du registre du tribunal d'instance
type: string
example: '082'
nullable: true
date_publication_registre_association:
title: Date de publication au registre des associations
d'Alsace-Moselle
type: string
format: date
example: '2019-01-01'
nullable: true
composition_reseau:
title: Composition du réseau, de l'union ou de la fédération
type: array
items:
type: object
additionalProperties: false
required:
- nom
- rna
- siret
- telephone
- courriel
- objet
- adresse
- site_web
properties:
nom:
type: string
title: Nom du membre du réseau
example: Association des parents d'élèves de l'école
primaire de la ville
rna:
type: string
title: Numéro RNA du membre du réseau
example: W123456789
nullable: true
siret:
type: string
title: Numéro SIRET du membre du réseau
example: '12345678901234'
nullable: true
telephone:
type: string
title: Numéro de téléphone du membre du réseau
example: '0123456789'
nullable: true
courriel:
type: string
title: Courriel du membre du réseau
example: reseau@association.fr
nullable: true
objet:
type: string
title: Objet du membre du réseau
example: Promouvoir l'engagement des parents d'élèves
dans l'éducation de leurs enfants
adresse:
type: object
additionalProperties: false
title: Adresse du siège social de l'association
properties:
complement:
title: Complément d'adresse
type: string
example: ''
nullable: true
numero_voie:
title: Numéro de voie
type: string
example: '33'
nullable: true
type_voie:
title: Type de voie
type: string
example: rue
nullable: true
libelle_voie:
title: Libellé de la voie
type: string
example: de Modagor
nullable: true
distribution:
title: Distribution
type: string
nullable: true
code_insee:
title: Code INSEE de la commune
type: string
example: '75108'
nullable: true
code_postal:
title: Code postal de la commune
type: string
example: '75009'
nullable: true
commune:
title: Nom de la commune
type: string
example: Paris
nullable: true
required:
- complement
- numero_voie
- type_voie
- libelle_voie
- distribution
- code_insee
- code_postal
- commune
site_web:
title: Site internet du membre du réseau
type: string
example: reseau-association.fr
nullable: true
agrements:
title: Liste des agréments administratifs associés à l'association
type: array
items:
type: object
additionalProperties: false
required:
- numero
- date_attribution
- type
- niveau
- attributeur
- url
properties:
numero:
type: string
title: Numéro de l'agrément
description: Ce champ étant libre, il n'y a pas de format
spécifique.
example: 05.11.2018
date_attribution:
type: string
format: date
title: Date d'attribution de l'agrément
example: '2018-11-05'
type:
type: string
title: Type d'agrément
description: "Liste non-exhaustive des agréments : \n
\n - Agriculture \n - CIDFF \n - Consommation \n -
Ecologie \n - Education nationale \n - Formation \n
- Formation professionnelle \n - JEP \n - Santé \n
- Service civique \n - Sport \n - Tourisme \n - Autre "
example: Formation
niveau:
type: string
title: Niveau de l'agrément
example: local
enum:
- national
- local
attributeur:
type: string
title: Nom de l'organisme qui a attribué l'agrément
example: Ministère de l'Education nationale
url:
type: string
title: URL de l'agrément
nullable: true
example: https://associations.api.gouv.fr/agrements/05.11.2018.pdf
activites:
title: Liste des activités de l'association
type: object
additionalProperties: false
required:
- objet
- objet_social1
- objet_social2
- champ_action_territorial
- activite_principale
- tranche_effectif
- economie_sociale_et_solidaire
- date_appartenance_ess
properties:
objet:
title: Objet de l'association
description: Définit l'objet de l'association et les activités
envisagées pour atteindre l'objet. Ce champ délivre
l'objet tel que rédigé dans les statuts de l'association.
type: string
nullable: true
example: L'association a pour objet de promouvoir la pratique
du sport de haut niveau et de contribuer à la formation
des jeunes sportifs.
objet_social1:
type: object
additionalProperties: false
title: Objet social principal
description: 'L''objet social suit la nomenclature nationale
Waldec et permet de rattacher l''objet de l''association
à une catégorie, comme par exemple : "centres aérés,
colonies de vacances", "défense des droits des personnes
en situation de handicap" ou "loisirs scientifiques
et techniques". La liste exhaustive des objets sociaux
est disponible au lien suivant: https://www.data.gouv.fr/fr/datasets/repertoire-national-des-associations-nomenclature-waldec
(environ 300 entrées).'
properties:
code:
type: string
title: Code de l'objet social
example: '017055'
nullable: true
libelle:
type: string
title: Libellé de l'objet social
example: accompagnement, aide aux malades
nullable: true
required:
- code
- libelle
objet_social2:
type: object
additionalProperties: false
title: Objet social secondaire
description: 'L''objet social suit la nomenclature nationale
Waldec et permet de rattacher l''objet de l''association
à une catégorie, comme par exemple : "centres aérés,
colonies de vacances", "défense des droits des personnes
en situation de handicap" ou "loisirs scientifiques
et techniques". La liste exhaustive des objets sociaux
est disponible au lien suivant: https://www.data.gouv.fr/fr/datasets/repertoire-national-des-associations-nomenclature-waldec
(environ 300 entrées).'
properties:
code:
type: string
title: Code de l'objet social
example: '009040'
nullable: true
libelle:
type: string
title: Libellé de l'objet social
example: clubs troisième âge
nullable: true
required:
- code
- libelle
champ_action_territorial:
title: Champ d'action territorial
example: départemental
type: string
enum:
- national
- international
- régional
- départemental
- local
nullable: true
activite_principale:
type: object
additionalProperties: false
title: Activité principale
description: "Lorsque l'association est immatriculée au
répertoire Sirene, elle se voit attribuer un code APE.
Ce code de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. \n \n Nomemclature
d'activité française - NAF rév.2 de l'Insee : https://www.insee.fr/fr/information/2120875"
required:
- code
- libelle
- annee
properties:
code:
type: string
title: Code de l'activité principale
example: 88.99B
nullable: true
libelle:
type: string
title: Libellé de l'activité principale
example: Action sociale sans hébergement n.c.a.
nullable: true
annee:
title: Année de l'activité principale
type: string
example: '2012'
nullable: true
tranche_effectif:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'entité
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents (créés
il y a moins de trois ans). Les délais de récolte et
traitement font que les valeurs indiquées datent de
l’année N-2 ou N-3. Cette information est issue du répertoire
Sirene et ne concerne donc que les associations qui
y sont immatriculées.
required:
- code
- libelle
- annee
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale :
\n \n - NN : Unités non employeuses (pas de salarié
au cours de l'année de référence et pas d'effectif
au 31/12). Cette tranche peut contenir quelques
effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou
2 salariés \n - 02 : 3 à 5 salariés \n - 03 : 6
à 9 salariés \n - 11 : 10 à 19 salariés \n - 12
: 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999
salariés \n - 42 : 1 000 à 1 999 salariés \n - 51
: 2 000 à 4 999 salariés \n - 52 : 5 000 à 9 999
salariés \n - 53 : 10 000 salariés et plus \n \n
Plus d'informations dans la documentation Insee
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
libelle:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
annee:
title: Année d'affectation du code effectif
type: string
example: '2013'
nullable: true
economie_sociale_et_solidaire:
title: Indique si l'association appartient à de l'économie
sociale et solidaire (ESS)
type: boolean
nullable: true
example: true
date_appartenance_ess:
title: Date d'appartenance à l'ESS
type: string
format: date
nullable: true
example: '2019-01-01'
etablissements:
title: Liste des établissements de l'association pour lesquels
des informations sont disponibles
type: array
items:
type: object
additionalProperties: false
required:
- siren
- siret
- siege
- nom
- telephone
- courriel
- actif
- date_debut_activite
- adresse
- activite_principale
- tranche_effectif
- representants_legaux
- rhs
- comptes
- documents_dac
properties:
siren:
type: string
title: Numéro SIREN de l'association à laquelle l'établissement
est lié
example: '123456789'
siret:
type: string
title: Numéro SIRET de l'établissement
example: '12345678900001'
actif:
type: boolean
title: Indique si l'établissement est actif
description: Cette information provient du répertoire
Sirene.
example: true
siege:
type: boolean
title: Indique si l'établissement est le siège de l'association
description: Cette information provient du répertoire
Sirene.
example: true
nom:
type: string
title: Enseigne de l'établissement
description: Cette valeur est très rarement renseignée.
Elle provient du répertoire Sirene ou des documents
administratifs complémentaires (DAC).
example: Croix rouge française
nullable: true
telephone:
type: string
title: Numéro de téléphone de l'établissement
description: Cette information provient du répertoire
Sirene ou des documents administratifs complémentaires
(DAC).
example: '0123456789'
nullable: true
courriel:
type: string
title: Courriel de l'établissement
description: Cette information provient des documents
administratifs complémentaires (DAC).
example: contact@association.fr
nullable: true
date_debut_activite:
type: string
format: date
title: Date de début d'activité de l'établissement
description: Cette information provient du répertoire
Sirene.
example: '2019-01-01'
nullable: true
adresse:
title: Adresse de l'établissement
description: Cette information provient du répertoire
Sirene.
type: object
additionalProperties: false
properties:
complement:
title: Complément d'adresse
type: string
example: ''
nullable: true
numero_voie:
title: Numéro de voie
type: string
example: '33'
nullable: true
type_voie:
title: Type de voie
type: string
example: rue
nullable: true
libelle_voie:
title: Libellé de la voie
type: string
example: de Modagor
nullable: true
distribution:
title: Distribution
type: string
nullable: true
code_insee:
title: Code INSEE de la commune
type: string
example: '75108'
nullable: true
code_postal:
title: Code postal de la commune
type: string
example: '75009'
nullable: true
commune:
title: Nom de la commune
type: string
example: Paris
nullable: true
activite_principale:
type: object
additionalProperties: false
title: Activité principale
description: "Lorsque l'association est immatriculée
au répertoire Sirene, elle se voit attribuer un code
APE. Ce code de 4 chiffres + 1 lettre est extrait
de la nomenclature d'activité française (NAF) de l'Insee.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2120875"
required:
- code
- libelle
properties:
code:
type: string
title: Code de l'activité principale
example: 88.99B
nullable: true
libelle:
type: string
title: Libellé de l'activité principale
example: Action sociale sans hébergement n.c.a.
nullable: true
tranche_effectif:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'entité
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents
(créés il y a moins de trois ans). Les délais de récolte
et traitement font que les valeurs indiquées datent
de l’année N-2 ou N-3. Cette information est issue
du répertoire Sirene et ne concerne donc que les associations
qui y sont immatriculées.
required:
- code
- libelle
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale
: \n \n - NN : Unités non employeuses (pas de
salarié au cours de l'année de référence et pas
d'effectif au 31/12). Cette tranche peut contenir
quelques effectifs inconnus \n - 00 : 0 salarié
(n'ayant pas d'effectif au 31/12 mais ayant employé
des salariés au cours de l'année de référence)
\n - 01 : 1 ou 2 salariés \n - 02 : 3 à 5 salariés
\n - 03 : 6 à 9 salariés \n - 11 : 10 à 19 salariés
\n - 12 : 20 à 49 salariés \n - 21 : 50 à 99 salariés
\n - 22 : 100 à 199 salariés \n - 31 : 200 à 249
salariés \n - 32 : 250 à 499 salariés \n - 41
: 500 à 999 salariés \n - 42 : 1 000 à 1 999 salariés
\n - 51 : 2 000 à 4 999 salariés \n - 52 : 5 000
à 9 999 salariés \n - 53 : 10 000 salariés et
plus \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
libelle:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
rhs:
title: Information sur les moyens humains
type: array
items:
type: object
additionalProperties: false
required:
- annee
- nombre_benevoles
- nombre_volontaires
- nombre_salaries
- nombre_salaries_etpt
- nombre_emplois_aides
- nombre_personnels_detaches
- nombre_adherents
properties:
annee:
type: string
title: Année de la donnée
example: '2019'
nombre_benevoles:
type: integer
title: Nombre de bénévoles
example: 10
nombre_volontaires:
type: integer
title: Nombre de volontaires
example: 11
nombre_salaries:
type: integer
title: Nombre de salariés
example: 12
nombre_salaries_etpt:
type: number
format: float
title: Nombre de salariés à temps partiel
example: 13.0
nombre_emplois_aides:
type: integer
title: Nombre d'emplois aidés
example: 14
nombre_personnels_detaches:
type: integer
title: Nombre de personnels détachés
example: 15
nombre_adherents:
type: object
additionalProperties: false
title: Nombre d'adhérents
required:
- total
- hommes
- femmes
properties:
hommes:
type: integer
title: Nombre d'adhérents hommes
example: 16
femmes:
type: integer
title: Nombre d'adhérentes femmes
example: 17
total:
type: integer
title: Nombre d'adhérents total
example: 33
comptes:
title: Comptes de résultat et financements perçus
type: array
items:
type: object
additionalProperties: false
required:
- annee
- commisaire_aux_comptes
- montant_dons
- cause_subventions
- montant_subventions
- montant_aides_sur_3ans
- total_charges
- total_resultat
- total_produits
properties:
annee:
type: string
title: Année associée à ce compte
example: '2019'
commisaire_aux_comptes:
title: Indique si l'association possède un commissaire
aux comptes
type: boolean
example: true
montant_dons:
title: Montant des dons perçus
type: number
example: 1000.0
cause_subventions:
title: Cause des subventions
type: string
example: Subventions d'investissement
nullable: true
montant_subventions:
title: Montant des subventions
type: number
example: 1200.0
montant_aides_sur_3ans:
title: Montant total des aides sur 3 ans
type: number
example: 1230.0
total_charges:
title: Total des charges
type: number
example: 1234.0
total_resultat:
title: Total du résultat
type: number
example: 2000.0
total_produits:
title: Total des produits
type: number
example: 3000.0
representants_legaux:
title: Liste des représentants légaux de l'établissement
description: Les personnes renvoyées dans cette liste
sont uniquement celles renseignées comme représentant
légal actif. Ces informations proviennent des documents
administratifs complémentaires (DAC).
type: array
items:
type: object
additionalProperties: false
required:
- civilite
- nom
- prenom
- courriel
- fonction
- telephone
- valideur_cec
- publication_internet
properties:
civilite:
type: string
title: Civilité du représentant légal
example: Monsieur
nom:
type: string
title: Nom du représentant légal
description: Le nom est systématiquement en majuscule.
example: DUPONT
prenom:
type: string
title: Prénom du représentant légal
description: Le prénom est systématiquement en
majuscule.
example: JEAN
fonction:
type: string
title: Fonction du représentant légal
description: Il s'agit d'un champ déroulant avec
possibilité de modification libre, la liste
des fonctions est donc non exhaustive.
example: Président
valideur_cec:
type: boolean
title: Indique si le représentant légal est valideur
CEC
description: "Le compte d'engagement citoyen (CEC)
est un dispositif visant à valoriser l'engagement
bénévoles des responsables associatifs. Pour
fonctionner, les bénévoles doivent déclarer
leurs engagements, l'exactitude de ces déclarations
doit être attestée par un dirigeant bénévole
de l'association désigné \"validateur CEC \".
\n \n Pour en savoir plus : https://www.associations.gouv.fr/valideur-cec.html"
example: true
publication_internet:
type: boolean
title: Indique si les coordonnées du représentant
légal sont publiables
description: Si ce champ est à "true ", le téléphone
et le courriel du représentant légal ont la
possibilité d'être publiés sur internet.
example: true
telephone:
type: string
title: Numéro de téléphone du représentant légal
example: '0623456789'
nullable: true
courriel:
type: string
title: Courriel du représentant légal
example: dupont.jean@association.fr
nullable: true
documents_dac:
title: Liste des documents administratifs complémentaires
(DAC) associés à cet établissement
description: Tous les documents DAC sont renvoyés à
l'exception des documents marqués comme étant des
RIBs ou ceux marqué comme étant supprimés.
type: array
items:
type: object
additionalProperties: false
required:
- nom
- annee_validite
- commentaire
- etat
- type
- date_depot
- url
properties:
id:
type: string
title: Identifiant interne du document. L'ID a
été hashée pour des raisons de confidentialité.
example: 3d53b6bfe05370b45df327123656e54260ce56e1fafd1881853cebae6ead8458
nom:
type: string
title: Nom du document
example: Rapport annuel 2019.pdf
annee_validite:
type: string
title: Année de validité du document
description: Cette valeur peut-être omise si le
document n'est pas lié à une année
example: '2019'
nullable: true
commentaire:
type: string
title: Commentaire du document
example: Les comptes annuels sont consolidés au
niveau national
nullable: true
etat:
type: string
title: État du document
example: courant
enum:
- courant
- archivé
type:
type: string
title: Type du document
description: "La liste des types est la suivante
(liste non-exhaustive, le champ pouvant être
renseigné manuellement): \n \n - Budget prévisionnel
\n - Comptes du dernier exercice clos \n - Rapport
du commissaire au compte \n - Rapport d'activité
(le plus récent) \n - Rapport financier \n -
Arrêté de l'agrement \n - Attestation d’affiliation
\n - Projet sportif "
example: Budget prévisionnel
date_depot:
type: string
format: date
title: Date de dépôt du document
example: '2019-01-01'
nullable: true
url:
type: string
title: URL du document
example: https://associations.api.gouv.fr/documents/rapport_annuel.pdf
reseaux_affiliation:
title: Affiliation à une union, fédération ou réseau
type: array
items:
type: object
additionalProperties: false
required:
- nom
- numero
- rna
- siret
- objet
- nombre_licencies
properties:
nom:
type: string
title: Nom du réseau
example: Réseau des associations de parents d'élèves
numero:
type: string
title: Numéro d'affiliation à la fédération
example: IDF0234567
nullable: true
rna:
type: string
title: Numéro RNA du réseau
example: W123456789
nullable: true
siret:
type: string
title: Numéro SIRET du réseau
example: '12345678901234'
nullable: true
objet:
type: string
title: Objet du réseau
example: Promouvoir l'engagement des parents d'élèves
dans l'éducation de leurs enfants
nullable: true
adresse:
title: Adresse du réseau
type: object
additionalProperties: false
properties:
complement:
title: Complément d'adresse
type: string
example: ''
nullable: true
numero_voie:
title: Numéro de voie
type: string
example: '33'
nullable: true
type_voie:
title: Type de voie
type: string
example: rue
nullable: true
libelle_voie:
title: Libellé de la voie
type: string
example: de Modagor
nullable: true
distribution:
title: Distribution
type: string
nullable: true
code_insee:
title: Code INSEE de la commune
type: string
example: '75108'
nullable: true
code_postal:
title: Code postal de la commune
type: string
example: '75009'
nullable: true
commune:
title: Nom de la commune
type: string
example: Paris
nullable: true
telephone:
type: string
title: Numéro de téléphone du réseau
example: '0123456789'
nullable: true
courriel:
type: string
title: Courriel du réseau
example: reseau@association.fr
nullable: true
attestation_affiliation_url:
type: string
title: URL de l'attestation d'affiliation
example: https://associations.api.gouv.fr/documents/attestation_affiliation.pdf
nullable: true
nombre_licencies:
type: object
additionalProperties: false
title: Nombre de licenciés
description: Ces informations ne sont pas tout le temps
renseignées
required:
- total
- hommes
- femmes
properties:
hommes:
type: integer
title: Nombre de licenciés hommes
example: 16
nullable: true
femmes:
type: integer
title: Nombre de licenciées femmes
example: 17
nullable: true
total:
type: integer
title: Nombre de licenciés total
example: 33
nullable: true
documents_rna:
title: Documents de l'association issus du répertoire national
des associations (RNA)
type: array
items:
type: object
additionalProperties: false
required:
- type
- sous_type
- date_depot
- url
properties:
id:
type: string
title: Identifiant interne du document. L'ID a été hashée
pour raisons de confidentialité.
example: 7ac1b8d7010bb6cd3a3e84e7f90136b880bbc899e428ece49333372911ab9052
type:
type: string
title: Type du document
enum:
- Pièce
- Récipicé
example: Pièce
sous_type:
type: object
additionalProperties: false
title: Sous-type du document
required:
- code
- libelle
properties:
code:
type: string
title: Code du sous-type
example: STC
enum:
- STC
- LDC
- PV
- MD
- ARR
- DCR
- FRM
- CR
- RCS
- RCF
- LAC
- MDT
- ADC
- ETC
- LAD
- PV2
- FIN
- IMC
- LAS
- RCC
- RIN
- NJO
- CJO
libelle:
type: string
title: Libellé du sous-type
example: Statuts
enum:
- Statuts
- Liste dirigeants
- Procès verbal
- Récépissé de modification
- Arrêté
- Décret
- formulaire déclaration
- Récepissé de création
- télé-récépissé signé automatiquement
- Récépissé délivré
- Lettre de déclaration
- Lettre de mandat
- Adhésion(s) (liste complète)
- Etablissement(s) (liste complète)
- Lettre de démission
- Deuxième PV
- Document financier
- Immeuble(s) (liste complète)
- Lettre
- Autre
- règlement intérieur
date_depot:
type: string
format: date
title: Date de dépôt du document
description: Parfois cette date est vide, vous pouvez
vous référer à l'année (clé annee_depot).
example: '2019-01-01'
nullable: true
annee_depot:
type: string
title: Année de dépôt du document
example: '2019'
nullable: true
url:
type: string
title: URL de téléchargement du document
example: https://associations.api.gouv.fr/documents/rapport_annuel.pdf
required:
- rna
- ancien_id
- siren
- nom
- active
- sigle
- reconnue_utilite_publique
- siret_siege
- forme_juridique
- regime
- groupement
- eligibilite_cec
- raison_non_eligibilite_cec
- impots_commerciaux
- date_creation
- date_dissolution
- date_publication_reconnue_utilite_publique
- date_publication_journal_officiel
- adresse_siege
- adresse_gestion
- alsace_moselle
- composition_reseau
- agrements
- activites
- etablissements
- reseaux_affiliation
- documents_rna
additionalProperties: false
links:
type: object
meta:
type: object
properties:
internal_id:
type: string
title: Identifiant interne de l'entité au sein de l'API manager
du Ministère de l'Intérieur
example: '1234567890'
date_derniere_mise_a_jour_sirene:
title: Date de dernière mise à jour de l'association dans
le répertoire Sirene
type: string
format: date
example: '2019-01-01'
nullable: true
date_derniere_mise_a_jour_rna:
title: Date de dernière mise à jour de l'association dans
le répertoire national des associations (RNA)
type: string
format: date
example: '2019-01-01'
nullable: true
required:
- internal_id
- date_derniere_mise_a_jour_sirene
- date_derniere_mise_a_jour_rna
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00333'
title: Entité non traitable
detail: Le numéro de siren ou le numéro d'association indiqué
n'est pas correctement formatté
source:
parameter: id
meta: {}
summary: Entité non traitable
description: Le numéro de siren ou le numéro d'association indiqué
n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Association non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations#erreurs.
content:
application/json:
examples:
entite_non_trouvee_29003:
value:
errors:
- code: '29003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: DJEPVA
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '29002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: DJEPVA
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_29999:
value:
errors:
- code: '29999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: DJEPVA
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '29020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: DJEPVA
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/djepva/api-association/associations/130025265?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/djepva/api-association/associations/open_data/{siren_or_rna}":
get:
summary: Données association en open data
tags:
- Informations générales
parameters:
- name: siren_or_rna
in: path
description: Siren de l'association ou le numéro RNA
examples:
openstreetmap_france:
value: W751212517
summary: ID RNA Openstreetmap France
croix_rouge:
value: '775672272'
summary: SIREN de la Croix-Rouge France
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Informations et documents de référence d'une association et de
ses établissements, accessibles en open data, issues du répertoire national
des associations (RNA).
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations_open_data#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations_open_data#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations_open_data#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Association trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_mi_unites_legales_open_data
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
rna:
type: string
title: Numéro RNA
description: "Numéro identifiant de toute association inscrite
au répertoire national des associations (RNA). Il est constitué
de la lettre W suivie de 9 chiffres. \n \n Cas particulier
: Si l'association relève du droit local d'Alsace-Moselle,
elle n'est pas immatriculée au RNA et ne possède donc pas
de numéro RNA. Dans ce cas, le champ est vide."
example: W751080001
nullable: true
ancien_id:
type: string
title: Ancien identifiant de l'entité avant l'arrêté du 14
octobre 2009 portant la création du RNA
example: '1234567890'
nullable: true
siren:
type: string
title: Numéro SIREN
description: 'Numéro identifiant des associations inscrites
au répertoire Sirene. Cet enregistrement n''est pas obligatoire
: pour les associations qui n''ont pas de numéro SIREN,
le champ est vide.'
example: '751080001'
nullable: true
nom:
title: Nom de l'association (raison sociale)
description: Ce nom provient du répertoire national des associations
(RNA) ou du répertoire Sirene. Si le régime de l'association
est indiqué "Loi 1901", le nom provient toujours du RNA.
type: string
example: LA PRÉVENTION ROUTIERE
active:
title: État de l'association
type: boolean
example: true
description: L'association est active si elle est enregistrée
à la Préfecture et si elle n'a pas été dissoute. Si le régime
de l'association est "Loi 1901" l'information provient du
RNA, autrement elle est issue du répertoire Sirene.
sigle:
title: Sigle de l'association
description: Ce sigle provient du répertoire national des
associations (RNA) ou du répertoire Sirene. Si le régime
de l'association est indiqué "Loi 1901", le nom provient
toujours du RNA.
type: string
example: LPR
nullable: true
reconnue_utilite_publique:
title: Indique si l'association est reconnue d'utilité publique
type: boolean
example: false
siret_siege:
title: Numéro SIRET du siège social
description: 'Les établissements sièges des associations
inscrites au répertoire Sirene ont un numéro identifiant
: le SIRET. Pour les associations qui ne sont pas répertoriées,
le champ est vide.'
type: string
example: '75108000100013'
nullable: true
forme_juridique:
type: object
additionalProperties: false
title: Forme juridique
required:
- code
- libelle
properties:
code:
title: Code de la forme juridique de l'unité légale
type: string
example: '9220'
description: 'Nomenclature exhaustive fournie par l''Insee
: https://www.insee.fr/fr/information/2028129'
nullable: true
libelle:
title: Libellé associé au code de la forme juridique de
l'unité légale
type: string
example: Association déclarée
description: "indique le libellé correspondant au code
juridique. Si le code ne correspond à aucun libellé
la valeur 'non référencé' est utilisée. \n \n Nomenclature
exhaustive fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
nullable: true
regime:
title: Régime de l'association
type: string
description: "Les deux régimes possibles sont 'Loi 1901' et
'Alsace-Moselle'. \n \n Le régime \"Loi 1901\" est le cas
général des associations établies en France. Les associations
dont le siège se trouve en Alsace et en Moselle sont régies
par un droit local, dit \"régime Alsace-Moselle\". \n \n
Cette information provient des documents administratifs
complémentaires (DAC). \n \n Pour en savoir plus sur les
particularités du régime Alsace-Moselle : https://www.associations.gouv.fr/le-droit-local-des-associations-en-alsace-moselle.html"
example: Loi 1901
enum:
- Loi 1901
- Alsace-Moselle
groupement:
title: Type de groupement
description: "Une association peut faire partie d'un groupement
de type union ou fédération. \n \n Ce champ est à 'Simple'
si l'association n'est pas membre d'un groupement."
type: string
example: Simple
enum:
- Simple
- Fédération
- Union
nullable: true
eligibilite_cec:
title: Indique si l'association est éligible au CEC
description: "Indique si l'association est éligible au compte
d'engagement citoyen (CEC). Ce dispositif permet de bénéficier
de droits à formation supplémentaires et vise valoriser
l'engagement bénévole de responsables associatifs.\nPour
en savoir plus sur le CEC : https://www.associations.gouv.fr/le-compte-d-engagement-citoyen-qu-est-ce-que-c-est.html "
type: boolean
example: false
enum:
- true
- false
raison_non_eligibilite_cec:
title: Raison de l'inéligibilité au CEC
description: Ce champ est vide si l'association est éligible
au CEC.
type: string
example: L’association n’a pas trois ans d’existence
enum:
- L’association n’a pas trois ans d’existence
- L’objet de l’association ne rentre pas dans les critères
d’éligibilité au CEC
- L’association n’a pas trois ans d’existence et son objet
ne rentre pas dans les critères d’éligibilité au CEC
nullable: true
impots_commerciaux:
title: Indique si l'association est assujettie aux impôts
commerciaux
description: "En fonction de ses missions et de ses activités,
une association peut être soumise aux impôts commerciaux
(à la TVA ou à l’impôt sur les sociétés). Ce cas particulier
concerne notamment les associations exerçant une activité
lucrative. \n \n En savoir plus : https://www.associations.gouv.fr/l-association-et-les-impots-commerciaux.html"
type: boolean
example: true
date_creation:
title: Date de création de l'association
description: La date de création provient en priorité de la
base RNA si celle-ci est présente, sinon de la base Sirene.
type: string
format: date
example: '2015-01-01'
nullable: true
date_dissolution:
title: Date de dissolution de l'association
description: La date de dissolution provient en priorité de
la base RNA si celle-ci est présente, sinon de la base Sirene.
type: string
format: date
example: '2016-01-01'
nullable: true
date_publication_reconnue_utilite_publique:
title: Date de publication de la reconnaissance d'utilité
publique
type: string
format: date
example: '2017-01-01'
nullable: true
date_publication_journal_officiel:
title: Date de publication au Journal Officiel de la création
de l'association
description: Cette information est exclusive aux associations
"Loi 1901" et provient du répertoire national des associations
(RNA).
type: string
format: date
example: '2018-01-01'
nullable: true
adresse_siege:
type: object
additionalProperties: false
title: Adresse du siège social de l'association
properties:
complement:
title: Complément d'adresse
type: string
example: ''
nullable: true
numero_voie:
title: Numéro de voie
type: string
example: '33'
nullable: true
type_voie:
title: Type de voie
type: string
example: rue
nullable: true
libelle_voie:
title: Libellé de la voie
type: string
example: de Modagor
nullable: true
distribution:
title: Distribution
type: string
nullable: true
code_insee:
title: Code INSEE de la commune
type: string
example: '75108'
nullable: true
code_postal:
title: Code postal de la commune
type: string
example: '75009'
nullable: true
commune:
title: Nom de la commune
type: string
example: Paris
nullable: true
required:
- complement
- numero_voie
- type_voie
- libelle_voie
- distribution
- code_insee
- code_postal
- commune
adresse_gestion:
type: object
additionalProperties: false
title: Adresse de gestion de l'association
description: L'adresse de gestion est l'adresse à laquelle
se trouve les bureaux administratifs.
properties:
complement:
title: Complément d'adresse
type: string
example: ''
nullable: true
numero_voie:
title: Numéro de voie
type: string
example: '33'
nullable: true
type_voie:
title: Type de voie
type: string
example: rue
nullable: true
libelle_voie:
title: Libellé de la voie
type: string
example: de Modagor
nullable: true
distribution:
title: Distribution
type: string
nullable: true
code_insee:
title: Code INSEE de la commune
type: string
example: '75108'
nullable: true
code_postal:
title: Code postal de la commune
type: string
example: '75009'
nullable: true
commune:
title: Nom de la commune
type: string
example: Paris
nullable: true
required:
- complement
- numero_voie
- type_voie
- libelle_voie
- distribution
- code_insee
- code_postal
- commune
alsace_moselle:
title: Attributs relatifs aux associations de droit local
d'Alsace-Moselle
description: Ces information proviennent des documents administratifs
complémentaires (DAC). Les attributs sont vides si l'association
est une association "Loi 1901".
type: object
additionalProperties: false
required:
- tribunal_instance
- volume
- folio
- date_publication_registre_association
properties:
tribunal_instance:
title: Tribunal d'instance
type: string
example: Tribunal d'instance de Strasbourg
nullable: true
enum:
- Tribunal d'instance de Metz
- Tribunal d'instance de Saint-Avold
- Tribunal d'instance de Sarrebourg
- Tribunal d'instance de Sarreguemines
- Tribunal d'instance de de Thionville
- Tribunal d'instance de Haguenau
- Tribunal d'instance d’Illkirch
- Tribunal d'instance de Molsheim
- Tribunal d'instance de Saverne
- Tribunal d'instance de Schiltigheim
- Tribunal d'instance de Sélestat
- Tribunal d'instance de Strasbourg
- Tribunal d'instance de Colmar
- Tribunal d'instance de Guebwiller
- Tribunal d'instance de Mulhouse
- Tribunal d'instance de Thann
volume:
title: Volume du registre du tribunal d'instance
type: string
example: '122'
nullable: true
folio:
title: Folio du volume du registre du tribunal d'instance
type: string
example: '082'
nullable: true
date_publication_registre_association:
title: Date de publication au registre des associations
d'Alsace-Moselle
type: string
format: date
example: '2019-01-01'
nullable: true
composition_reseau:
title: Composition du réseau, de l'union ou de la fédération
type: array
items:
type: object
additionalProperties: false
required:
- nom
- rna
- siret
- telephone
- courriel
- objet
- adresse
- site_web
properties:
nom:
type: string
title: Nom du membre du réseau
example: Association des parents d'élèves de l'école
primaire de la ville
rna:
type: string
title: Numéro RNA du membre du réseau
example: W123456789
nullable: true
siret:
type: string
title: Numéro SIRET du membre du réseau
example: '12345678901234'
nullable: true
telephone:
type: string
title: Numéro de téléphone du membre du réseau
example: '0123456789'
nullable: true
courriel:
type: string
title: Courriel du membre du réseau
example: reseau@association.fr
nullable: true
objet:
type: string
title: Objet du membre du réseau
example: Promouvoir l'engagement des parents d'élèves
dans l'éducation de leurs enfants
adresse:
type: object
additionalProperties: false
title: Adresse du siège social de l'association
properties:
complement:
title: Complément d'adresse
type: string
example: ''
nullable: true
numero_voie:
title: Numéro de voie
type: string
example: '33'
nullable: true
type_voie:
title: Type de voie
type: string
example: rue
nullable: true
libelle_voie:
title: Libellé de la voie
type: string
example: de Modagor
nullable: true
distribution:
title: Distribution
type: string
nullable: true
code_insee:
title: Code INSEE de la commune
type: string
example: '75108'
nullable: true
code_postal:
title: Code postal de la commune
type: string
example: '75009'
nullable: true
commune:
title: Nom de la commune
type: string
example: Paris
nullable: true
required:
- complement
- numero_voie
- type_voie
- libelle_voie
- distribution
- code_insee
- code_postal
- commune
site_web:
title: Site internet du membre du réseau
type: string
example: reseau-association.fr
nullable: true
agrements:
title: Liste des agréments administratifs associés à l'association
type: array
items:
type: object
additionalProperties: false
required:
- numero
- date_attribution
- type
- niveau
- attributeur
- url
properties:
numero:
type: string
title: Numéro de l'agrément
description: Ce champ étant libre, il n'y a pas de format
spécifique.
example: 05.11.2018
date_attribution:
type: string
format: date
title: Date d'attribution de l'agrément
example: '2018-11-05'
type:
type: string
title: Type d'agrément
description: "Liste non-exhaustive des agréments : \n
\n - Agriculture \n - CIDFF \n - Consommation \n -
Ecologie \n - Education nationale \n - Formation \n
- Formation professionnelle \n - JEP \n - Santé \n
- Service civique \n - Sport \n - Tourisme \n - Autre "
example: Formation
niveau:
type: string
title: Niveau de l'agrément
example: local
enum:
- national
- local
attributeur:
type: string
title: Nom de l'organisme qui a attribué l'agrément
example: Ministère de l'Education nationale
url:
type: string
title: URL de l'agrément
nullable: true
example: https://associations.api.gouv.fr/agrements/05.11.2018.pdf
activites:
title: Liste des activités de l'association
type: object
additionalProperties: false
required:
- objet
- objet_social1
- objet_social2
- champ_action_territorial
- activite_principale
- tranche_effectif
- economie_sociale_et_solidaire
- date_appartenance_ess
properties:
objet:
title: Objet de l'association
description: Définit l'objet de l'association et les activités
envisagées pour atteindre l'objet. Ce champ délivre
l'objet tel que rédigé dans les statuts de l'association.
type: string
nullable: true
example: L'association a pour objet de promouvoir la pratique
du sport de haut niveau et de contribuer à la formation
des jeunes sportifs.
objet_social1:
type: object
additionalProperties: false
title: Objet social principal
description: 'L''objet social suit la nomenclature nationale
Waldec et permet de rattacher l''objet de l''association
à une catégorie, comme par exemple : "centres aérés,
colonies de vacances", "défense des droits des personnes
en situation de handicap" ou "loisirs scientifiques
et techniques". La liste exhaustive des objets sociaux
est disponible au lien suivant: https://www.data.gouv.fr/fr/datasets/repertoire-national-des-associations-nomenclature-waldec
(environ 300 entrées).'
properties:
code:
type: string
title: Code de l'objet social
example: '017055'
nullable: true
libelle:
type: string
title: Libellé de l'objet social
example: accompagnement, aide aux malades
nullable: true
required:
- code
- libelle
objet_social2:
type: object
additionalProperties: false
title: Objet social secondaire
description: 'L''objet social suit la nomenclature nationale
Waldec et permet de rattacher l''objet de l''association
à une catégorie, comme par exemple : "centres aérés,
colonies de vacances", "défense des droits des personnes
en situation de handicap" ou "loisirs scientifiques
et techniques". La liste exhaustive des objets sociaux
est disponible au lien suivant: https://www.data.gouv.fr/fr/datasets/repertoire-national-des-associations-nomenclature-waldec
(environ 300 entrées).'
properties:
code:
type: string
title: Code de l'objet social
example: '009040'
nullable: true
libelle:
type: string
title: Libellé de l'objet social
example: clubs troisième âge
nullable: true
required:
- code
- libelle
champ_action_territorial:
title: Champ d'action territorial
example: départemental
type: string
enum:
- national
- international
- régional
- départemental
- local
nullable: true
activite_principale:
type: object
additionalProperties: false
title: Activité principale
description: "Lorsque l'association est immatriculée au
répertoire Sirene, elle se voit attribuer un code APE.
Ce code de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. \n \n Nomemclature
d'activité française - NAF rév.2 de l'Insee : https://www.insee.fr/fr/information/2120875"
required:
- code
- libelle
- annee
properties:
code:
type: string
title: Code de l'activité principale
example: 88.99B
nullable: true
libelle:
type: string
title: Libellé de l'activité principale
example: Action sociale sans hébergement n.c.a.
nullable: true
annee:
title: Année de l'activité principale
type: string
example: '2012'
nullable: true
tranche_effectif:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'entité
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents (créés
il y a moins de trois ans). Les délais de récolte et
traitement font que les valeurs indiquées datent de
l’année N-2 ou N-3. Cette information est issue du répertoire
Sirene et ne concerne donc que les associations qui
y sont immatriculées.
required:
- code
- libelle
- annee
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale :
\n \n - NN : Unités non employeuses (pas de salarié
au cours de l'année de référence et pas d'effectif
au 31/12). Cette tranche peut contenir quelques
effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou
2 salariés \n - 02 : 3 à 5 salariés \n - 03 : 6
à 9 salariés \n - 11 : 10 à 19 salariés \n - 12
: 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999
salariés \n - 42 : 1 000 à 1 999 salariés \n - 51
: 2 000 à 4 999 salariés \n - 52 : 5 000 à 9 999
salariés \n - 53 : 10 000 salariés et plus \n \n
Plus d'informations dans la documentation Insee
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
libelle:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
annee:
title: Année d'affectation du code effectif
type: string
example: '2013'
nullable: true
economie_sociale_et_solidaire:
title: Indique si l'association appartient à de l'économie
sociale et solidaire (ESS)
type: boolean
nullable: true
example: true
date_appartenance_ess:
title: Date d'appartenance à l'ESS
type: string
format: date
nullable: true
example: '2019-01-01'
etablissements:
title: Liste des établissements de l'association pour lesquels
des informations sont disponibles
type: array
items:
type: object
additionalProperties: false
required:
- siren
- siret
- siege
- nom
- telephone
- courriel
- actif
- date_debut_activite
- adresse
- activite_principale
- tranche_effectif
- rhs
- comptes
properties:
siren:
type: string
title: Numéro SIREN de l'association à laquelle l'établissement
est lié
example: '123456789'
siret:
type: string
title: Numéro SIRET de l'établissement
example: '12345678900001'
actif:
type: boolean
title: Indique si l'établissement est actif
description: Cette information provient du répertoire
Sirene.
example: true
siege:
type: boolean
title: Indique si l'établissement est le siège de l'association
description: Cette information provient du répertoire
Sirene.
example: true
nom:
type: string
title: Enseigne de l'établissement
description: Cette valeur est très rarement renseignée.
Elle provient du répertoire Sirene ou des documents
administratifs complémentaires (DAC).
example: Croix rouge française
nullable: true
telephone:
type: string
title: Numéro de téléphone de l'établissement
description: Cette information provient du répertoire
Sirene ou des documents administratifs complémentaires
(DAC).
example: '0123456789'
nullable: true
courriel:
type: string
title: Courriel de l'établissement
description: Cette information provient des documents
administratifs complémentaires (DAC).
example: contact@association.fr
nullable: true
date_debut_activite:
type: string
format: date
title: Date de début d'activité de l'établissement
description: Cette information provient du répertoire
Sirene.
example: '2019-01-01'
nullable: true
adresse:
title: Adresse de l'établissement
description: Cette information provient du répertoire
Sirene.
type: object
additionalProperties: false
properties:
complement:
title: Complément d'adresse
type: string
example: ''
nullable: true
numero_voie:
title: Numéro de voie
type: string
example: '33'
nullable: true
type_voie:
title: Type de voie
type: string
example: rue
nullable: true
libelle_voie:
title: Libellé de la voie
type: string
example: de Modagor
nullable: true
distribution:
title: Distribution
type: string
nullable: true
code_insee:
title: Code INSEE de la commune
type: string
example: '75108'
nullable: true
code_postal:
title: Code postal de la commune
type: string
example: '75009'
nullable: true
commune:
title: Nom de la commune
type: string
example: Paris
nullable: true
activite_principale:
type: object
additionalProperties: false
title: Activité principale
description: "Lorsque l'association est immatriculée
au répertoire Sirene, elle se voit attribuer un code
APE. Ce code de 4 chiffres + 1 lettre est extrait
de la nomenclature d'activité française (NAF) de l'Insee.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2120875"
required:
- code
- libelle
properties:
code:
type: string
title: Code de l'activité principale
example: 88.99B
nullable: true
libelle:
type: string
title: Libellé de l'activité principale
example: Action sociale sans hébergement n.c.a.
nullable: true
tranche_effectif:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'entité
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents
(créés il y a moins de trois ans). Les délais de récolte
et traitement font que les valeurs indiquées datent
de l’année N-2 ou N-3. Cette information est issue
du répertoire Sirene et ne concerne donc que les associations
qui y sont immatriculées.
required:
- code
- libelle
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale
: \n \n - NN : Unités non employeuses (pas de
salarié au cours de l'année de référence et pas
d'effectif au 31/12). Cette tranche peut contenir
quelques effectifs inconnus \n - 00 : 0 salarié
(n'ayant pas d'effectif au 31/12 mais ayant employé
des salariés au cours de l'année de référence)
\n - 01 : 1 ou 2 salariés \n - 02 : 3 à 5 salariés
\n - 03 : 6 à 9 salariés \n - 11 : 10 à 19 salariés
\n - 12 : 20 à 49 salariés \n - 21 : 50 à 99 salariés
\n - 22 : 100 à 199 salariés \n - 31 : 200 à 249
salariés \n - 32 : 250 à 499 salariés \n - 41
: 500 à 999 salariés \n - 42 : 1 000 à 1 999 salariés
\n - 51 : 2 000 à 4 999 salariés \n - 52 : 5 000
à 9 999 salariés \n - 53 : 10 000 salariés et
plus \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
libelle:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
rhs:
title: Information sur les moyens humains
type: array
items:
type: object
additionalProperties: false
required:
- annee
- nombre_benevoles
- nombre_volontaires
- nombre_salaries
- nombre_salaries_etpt
- nombre_emplois_aides
- nombre_personnels_detaches
- nombre_adherents
properties:
annee:
type: string
title: Année de la donnée
example: '2019'
nombre_benevoles:
type: integer
title: Nombre de bénévoles
example: 10
nombre_volontaires:
type: integer
title: Nombre de volontaires
example: 11
nombre_salaries:
type: integer
title: Nombre de salariés
example: 12
nombre_salaries_etpt:
type: number
format: float
title: Nombre de salariés à temps partiel
example: 13.0
nombre_emplois_aides:
type: integer
title: Nombre d'emplois aidés
example: 14
nombre_personnels_detaches:
type: integer
title: Nombre de personnels détachés
example: 15
nombre_adherents:
type: object
additionalProperties: false
title: Nombre d'adhérents
required:
- total
- hommes
- femmes
properties:
hommes:
type: integer
title: Nombre d'adhérents hommes
example: 16
femmes:
type: integer
title: Nombre d'adhérentes femmes
example: 17
total:
type: integer
title: Nombre d'adhérents total
example: 33
comptes:
title: Comptes de résultat et financements perçus
type: array
items:
type: object
additionalProperties: false
required:
- annee
- commisaire_aux_comptes
- montant_dons
- cause_subventions
- montant_subventions
- montant_aides_sur_3ans
- total_charges
- total_resultat
- total_produits
properties:
annee:
type: string
title: Année associée à ce compte
example: '2019'
commisaire_aux_comptes:
title: Indique si l'association possède un commissaire
aux comptes
type: boolean
example: true
montant_dons:
title: Montant des dons perçus
type: number
example: 1000.0
cause_subventions:
title: Cause des subventions
type: string
example: Subventions d'investissement
nullable: true
montant_subventions:
title: Montant des subventions
type: number
example: 1200.0
montant_aides_sur_3ans:
title: Montant total des aides sur 3 ans
type: number
example: 1230.0
total_charges:
title: Total des charges
type: number
example: 1234.0
total_resultat:
title: Total du résultat
type: number
example: 2000.0
total_produits:
title: Total des produits
type: number
example: 3000.0
required:
- rna
- ancien_id
- siren
- nom
- active
- sigle
- reconnue_utilite_publique
- siret_siege
- forme_juridique
- regime
- groupement
- eligibilite_cec
- raison_non_eligibilite_cec
- impots_commerciaux
- date_creation
- date_dissolution
- date_publication_reconnue_utilite_publique
- date_publication_journal_officiel
- adresse_siege
- adresse_gestion
- alsace_moselle
- composition_reseau
- agrements
- activites
- etablissements
additionalProperties: false
links:
type: object
meta:
type: object
properties:
internal_id:
type: string
title: Identifiant interne de l'entité au sein de l'API manager
du Ministère de l'Intérieur
example: '1234567890'
date_derniere_mise_a_jour_sirene:
title: Date de dernière mise à jour de l'association dans
le répertoire Sirene
type: string
format: date
example: '2019-01-01'
nullable: true
date_derniere_mise_a_jour_rna:
title: Date de dernière mise à jour de l'association dans
le répertoire national des associations (RNA)
type: string
format: date
example: '2019-01-01'
nullable: true
required:
- internal_id
- date_derniere_mise_a_jour_sirene
- date_derniere_mise_a_jour_rna
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations_open_data#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00333'
title: Entité non traitable
detail: Le numéro de siren ou le numéro d'association indiqué
n'est pas correctement formatté
source:
parameter: id
meta: {}
summary: Entité non traitable
description: Le numéro de siren ou le numéro d'association indiqué
n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Association non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations_open_data#erreurs.
content:
application/json:
examples:
entite_non_trouvee_29003:
value:
errors:
- code: '29003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: DJEPVA
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations_open_data#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '29002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: DJEPVA
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations_open_data#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_29999:
value:
errors:
- code: '29999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: DJEPVA
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations_open_data#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations_open_data#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '29020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: DJEPVA
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_mi_unites_legales_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/djepva/associations_open_data#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/djepva/api-association/associations/open_data/130025265?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/european_commission/unites_legales/{siren}/numero_tva":
get:
summary: N°TVA intracommunautaire français
deprecated: true
tags:
- Informations générales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren
in: path
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Numéro de TVA intracommunautaire français, vérifié auprès de la
Commission européenne.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_european_commission_vies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/commission_europeenne/numero_tva#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_european_commission_vies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/commission_europeenne/numero_tva#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Numéro de TVA trouvé
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_european_commission_vies
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
tva_number:
title: Numéro de TVA intracommunautaire français
type: string
description: Ce numéro de TVA est extrait du numéro de SIREN,
à l'aide de la règle de calcul du numéro de TVA, et validé
auprès du service VIES de la Commission européenne. Ce numéro
de TVA est forcément un numéro de TVA français.
example: FR48672039971
required:
- tva_number
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_european_commission_vies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/commission_europeenne/numero_tva#erreurs.
content:
application/json:
examples:
entite_non_trouvee_28003:
value:
errors:
- code: '28003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: Commission Européenne
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_european_commission_vies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/commission_europeenne/numero_tva#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_european_commission_vies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/commission_europeenne/numero_tva#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_28999:
value:
errors:
- code: '28999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: Commission Européenne
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_european_commission_vies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/commission_europeenne/numero_tva#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '28002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: Commission Européenne
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_european_commission_vies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/commission_europeenne/numero_tva#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_european_commission_vies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/commission_europeenne/numero_tva#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_european_commission_vies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/commission_europeenne/numero_tva#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '28020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: Commission Européenne
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_european_commission_vies, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/commission_europeenne/numero_tva#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/european_commission/unites_legales/130025265/numero_tva?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/fabrique_numerique_ministeres_sociaux/etablissements/{siret}/conventions_collectives":
get:
summary: Conventions collectives
deprecated: true
tags:
- Informations générales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Identifiants des conventions collectives d’un établissement et
lien vers les textes en vigueur.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fabrique_numerique_ministeres_sociaux_conventions_collectives, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fabrique_numerique_ministeres_sociaux/conventions_collectives#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fabrique_numerique_ministeres_sociaux_conventions_collectives, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fabrique_numerique_ministeres_sociaux/conventions_collectives#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fabrique_numerique_ministeres_sociaux_conventions_collectives, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fabrique_numerique_ministeres_sociaux/conventions_collectives#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_fabrique_numerique_ministeres_sociaux_conventions_collectives
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
data:
type: object
properties:
type:
title: Convention collective
type: string
example: convention_collective
enum:
- convention_collective
titre:
type: string
description: Titre historique de la convention collective
example: Convention collective nationale des bureaux
d'études techniques, des cabinets d'ingénieurs-conseils
et des sociétés de conseils du 15 décembre 1987.
titre_court:
type: string
description: Titre abrégé / d'usage
example: Bureaux d'études techniques, cabinets d'ingénieurs-conseils
et sociétés de conseils
numero_idcc:
type: number
description: Numéro IDCC
example: 1486
active:
type: boolean
description: Détermine si la convention est toujours
active
example: true
etat:
type: string
enum:
- vigueur
- vigueur_etendue
description: État de la convention. Si celle-ci est
en vigueur elle est seulement obligatoire pour les
signataires. Si celle-ci est en vigueur étendue, elle
est obligatoire pour tous les employeurs de la branche.
example: vigueur_etendue
synonymes:
type: array
description: Liste de synonymes connus de la convention
items:
type: string
example:
- syntec
url:
type: string
description: Lien vers le texte en vigueur de la convention
collective sur Legifrance
example: https://www.legifrance.gouv.fr/affichIDCC.do?idConvention=KALICONT000005635173
date_publication:
type: string
description: Date de la dernière mise à jour de la convention
example: '1988-01-01'
required:
- type
- titre
- titre_court
- numero_idcc
- active
- etat
- synonymes
- url
- date_publication
links:
type: object
meta:
type: object
properties:
internal_id:
type: string
description: Identifiant interne (DILA) de la convention
example: KALICONT000005635173
required:
- internal_id
additionalProperties: false
meta:
type: object
links:
type: object
required:
- data
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fabrique_numerique_ministeres_sociaux_conventions_collectives, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fabrique_numerique_ministeres_sociaux/conventions_collectives#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fabrique_numerique_ministeres_sociaux_conventions_collectives, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fabrique_numerique_ministeres_sociaux/conventions_collectives#erreurs.
content:
application/json:
examples:
entite_non_trouvee_14003:
value:
errors:
- code: '14003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: Fabrique numérique des Ministères Sociaux
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fabrique_numerique_ministeres_sociaux_conventions_collectives, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fabrique_numerique_ministeres_sociaux/conventions_collectives#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_14999:
value:
errors:
- code: '14999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: Fabrique numérique des Ministères Sociaux
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fabrique_numerique_ministeres_sociaux_conventions_collectives, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fabrique_numerique_ministeres_sociaux/conventions_collectives#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '14002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: Fabrique numérique des Ministères Sociaux
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fabrique_numerique_ministeres_sociaux_conventions_collectives, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fabrique_numerique_ministeres_sociaux/conventions_collectives#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fabrique_numerique_ministeres_sociaux_conventions_collectives, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fabrique_numerique_ministeres_sociaux/conventions_collectives#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '14020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: Fabrique numérique des Ministères Sociaux
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fabrique_numerique_ministeres_sociaux_conventions_collectives, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fabrique_numerique_ministeres_sociaux/conventions_collectives#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/fabrique_numerique_ministeres_sociaux/etablissements/13002526500013/conventions_collectives?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/fntp/unites_legales/{siren}/carte_professionnelle_travaux_publics":
get:
summary: Carte professionnelle travaux publics
tags:
- Attestations sociales et fiscales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren
in: path
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Carte professionnelle d'entrepreneur de travaux publics, délivrée
à une entreprise en règle de ses obligations sociales, administratives et
juridiques.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fntp_carte_professionnelle_travaux_publics, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fntp/carte_professionnelle_travaux_public#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fntp_carte_professionnelle_travaux_publics, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fntp/carte_professionnelle_travaux_public#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fntp_carte_professionnelle_travaux_publics, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fntp/carte_professionnelle_travaux_public#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Carte professionnelle trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_fntp_carte_professionnelle_travaux_publics
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
document_url:
type: string
title: Lien vers la carte professionnelle
description: Ce document est automatiquement supprimé au bout
de 3 mois.
example: https://raw.githubusercontent.com/datagouv/apistration/refs/heads/develop/mocks/payloads/api_entreprise_v3_fntp_carte_professionnelle_travaux_publics/carte_professionnelle_tp_test.pdf
expires_in:
type: integer
example: 7889238
description: 'Nombre de secondes avant l''expiration de l''url
associée à l''attribut document_url : cette durée correspond
généralement à 24h.'
required:
- document_url
- expires_in
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fntp_carte_professionnelle_travaux_publics, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fntp/carte_professionnelle_travaux_public#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fntp_carte_professionnelle_travaux_publics, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fntp/carte_professionnelle_travaux_public#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_12999:
value:
errors:
- code: '12999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: FNTP
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fntp_carte_professionnelle_travaux_publics, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fntp/carte_professionnelle_travaux_public#erreurs.
content:
application/json:
examples:
entite_non_trouvee_12003:
value:
errors:
- code: '12003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: FNTP
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fntp_carte_professionnelle_travaux_publics, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fntp/carte_professionnelle_travaux_public#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '12002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: FNTP
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fntp_carte_professionnelle_travaux_publics, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fntp/carte_professionnelle_travaux_public#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fntp_carte_professionnelle_travaux_publics, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fntp/carte_professionnelle_travaux_public#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '12020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: FNTP
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_fntp_carte_professionnelle_travaux_publics, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/fntp/carte_professionnelle_travaux_public#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/fntp/unites_legales/130025265/carte_professionnelle_travaux_publics?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/gip_mds/unites_legales/{siren}/effectifs_annuels/{year}":
get:
summary: Effectifs annuels d'une unité légale
tags:
- Informations générales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: year
in: path
description: Année de référence des effectifs.
schema:
type: string
example: '2020'
required: true
- name: nature_effectif
in: query
description: "Indique la nature de l'effectif transmis. Si ce paramètre n'est
pas complété en appel, l'effectif moyen annuel (EMA) sera renvoyé par défaut.
L'API permet d'accéder à 4 natures d'effectif : \n - Effectif moyen annuel
(EMA), c'est-à-dire le nombre de salariés en contrat 'actif' hors exclusions.
Ces exclusions sont décrites dans la documentation. \n - Effectif BOETH
annuel (EMA BOTEH), c'est-à-dire le nombre de salariés de l'entreprise (salariés,
stagiaires et PMSMP) qui sont bénéficiaires de l'obligation d’emploi des
travailleurs handicapés (BOETH). Ce statut recouvre plusieurs situations
décrites dans la documentation. \n - Effectif ECAP annuel (EMA ECAP), c'est-à-dire
le nombre de salariés de l'entreprise occupant un emploi qui, de par ses
exigences en matière d'aptitude, rend difficile un recrutement de travailleurs
handicapés. Cet effectif « emplois exigeant des conditions d’aptitudes particulières
» (ECAP) est utilisé par l'URSSAF pour calculer une réduction de la contribution
employeur si l'entreprise n'emploie pas assez de travailleurs handicapés.
\n - Effectif d'assujettissement OETH annuel (EMA OETH), c'est-à-dire le
nombre de salariés en contrat 'actif', hors exclusions, différentes de celles
de l'effectif moyen mensuel (EMM). Cet effectif est utilisé par l'URSSAF
pour calculer le niveau d'obligation d'emploi de travailleurs handicapés
de l'entreprise."
schema:
type: string
default: moyen
enum:
- moyen
- boeth
- ecap
- assujettissement_oeth
security:
- jwt_bearer_token: []
description: Effectifs annuels des régimes général et agricole d'une unité légale,
issus de l'Urssaf et de la MSA depuis le répertoire commun des déclarants
opéré par le GIP-MDS. Inclut l'effectif moyen et les effectifs liés à l'obligation
d'emploi des travailleurs handicapés.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_annuels_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_annuels_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_annuels_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Effectifs annuels trouvés
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_gip_mds_effectifs_annuels_entreprise
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siren:
title: Siren de l'unité légale
type: string
example: '130025265'
annee:
title: Année de référence
description: Année des effectifs renvoyés, c'est-à-dire l'année
mentionnée en appel. Les effectifs annuels sont disponibles
seulement une fois l'année écoulée (fin janvier N+1). Pour
avoir le dernier effectif disponible, il est donc recommandé
d'appeler l'année N-1.
type: string
example: '2017'
effectifs_annuel:
title: Effectif annuel de l'établissement
type: array
items:
type: object
additionalProperties: false
required:
- regime
- nature
- value
- date_derniere_mise_a_jour
properties:
regime:
title: Type de régime
type: string
example: regime_general
enum:
- regime_general
- regime_agricole
value:
title: Valeur de l'effectif
description: Valeur de l'effectif annuel. Cette valeur
est à null s'il n'y a pas d'effectif dans le régime.
type: number
example: 12.34
nullable: true
nature:
title: Nature de l'effectif
description: "Indique la nature de l'effectif transmis.
Quatre natures d'effectif sont renvoyées par l'API
: \n - Effectif moyen annuel (EMA), c'est-à-dire le
nombre de salariés en contrat 'actif' hors exclusions.
Ces exclusions sont décrites dans la documentation.
\n - Effectif BOETH annuel (EMA BOTEH), c'est-à-dire
le nombre de salariés de l'entreprise (salariés, stagiaires
et PMSMP) qui sont bénéficiaires de l'obligation d’emploi
des travailleurs handicapés (BOETH). Ce statut recouvre
plusieurs situations décrites dans la documentation.
\n - Effectif ECAP annuel (EMA ECAP), c'est-à-dire
le nombre de salariés de l'entreprise occupant un
emploi qui, de par ses exigences en matière d'aptitude,
rend difficile un recrutement de travailleurs handicapés.
Cet effectif « emplois exigeant des conditions d’aptitudes
particulières » (ECAP) est utilisé par l'URSSAF pour
calculer une réduction de la contribution employeur
si l'entreprise n'emploie pas assez de travailleurs
handicapés. \n - Effectif d'assujettissement OETH
annuel (EMA OETH), c'est-à-dire le nombre de salariés
en contrat 'actif', hors exclusions, différentes de
celles de l'effectif moyen mensuel (EMM). Cet effectif
est utilisé par l'URSSAF pour calculer le niveau d'obligation
d'emploi de travailleurs handicapés de l'entreprise."
type: string
enum:
- effectif_moyen_annuel
- effectif_boeth_annuel
- effectif_ecap_annuel
- effectif_assujettissement_oeth_annuel
date_derniere_mise_a_jour:
title: Date de la dernière mise à jour de la donnée
type: string
example: '2018-01-01'
nullable: true
required:
- siren
- annee
- effectifs_annuel
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_annuels_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Effectifs non trouvés
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_annuels_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale#erreurs.
content:
application/json:
examples:
entite_non_trouvee_31003:
value:
errors:
- code: '31003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: GIP-MDS
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_annuels_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_31999:
value:
errors:
- code: '31999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: GIP-MDS
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_annuels_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '31002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: GIP-MDS
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_annuels_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_annuels_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '31020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: GIP-MDS
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_annuels_entreprise, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/gip_mds/unites_legales/130025265/effectifs_annuels/2019?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/gip_mds/etablissements/{siret}/effectifs_mensuels/{month}/annee/{year}":
get:
summary: Effectifs mensuels d'un établissement
tags:
- Informations générales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: year
in: path
description: Année de référence des effectifs.
schema:
type: string
example: '2020'
required: true
- name: month
in: path
description: 'Mois de référence des effectifs (format: 01 à 12).'
schema:
type: string
example: '01'
enum:
- '01'
- '02'
- '03'
- '04'
- '05'
- '06'
- '07'
- '08'
- '09'
- '10'
- '11'
- '12'
required: true
- name: profondeur
in: query
description: Nombre de mois à renvoyer, en amont de la date choisie. Ce paramètre
permet de renvoyer les effectifs de plusieurs mois en même temps, antérieurs
à la date choisie, et au maximum 13 mois. Par exemple si la date indiquée
est 03/2025 et ce paramètre de profondeur est 3. Les effectifs de janvier,
février et mars 2025 seront renvoyés.
schema:
type: integer
default: 0
minimum: 0
maximum: 12
- name: nature_effectif
in: query
description: "Indique la nature de l'effectif transmis. Si ce paramètre n'est
pas complété en appel, l'effectif moyen mensuel (EMM) sera renvoyé par défaut.
L'API permet d'accéder à 4 natures d'effectif : \n - Effectif moyen mensuel
(EMM), c'est-à-dire le nombre de salariés en contrat 'actif' hors exclusions.
Ces exclusions sont décrites dans la documentation. \n - Effectif BOETH
mensuel (EMM BOTEH), c'est-à-dire le nombre de salariés de l'entreprise
(salariés, stagiaires et PMSMP) qui sont bénéficiaires de l'obligation d’emploi
des travailleurs handicapés (BOETH). Ce statut recouvre plusieurs situations
décrites dans la documentation. \n - Effectif ECAP mensuel (EMM ECAP), c'est-à-dire
le nombre de salariés de l'entreprise occupant un emploi qui, de par ses
exigences en matière d'aptitude, rend difficile un recrutement de travailleurs
handicapés. Cet effectif « emplois exigeant des conditions d’aptitudes particulières
» (ECAP) est utilisé par l'URSSAF pour calculer une réduction de la contribution
employeur si l'entreprise n'emploie pas assez de travailleurs handicapés.
\n - Effectif d'assujettissement OETH mensuel (EMM OETH), c'est-à-dire le
nombre de salariés en contrat 'actif', hors exclusions, différentes de celles
de l'effectif moyen mensuel (EMM). Cet effectif est utilisé par l'URSSAF
pour calculer le niveau d'obligation d'emploi de travailleurs handicapés
de l'entreprise."
schema:
type: string
default: moyen
enum:
- moyen
- boeth
- ecap
- assujettissement_oeth
security:
- jwt_bearer_token: []
description: Effectifs mensuels des régimes général et agricole d'un établissement,
issus de l'Urssaf et de la MSA depuis le répertoire commun des déclarants
opéré par le GIP-MDS. Inclut l'effectif moyen et les effectifs liés à l'obligation
d'emploi travailleurs handicapés.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_mensuels_etablissement, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_mensuels_etablissement, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_mensuels_etablissement, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Effectifs mensuels trouvés
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_gip_mds_effectifs_mensuels_etablissement
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siret:
title: Siret de l'établissement
type: string
example: '13002526500013'
effectifs_mensuels:
title: Effectif mensuels de l'établissement
type: array
items:
type: object
additionalProperties: false
required:
- regime
- annee
- nature
- mois
- value
- date_derniere_mise_a_jour
properties:
regime:
title: Type de régime
type: string
example: regime_general
enum:
- regime_general
- regime_agricole
value:
title: Valeur de l'effectif
description: Valeur de l'effectif mensuel. Cette valeur
est à null s'il n'y a pas d'effectif dans le régime.
type: number
example: 12.34
nullable: true
nature:
title: Nature de l'effectif
description: "Indique la nature de l'effectif transmis.
Quatre natures d'effectif sont renvoyées par l'API
: \n - Effectif moyen mensuel (EMM), c'est-à-dire
le nombre de salariés en contrat 'actif' hors exclusions.
Ces exclusions sont décrites dans la documentation.
\n - Effectif BOETH mensuel (EMM BOTEH), c'est-à-dire
le nombre de salariés de l'entreprise (salariés, stagiaires
et PMSMP) qui sont bénéficiaires de l'obligation d’emploi
des travailleurs handicapés (BOETH). Ce statut recouvre
plusieurs situations décrites dans la documentation.
\n - Effectif ECAP mensuel (EMM ECAP), c'est-à-dire
le nombre de salariés de l'entreprise occupant un
emploi qui, de par ses exigences en matière d'aptitude,
rend difficile un recrutement de travailleurs handicapés.
Cet effectif « emplois exigeant des conditions d’aptitudes
particulières » (ECAP) est utilisé par l'URSSAF pour
calculer une réduction de la contribution employeur
si l'entreprise n'emploie pas assez de travailleurs
handicapés. \n - Effectif d'assujettissement OETH
mensuel (EMM OETH), c'est-à-dire le nombre de salariés
en contrat 'actif', hors exclusions, différentes de
celles de l'effectif moyen mensuel (EMM). Cet effectif
est utilisé par l'URSSAF pour calculer le niveau d'obligation
d'emploi de travailleurs handicapés de l'entreprise."
type: string
enum:
- effectif_moyen_mensuel
- effectif_boeth_mensuel
- effectif_ecap_mensuel
- effectif_assujettissement_oeth_mensuel
annee:
title: Année de l'effectif
type: string
maxLength: 4
minLength: 4
example: '2021'
mois:
title: Mois de l'effectif
type: string
example: '01'
maxLength: 2
minLength: 2
enum:
- '01'
- '02'
- '03'
- '04'
- '05'
- '06'
- '07'
- '08'
- '09'
- '10'
- '11'
- '12'
date_derniere_mise_a_jour:
title: Date de la dernière mise à jour de la donnée
type: string
example: '2018-01-01'
nullable: true
required:
- siret
- effectifs_mensuels
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_mensuels_etablissement, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Effectifs non trouvés
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_mensuels_etablissement, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement#erreurs.
content:
application/json:
examples:
entite_non_trouvee_31003:
value:
errors:
- code: '31003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: GIP-MDS
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_mensuels_etablissement, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_31999:
value:
errors:
- code: '31999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: GIP-MDS
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_mensuels_etablissement, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '31002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: GIP-MDS
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_mensuels_etablissement, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_mensuels_etablissement, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '31020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: GIP-MDS
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_gip_mds_effectifs_mensuels_etablissement, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/gip_mds/etablissements/13002526500013/effectifs_mensuels/11/annee/2019?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/infogreffe/rcs/unites_legales/{siren}/extrait_kbis":
get:
summary: Extrait RCS
tags:
- Informations générales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Extrait d'une partie des données du registre du commerce et des
sociétés (RCS), informations générales des mandataires sociaux, ainsi que
les commentaires laissés par les greffiers.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_extraits_rcs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/rcs/extrait#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_extraits_rcs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/rcs/extrait#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_extraits_rcs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/rcs/extrait#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée (personne physique)
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_infogreffe_extraits_rcs
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siren:
title: Siren de l'unité légale
type: string
example: '130025265'
date_radiation:
title: Date de radiation de l'entreprise
description: Il s'agit de la date de radiation au registre
du commerce et des sociétés.
type: string
example: '2019-01-01'
nullable: true
date_extrait:
type: string
title: Date de l'extrait
description: Il s'agit de la date d'émission de l'extrait
RCS.
example: '2022-07-11'
nullable: true
date_immatriculation:
type: string
title: Date d'immatriculation au RCS
description: Il s'agit du jour d'immatriculation de l'entreprise
au RCS. À compter de cette date, les sociétés jouissent
de la personnalité morale. Cette date d'immatriculation
n'est pas la même que celle délivrée par l'Insee. Elle ne
correspond pas non plus à la date du début d'activité.
example: '1998-07-12'
nullable: true
mandataires_sociaux:
title: Mandataires sociaux
description: Liste des mandataires sociaux d'une société inscrite
au RCS. Certaines informations telles que le jour de naissance,
le lieu ou la nationalité des personnes physiques ne figurent
pas dans cette API. Pour plus d'exhaustivité, appeler l'[API
Mandataires sociaux - Infogreffe](https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux).
type: array
items:
required:
- fonction
type: object
additionalProperties: false
properties:
numero_identification:
title: Numéro d'identification
description: Ce champ est uniquement disponible pour
une personne morale.
type: string
example: '784824153'
nullable: true
type:
title: Type de mandataire social
description: Ce champ permet de faire la distinction
entre les personnes physiques et morales.
type: string
example: personne_morale
enum:
- personne_morale
- personne_physique
fonction:
title: Fonction au sein de l'entreprise
description: Ce champ décrit la fonction du mandataire
social au sein de l'entreprise. Cette information
est disponible pour les personnes morales et physiques.
type: string
example: COMMISSAIRE AUX COMPTES SUPPLEANT
nullable: true
nom:
title: Nom
description: Nom du mandataire social. Ce champ est
disponible uniquement pour une personne physique.
type: string
example: Henri
nullable: true
prenom:
title: Prénom
description: Prénom du mandataire social. Ce champ est
disponible uniquement pour une personne physique.
type: string
example: Martin
nullable: true
date_naissance:
title: Mois et année de naissance
description: 'Mois et année de naissance du mandataire
social. Ce champ est disponible uniquement pour une
personne physique. Vous avez besoin d''une donnée
plus précise ? L''[API Mandataires sociaux d''Infogreffe](https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux)
permet d''accéder à des données protégées : le jour
de naissance, le lieu de naissance et la nationalité
de la personne physique.'
type: string
example: 1965-01
nullable: true
raison_sociale:
title: Raison sociale
description: Raison sociale de la personne morale mandataire
social. Ce champ est disponible uniquement pour une
personne morale.
type: string
example: BCRH & ASSOCIES - SOCIETE A RESPONSABILITE
LIMITEE A ASSOCIE UNIQUE
nullable: true
observations:
type: array
title: Ensemble des observations du greffier
description: Ce champ regroupe tous les messages laissés par
le greffier et inscrits dans les observations.
items:
type: object
additionalProperties: false
properties:
numero:
type: string
title: Numéro de l'observation
example: '123456'
libelle:
type: string
title: Libellé de l'observation
example: LA SOCIETE NE CONSERVE AUCUNE ACTIVITE A SON
ANCIEN SIEGE
date:
type: string
title: Date de l'observation
example: '2000-01-01'
nom_commercial:
type: string
title: Nom commercial
example: DECATHLON
nullable: true
etablissement_principal:
title: Informations de l'établissement principal
type: object
additionalProperties: false
properties:
activite:
type: string
title: Activité de l'établissement principal
nullable: true
origine_fonds:
type: string
title: Origine des fonds
description: Origine des fonds de l'entreprise
example: CREATION
nullable: true
mode_exploitation:
type: string
title: Mode d'exploitation
description: Mode d'exploitation de l'entreprise
example: EXPLOITATION DIRECTE
nullable: true
code_ape:
type: string
title: Code APE
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. \n \n À noter
qu'une entreprise n'ayant pas encore de code APE peut
se voir affecter la valeur '00.00Z' de manière provisoire.
\n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
example: 6420Z
required:
- activite
- origine_fonds
- mode_exploitation
- code_ape
capital:
type: object
additionalProperties: false
title: Capital de l'entreprise
properties:
montant:
type: number
title: Montant du capital
description: Montant du capital de création de l'entreprise.
example: 50123.6
nullable: true
devise:
type: string
title: Devise
description: Devise du capital de création de l'entreprise.
example: EUROS
nullable: true
code_devise:
type: string
title: Code devise
description: Code de la devise du capital de création
de l'entreprise.
example: EUR
nullable: true
required:
- montant
- devise
- code_devise
greffe:
type: object
additionalProperties: false
title: Greffe
description: Informations sur le greffe.
properties:
valeur:
type: string
title: Libellé du greffe
description: Nom du greffe en charge de l'entreprise.
example: COLMAR
code:
type: string
title: Code greffe
description: Code du greffe en charge de l'entreprise.
example: '6851'
required:
- valeur
- code
personne_physique:
type: object
additionalProperties: false
title: Personne physique
description: Informations sur l'entreprise s'il s'agit d'une
personne physique. Les champs sont vides si l'entreprise
est une personne morale.
properties:
adresse:
type: object
additionalProperties: false
title: Adresse
description: L'adresse transmise par Infogreffe est renvoyée
sous différents formats, utilisant parfois le champ
«nom postal», parfois les champs «ligne 1» et «ligne
2», ou encore au travers des champs «numéro de la voie»
+ «type de la voie» + «nom de la voie». Pour obtenir
l'adresse du siège ou l'établissement principal, nous
vous recommandons fortement de faire appel à l'API Adresse
établissement - Insee.
properties:
nom_postal:
type: string
title: Nom postal
example: 22 RUE DE LA PAIX
nullable: true
numero:
type: string
title: Numéro de voie
example: '22'
nullable: true
type:
type: string
title: Type
example: RUE
nullable: true
voie:
type: string
title: Nom de la voie
example: DE LA PAIX
nullable: true
ligne_1:
type: string
title: Ligne 1 adresse
nullable: true
ligne_2:
type: string
title: Ligne 2 adresse
nullable: true
localite:
type: string
title: Localité
nullable: true
code_postal:
type: string
title: Code postal
example: 75016"
nullable: true
bureau_distributeur:
type: string
title: Bureau distributeur
nullable: true
pays:
type: string
title: Pays
example: FRANCE
nullable: true
required:
- nom_postal
- numero
- type
- voie
- ligne_1
- ligne_2
- localite
- code_postal
- bureau_distributeur
- pays
nationalite:
type: object
additionalProperties: false
title: Nationalité
description: Nationalité de la personne physique.
properties:
valeur:
type: string
title: Nationalité
description: Nationalité de la personne physique.
example: FRANÇAISE
nullable: true
code:
type: string
title: Code Pays
description: Code pays de la nationalité de la personne
physique.
example: FR
nullable: true
required:
- valeur
- code
nom:
type: string
title: Nom
description: Nom de la personne physique.
example: MARTIN
nullable: true
prenom:
type: string
title: Prénom
description: Prénom de la personne physique.
example: JEAN-MARIE
nullable: true
naissance:
type: object
additionalProperties: false
title: Naissance
description: Informations de naissance de la personne
physique (lieu, date, pays)
properties:
pays:
type: object
additionalProperties: false
title: Pays de naissance
description: Pays de naissance de la personne physique
properties:
valeur:
type: string
title: Libellé du pays de naissance
description: Nom du pays de naissance de la personne
physique
example: FRANCE
nullable: true
code:
type: string
title: Code du pays de naissance
description: Code du pays de naissance de la personne
physique
example: FR
nullable: true
required:
- valeur
- code
date:
type: string
title: Date de naissance
description: Date de naissance de la personne physique
example: '1972-01-30'
nullable: true
lieu:
type: string
title: Lieu de naissance
description: Lieu de naissance de la personne physique
example: MONTPELLIER
nullable: true
required:
- pays
- date
- lieu
required:
- adresse
- nationalite
- nom
- prenom
- naissance
personne_morale:
type: object
additionalProperties: false
title: Personne morale
description: Informations sur l'entreprise s'il s'agit d'une
personne morale. Les champs sont vides si l'entreprise est
une personne physique.
properties:
forme_juridique:
type: object
additionalProperties: false
title: Forme juridique
description: Forme juridique de la personne morale
properties:
valeur:
type: string
title: Libellé de la forme juridique
example: SOCIETE PAR ACTIONS SIMPLIFIEES
nullable: true
code:
type: string
title: Code forme juridique
description: Code représentant la forme juridique
de l'entreprise. Attention, la nomenclature est
différente de celle de l'INSEE.
example: SASh
nullable: true
required:
- valeur
- code
denomination:
type: string
title: Dénomination ou raison sociale de la personne morale
example: 2X INVEST
nullable: true
date_cloture_exercice_comptable:
type: string
title: Date de clôture de l'exercice social
description: Mois et jour de l'année où l'exercice comptable
de l'entreprise est clôturé.
example: 02-24
nullable: true
date_fin_de_vie:
type: string
title: Durée de la personne morale
description: Date à laquelle l'entreprise cesse d'exister,
sauf potentiel renouvellement. Correspond souvent à
la date de création + 100 ans.
example: '2075-05-18'
nullable: true
required:
- forme_juridique
- denomination
- date_cloture_exercice_comptable
- date_fin_de_vie
required:
- siren
- date_radiation
- date_extrait
- date_immatriculation
- mandataires_sociaux
- observations
- nom_commercial
- etablissement_principal
- capital
- greffe
- personne_physique
- personne_morale
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_extraits_rcs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/rcs/extrait#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_extraits_rcs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/rcs/extrait#erreurs.
content:
application/json:
examples:
entite_non_trouvee_02003:
value:
errors:
- code: '02003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: Infogreffe
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_extraits_rcs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/rcs/extrait#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_02999:
value:
errors:
- code: '02999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: Infogreffe
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_extraits_rcs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/rcs/extrait#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '02002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: Infogreffe
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_extraits_rcs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/rcs/extrait#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_extraits_rcs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/rcs/extrait#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '02020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: Infogreffe
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_extraits_rcs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/rcs/extrait#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/infogreffe/rcs/unites_legales/130025265/extrait_kbis?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/infogreffe/rcs/unites_legales/{siren}/mandataires_sociaux":
get:
summary: Mandataires sociaux
tags:
- Informations générales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Liste des mandataires sociaux d'une société inscrite au registre
du commerce et des sociétés (RCS), délivrée par Infogreffe.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_mandataires_sociaux, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_mandataires_sociaux, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_mandataires_sociaux, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entité trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_infogreffe_mandataires_sociaux
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
data:
type: object
properties:
numero_identification:
title: Numéro d'identification
description: Ce champ est uniquement disponible pour
une personne morale.
type: string
example: '784824153'
type:
title: Type de mandataire social
description: Ce champ permet de faire la distinction
entre les personnes physiques et morales.
type: string
example: personne_morale
enum:
- personne_morale
- personne_physique
fonction:
title: Fonction au sein de l'entreprise
description: Ce champ décrit la fonction du mandataire
social au sein de l'entreprise. Cette information
est disponible pour les personnes morales et physiques.
type: string
example: COMMISSAIRE AUX COMPTES SUPPLEANT
nullable: true
nom:
title: Nom
description: Nom du mandataire social. Ce champ est
disponible uniquement pour une personne physique.
type: string
example: Henri
nullable: true
prenom:
title: Prénom
description: Prénom du mandataire social. Ce champ est
disponible uniquement pour une personne physique.
type: string
example: Martin
nullable: true
date_naissance:
title: Date de naissance
description: Date de naissance du mandataire social.
Ce champ est disponible uniquement pour une personne
physique.
type: string
example: '1965-01-27'
nullable: true
date_naissance_timestamp:
title: Date de naissance (timestamp)
description: Date de naissance délivrée au format timestamp.
Ce champ est disponible uniquement pour une personne
physique.
type: integer
example: -155523600
nullable: true
lieu_naissance:
title: Lieu de naissance
description: Lieu de naissance du mandataire social.
Ce champ est disponible uniquement pour une personne
physique.
type: string
example: ROUBAIX
nullable: true
pays_naissance:
title: Pays de naissance
description: Pays de naissance du mandataire social.
Ce champ est disponible uniquement pour une personne
physique.
type: string
example: FRANCE
nullable: true
code_pays_naissance:
title: Code pays ISO 3166 Alpha 2 du pays de naissance
description: Code à deux lettres indiquant le pays de
naissance du mandataire social, suivant la norme ISO
3166 Alpha 2. Ce champ est disponible uniquement pour
une personne physique.
type: string
example: FR
nullable: true
nationalite:
title: Nationalité de la personne physique
description: Nationalité du mandataire social. Ce champ
est disponible uniquement pour une personne physique.
type: string
example: FRANCAISE
nullable: true
code_nationalite:
title: Code pays ISO 3166 Alpha 2
description: Code à deux lettres indiquant le pays de
nationalité du mandataire social, suivant la norme
ISO 3166 Alpha 2. Ce champ est disponible uniquement
pour une personne physique.
type: string
example: FR
nullable: true
raison_sociale:
title: Raison sociale
description: Raison sociale de la personne morale mandataire
social. Ce champ est disponible uniquement pour une
personne morale.
type: string
example: BCRH & ASSOCIES - SOCIETE A RESPONSABILITE
LIMITEE A ASSOCIE UNIQUE
nullable: true
code_greffe:
title: Code du greffe de l'entreprise
description: 'Code du greffe auquel la personne morale
mandataire social est rattachée. Ce champ est disponible
uniquement pour une personne morale. Tous les codes
greffe sont disponibles ici : https://opendata.datainfogreffe.fr/explore/dataset/liste-des-greffes/table/'
type: string
example: '9201'
nullable: true
libelle_greffe:
title: Libellé du greffe de l'entreprise
description: 'Nom du greffe auquel la personne morale
mandataire social est rattachée. Ce champ est disponible
uniquement pour une personne morale. Tous les libellés
sont disponibles ici : https://opendata.datainfogreffe.fr/explore/dataset/liste-des-greffes/table/'
type: string
example: NANTERRE
nullable: true
required:
- fonction
links:
type: object
meta:
type: object
meta:
type: object
properties:
personnes_physiques_count:
title: Nombre de personnes physiques
description: Nombre de personnes physiques parmi les mandataires
sociaux.
type: integer
example: 10
personnes_morales_count:
title: Nombre de personnes morales
description: Nombre de personnes morales parmi les mandataires
sociaux.
type: integer
example: 2
count:
title: Nombre total de mandataires sociaux
description: Somme des personnes morales et physiques.
type: integer
example: 12
required:
- personnes_physiques_count
- personnes_morales_count
- count
additionalProperties: false
links:
type: object
required:
- data
- meta
example:
data:
- type: personne_physique
fonction: PRESIDENT
nom: GAUQUELIN
prenom: ARNAUD
date_naissance: '1969-08-24'
date_naissance_timestamp: -11235600
lieu_naissance: FLERS
pays_naissance: FRANCE
code_pays_naissance: FR
nationalite: FRANCAISE
code_nationalite: FR
- numero_identification: '784824153'
type: personne_morale
fonction: COMMISSAIRE AUX COMPTES TITULAIRE
raison_sociale: MAZARS - SOCIETE ANONYME A DIRECTOIRE ET CONSEIL
DE SURVEILLANCE
code_greffe: '9201'
libelle_greffe: NANTERRE
meta:
personnes_physiques_count: 1
personnes_morales_count: 1
count: 2
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_mandataires_sociaux, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Entreprise non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_mandataires_sociaux, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux#erreurs.
content:
application/json:
examples:
entite_non_trouvee_02003:
value:
errors:
- code: '02003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: Infogreffe
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_mandataires_sociaux, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_02999:
value:
errors:
- code: '02999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: Infogreffe
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_mandataires_sociaux, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '02002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: Infogreffe
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_mandataires_sociaux, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_mandataires_sociaux, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '02020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: Infogreffe
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_infogreffe_mandataires_sociaux, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/infogreffe/mandataires_sociaux#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/infogreffe/rcs/unites_legales/130025265/mandataires_sociaux?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/inpi/rne/unites_legales/open_data/{siren}/actes_bilans":
get:
summary: Actes et bilans
tags:
- Informations générales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren
in: path
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Liste des actes et bilans d'une unité légale inscrite au répertoire
national des entreprises (RNE). Seuls les actes et bilans publiques sont distribués.
L'INPI peut potentiellement posséder des actes et bilans "partiellement confidentiels".
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_actes_bilans, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/actes_bilans#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_actes_bilans, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/actes_bilans#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_actes_bilans, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/actes_bilans#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_inpi_rne_actes_bilans
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
actes:
title: Liste des documents contenant les actes de l'unité
légale
description: |
Ce tableau liste les documents, classés par
date de mise à jour, et à défaut date de dépôt du document. Un document
peut contenir un ou plusieurs actes dont le type est décrit
dans la métadonnée.
type: array
items:
type: object
properties:
id:
title: Identifiant de l'acte
type: string
example: 65419234a1f7d1f2ba09bd8c
nom_document:
title: Nom du document à l'Inpi
description: Nom du document déposé.
type: string
example: X9wvz5eKvKQv_C0022A1001L257081D20230902H180411TPIJTES003PDBOR
date_depot:
title: Date de dépôt du document
type: string
format: date
example: '2023-08-08'
date_mise_a_jour:
title: Date de mise à jour du document
type: string
format: date
example: '2023-11-01'
types_actes:
title: Types d'actes contenus dans le document
type: array
description: |
Liste les types d'actes inclus dans le document retourné.
Pour les documents qui ont été établis avant la création du répertoire des entreprises (RNE)
et qui étaient autrefois transmis par les greffes au registre national du commerce et des sociétés (RNCS),
le document est souvent constitué de plusieurs actes distincts (exemple: le même document peut contenir
une modification de l'adresse du siège social
et une modification du capital social). Les actes qui sont maintenant déposés au guichet unique ne sont
jamais regroupés dans un même document.
nullable: true
items:
type: object
properties:
type_acte:
title: Type d'acte
description: |
Intitulé décrivant le type de l'acte.
Les intitulés les plus fréquents sont : Acte, Certificat, Procès-verbal,
Statuts mis à jour, Extrait de procès-verbal, etc.
type: string
example: Procès-verbal
type_decision:
title: Type de décision
description: |
Intitulé décrivant le type de décision prise par l'acte.
Les intitulés sont par exemple : Décision d'augmentation, Modification(s) statutaire(s),
Augmentation du capital social, Fin de mission de commissaire aux comptes titulaire,
Nomination(s) d'administrateur(s), etc.
type: string
example: Augmentation du capital social
nullable: true
url:
title: URL du document
type: string
example: https://entreprise.api.gouv.fr/proxy/inpi/download/%2FV+svyVVJGVCJroamyqjOrECaXHorkxJ39vZH1IMHz4N+6gvit9zgoQ=--rJ1ss+Brc7oVhloH--huyvWA83YgMFqOnjyKDmXQ==
bilans:
title: Liste des bilans de l'unité légale
description: "Ce tableau liste les documents, classés par
date de mise à jour, et à défaut date de dépôt du document.
Les comptes annuels sont déposés en très grande majorité
directement au Guichet Unique de l'Inpi. Environ 30% (fin
2024) des dépôts de comptes se font encore auprès des greffes,
ces anciennes voies de transmission ont pour objectif d'être
fermées. \n"
type: array
items:
type: object
properties:
id:
title: Identifiant du bilan
type: string
example: 65419234a1f7d1f2ba09bd8c
nom_document:
title: Nom du bilan
description: Nom du bilan à l'Inpi.
type: string
example: X9wvz5eKvKQv_C0022A1001L257081D20230902H180411TPIJTES003PDBOR
date_depot:
title: Date de dépôt du bilan
description: Ce champ indique la date de dépôt du bilan.
Si le bilan a été déposé au guichet unique, la date
de dépôt correspond à la date de où le paiement a
été effectué. Si le bilan provient directement d'Infogreffe
(cas des bilans avant 2023 et de certains bilans à
compter de cette date), la date de dépôt correspond
à la date de validation par les greffes.
type: string
format: date
example: '2023-08-08'
date_cloture:
title: Date de clôture du bilan
nullable: true
type: string
format: date
example: '2023-08-08'
date_mise_a_jour:
title: Date de mise à jour du bilan
type: string
format: date
example: '2023-11-01'
type:
title: Type de bilan
description: 'Type du bilan déposé.
'
type: string
example: bilan complet
enum:
- bilan complet
- bilan simplifié
- bilan consolidé
- bilan de type banque
- bilan de type assurance
- bilan de type agricole simplifié
url:
title: URL du bilan
description: URL pour télécharger le document bilan
type: string
example: https://entreprise.api.gouv.fr/proxy/inpi/download/%2FV+svyVVJGVCJroamyqjOrECaXHorkxJ39vZH1IMHz4N+6gvit9zgoQ=--rJ1ss+Brc7oVhloH--huyvWA83YgMFqOnjyKDmXQ==
required:
- actes
- bilans
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_actes_bilans, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/actes_bilans#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_actes_bilans, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/actes_bilans#erreurs.
content:
application/json:
examples:
entite_non_trouvee_34003:
value:
errors:
- code: '34003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INPI - RNE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_actes_bilans, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/actes_bilans#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_34999:
value:
errors:
- code: '34999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INPI - RNE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_actes_bilans, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/actes_bilans#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '34002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INPI - RNE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_actes_bilans, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/actes_bilans#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_actes_bilans, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/actes_bilans#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '34020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INPI - RNE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_actes_bilans, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/actes_bilans#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/inpi/rne/unites_legales/open_data/130025265/actes_bilans?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/inpi/rne/unites_legales/{siren}/beneficiaires_effectifs":
get:
summary: Bénéficiaires effectifs
tags:
- Informations générales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Liste des bénéficiaires effectifs d'une unité légale inscrite au
répertoire national des entreprises (RNE).
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_beneficiaires_effectifs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/beneficiaires_effectifs#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_beneficiaires_effectifs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/beneficiaires_effectifs#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_beneficiaires_effectifs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/beneficiaires_effectifs#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Bénéficiaires effectifs trouvés
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). Le cache est valide jusqu'à 3 heures
du matin.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_inpi_rne_beneficiaires_effectifs
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
data:
type: object
properties:
beneficiaire_uuid:
title: UUID du bénéficiaire effectif
type: string
example: 21120ee0-d42b-44f6-a462-d3724cf6aeaf
nom:
title: Nom du bénéficiaire effectif
type: string
example: MARTIN
nom_usage:
title: Nom d'usage du bénéficiaire effectif
type: string
example: DUBOIS
nullable: true
prenoms:
title: Liste des prénoms du bénéficiaire effectif
type: array
example:
- JEAN
- JACQUES
items:
type: string
date_naissance:
type: object
title: Date de naissance du bénéficiaire effectif
additionalProperties: false
properties:
annee:
title: Année de la date de naissance
type: string
example: '1990'
nullable: true
mois:
title: Mois de la date de naissance
type: string
example: '01'
nullable: true
enum:
- '01'
- '02'
- '03'
- '04'
- '05'
- '06'
- '07'
- '08'
- '09'
- '10'
- '11'
- '12'
required:
- annee
- mois
nationalite:
type: string
title: Nationalité du bénéficiaire effectif
example: France
nullable: true
pays_residence:
type: string
title: Pays de résidence du bénéficiaire effectif
example: FRANCE
modalites:
title: Liste des modalités de contrôle du bénéficiaire
effectif
type: object
additionalProperties: false
properties:
detention_de_capital:
title: Détention de capital
description: Une personne physique est considérée
comme bénéficiaire effectif si elle possède directement
ou indirectement plus de 25 % du capital. Dans
ce cas, ce tableau dresse le détail de cette détention
de capital.
type: object
additionalProperties: false
properties:
parts_totale:
title: Total des parts détenues dans l'unité
légale
description: Pourcentage total du capital détenu
et déclaré par le bénéficiaire qui correspond
à la somme des parts directes et indirectes.
Ce total est soit égal à 0%, soit supérieur
ou égal à 25%. En effet, en dessous de ce
ratio, la personne physique ne déclare pas
son capital.
type: number
example: 51.0
parts_directes:
title: Parts directes
type: object
additionalProperties: false
properties:
detention:
title: Indique si le bénéficiaire détient
des parts directes.
description: Détermine si le bénéficiaire
possède du capital direct (parts sociales
ou actions) de l'unité légale. Par opposition
à une détention indirecte du capital,
via une personne morale.
type: boolean
example: true
pleine_propriete:
title: Proportion détenue en pleine propriété
description: 'Pourcentage de parts directes
détenues en pleine propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété : quelles
différences ?'
type: number
example: 42.0
nue_propriete:
title: Proportion détenue en nue-propriété
description: 'Pourcentage de parts directes
détenues en nue-propriété.
Plus d''infos
sur les différents des droits sur un bien
sur le lien suivant: Usufruit,
nue-propriété, pleine propriété : quelles
différences ?'
type: number
example: 9.0
required:
- detention
- pleine_propriete
- nue_propriete
parts_indirectes:
title: Parts indirectes
type: object
additionalProperties: false
properties:
detention:
title: Indique si le bénéficiaire détient
des parts indirectes
description: Détermine si le bénéficiaire
possède du capital (parts sociales ou
actions) de manière indirecte sur l'unité
légale, c'est-à-dire via une personne
morale.
type: boolean
example: false
par_indivision:
title: Via une indivision
description: 'Les parts indirectes peuvent
être détenues par le biais d''une indivision.
Après un décès, le patrimoine du défunt
est en indivision, s’il y a plusieurs
héritiers. Cela signifie que les biens
de la succession appartiennent indistinctement
à tous les héritiers sans que leurs parts
respectives ne soient matériellement individualisées.
Plus d''infos sur le lien suivant: Succession
: qu''est-ce que l''indivision ?'
type: object
additionalProperties: false
properties:
total:
title: Total des parts indirectes en
indivision
description: Pourcentage total de parts
indirectes détenues par le biais d'une
indivision.
type: number
example: 0.0
pleine_propriete:
title: Proportion détenue en pleine
propriété
description: 'Pourcentage de parts indirectes
en indivision détenues en pleine propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
nue_propriete:
title: Proportion détenue en nue-propriété
description: 'Pourcentage de parts indirectes
en indivision détenues en nue-propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
required:
- total
- pleine_propriete
- nue_propriete
via_personnes_morales:
title: Via une ou des personnes morales
description: Les parts indirectes peuvent
être détenues par le biais d'une ou de
plusieurs personnes morales intermédiaires.
Plus d'infos sur les différents mécanismes
de détention du capital dans cette
FAQ.
type: object
additionalProperties: false
properties:
total:
title: Total des parts indirectes via
des personnes morales
description: Pourcentage total de parts
indirectes détenues par le biais d'une
ou de plusieurs personnes morales.
type: number
example: 0.0
pleine_propriete:
title: Proportion détenue en pleine
propriété
description: 'Pourcentage de parts indirectes
via une personne morale détenues en
pleine propriété.
Plus d''infos
sur les différents des droits sur
un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
nue_propriete:
title: Proportion détenue en nue-propriété
description: 'Pourcentage de parts indirectes
via une personne morale détenues en
nue-propriété.
Plus d''infos sur
les différents des droits sur un bien
sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
required:
- total
- pleine_propriete
- nue_propriete
required:
- detention
- par_indivision
- via_personnes_morales
required:
- parts_totale
- parts_directes
- parts_indirectes
vocation_a_devenir_titulaire_de_parts:
title: Vocation par l’effet d’un acte juridique
à devenir titulaire de parts
description: Dans le cas d'un GIE ou GEIE (Groupements
d'intérêt économique), une personne physique est
considérée comme bénéficiaire effectif si elle
a vocation par l’effet d’un acte juridique à devenir
titulaire de plus de 25 % du capital. Dans ce
cas, ce tableau dresse le détail de cette future
détention de capital.
type: object
additionalProperties: false
properties:
parts_directes:
title: Parts directes
type: object
additionalProperties: false
properties:
pleine_propriete:
title: Proportion future détenue en pleine
propriété
description: 'Pourcentage de parts directes
qui ont vocation à être détenues en pleine
propriété.
Plus d''infos sur les différents
des droits sur un bien sur le lien suivant:
Usufruit,
nue-propriété, pleine propriété : quelles
différences ?'
type: number
example: 0.0
nue_propriete:
title: Proportion future détenue en nue-propriété
description: 'Pourcentage de parts directes
qui ont vocation à être détenues en nue-propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété : quelles
différences ?'
type: number
example: 0.0
required:
- pleine_propriete
- nue_propriete
parts_indirectes:
title: Parts indirectes
type: object
additionalProperties: false
properties:
par_indivision:
title: Via une indivision
description: 'Les parts indirectes peuvent
être détenues par le biais d''une indivision.
Après un décès, le patrimoine du défunt
est en indivision, s’il y a plusieurs
héritiers. Cela signifie que les biens
de la succession appartiennent indistinctement
à tous les héritiers sans que leurs parts
respectives ne soient matériellement individualisées.
Plus d''infos sur le lien suivant: Succession
: qu''est-ce que l''indivision ?'
type: object
additionalProperties: false
properties:
total:
title: Total futur des parts indirectes
en indivision
description: Pourcentage total de parts
indirectes qui ont vocation à être
détenues par le biais d'une indivision.
type: number
example: 0.0
pleine_propriete:
title: Proportion future détenue en
pleine propriété
description: 'Pourcentage de parts indirectes
en indivision qui ont vocation à être
détenues en pleine propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
nue_propriete:
title: Proportion future détenue en
nue-propriété
description: 'Pourcentage de parts indirectes
en indivision qui ont vocation à être
détenues en nue-propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
required:
- total
- pleine_propriete
- nue_propriete
via_personnes_morales:
title: Via une ou des personnes morales
description: Les parts indirectes peuvent
être détenues par le biais d'une ou de
plusieurs personnes morales intermédiaires.
Plus d'infos sur les différents mécanismes
de détention du capital dans cette
FAQ.
type: object
additionalProperties: false
properties:
total:
title: Total futur des parts indirectes
via des personnes morales
description: Pourcentage total de parts
indirectes qui ont vocation à être
détenues par le biais d'une ou de
plusieurs personnes morales.
type: number
example: 0.0
pleine_propriete:
title: Proportion future détenue en
pleine propriété
description: 'Pourcentage de parts indirectes
via une personne morale qui ont vocation
à être détenues en pleine propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
nue_propriete:
title: Proportion future détenue en
nue-propriété
description: 'Pourcentage de parts indirectes
via une personne morale qui ont vocation
à être détenues en nue-propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
required:
- total
- pleine_propriete
- nue_propriete
required:
- par_indivision
- via_personnes_morales
required:
- parts_directes
- parts_indirectes
droits_de_vote:
title: Détention de droits de vote
description: Une personne physique est considérée
comme bénéficiaire effectif si elle possède directement
ou indirectement plus de 25 % des droits de vote
de la société. Dans ce cas, ce tableau dresse
le détail de cette détention de droit de vote.
type: object
additionalProperties: false
properties:
total:
title: Total des droits de vote détenus dans
l'unité légale
description: Pourcentage total des droits de
vote détenus et déclarés par le bénéficiaire
qui correspond à la somme des droits de vote
directs et indirects. Ce total est soit égal
à 0%, soit supérieur ou égal à 25%. En effet,
en dessous de ce ratio, la personne physique
ne déclare pas ses droits de vote.
type: number
example: 0.0
directes:
title: Droits de vote directs
type: object
additionalProperties: false
properties:
detention:
title: Indique si le bénéficiaire détient
des droits de vote directs.
description: Détermine si le bénéficiaire
possède des droits de vote directs dans
l'unité légale. Par opposition à une détention
indirecte des droits de vote, via une
personne morale.
type: boolean
example: true
pleine_propriete:
title: Proportion détenue en pleine propriété
description: 'Pourcentage de droits de vote
directs détenus en pleine propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété : quelles
différences ?'
type: number
example: 51.0
nue_propriete:
title: Proportion détenue en nue-propriété
description: 'Pourcentage de droits de vote
directs détenus en nue-propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété : quelles
différences ?'
type: number
example: 0.0
usufruit:
title: Proportion détenue en usufruit
description: 'Pourcentage de droits de vote
directs détenus en usufruit.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété : quelles
différences ?'
type: number
example: 0.0
required:
- detention
- pleine_propriete
- nue_propriete
- usufruit
indirectes:
title: Droits de vote indirects
type: object
additionalProperties: false
properties:
detention:
title: Indique si le bénéficiaire détient
des droits de vote indirects
description: Détermine si le bénéficiaire
possède des droits de vote indirects dans
l'unité légale. Par opposition à une détention
indirecte des droits de vote, via une
personne morale.
type: boolean
example: false
par_indivision:
title: Via une indivision
description: 'Les droits de vote indirects
peuvent être détenus par le biais d''une
indivision. Plus d''infos sur le lien
suivant: Succession
: qu''est-ce que l''indivision ?'
type: object
additionalProperties: false
properties:
total:
title: Total des droits de vote indirects
en indivision
description: Pourcentage total de droits
de vote indirects détenus par le biais
d'une indivision.
type: number
example: 0.0
pleine_propriete:
title: Proportion détenue en pleine
propriété
description: 'Pourcentage de droits
de vote indirects en indivision détenus
en pleine propriété.
Plus d''infos
sur les différents des droits sur
un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
nue_propriete:
title: Proportion détenue en nue-propriété
description: 'Pourcentage de droits
de vote indirects en indivision détenus
en nue-propriété.
Plus d''infos
sur les différents des droits sur
un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
usufruit:
title: Proportion détenue en usufruit
description: 'Pourcentage de droits
de vote indirects en indivision détenus
en usufruit.
Plus d''infos sur
les différents des droits sur un bien
sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
required:
- total
- pleine_propriete
- nue_propriete
- usufruit
via_personnes_morales:
title: Via une ou des personnes morales
description: Les droits de vote indirects
peuvent être détenus par le biais d'une
ou de plusieurs personnes morales intermédiaires.
Plus d'infos sur les différents mécanismes
de détention des droits de vote dans cette
FAQ.
type: object
additionalProperties: false
properties:
total:
title: Total des droits de vote indirects
via des personnes morales
description: Pourcentage total des droits
de vote indirects détenus par le biais
d'une ou de plusieurs personnes morales.
type: number
example: 0.0
pleine_propriete:
title: Proportion détenue en pleine
propriété
description: 'Pourcentage de droits
de vote indirects via une personne
morale détenus en pleine propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
nue_propriete:
title: Proportion détenue en nue-propriété
description: 'Pourcentage de droits
de vote indirects via une personne
morale détenus en nue-propriété.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
usufruit:
title: Proportion détenue en usufruit
description: 'Pourcentage de droits
de vote indirects via une personne
morale détenus en usufruit.
Plus
d''infos sur les différents des droits
sur un bien sur le lien suivant: Usufruit,
nue-propriété, pleine propriété :
quelles différences ?'
type: number
example: 0.0
required:
- total
- pleine_propriete
- nue_propriete
- usufruit
required:
- detention
- par_indivision
- via_personnes_morales
required:
- total
- directes
- indirectes
pouvoirs_de_controle:
title: Pouvoirs de controle
description: Une personne physique est considérée
comme bénéficiaire effectif si elle possède un
pouvoir de contrôle sur les organes de gestion,
d'administration de la société ou sur l'assemblée
générale des associés. Dans ce cas, ce tableau
dresse le détail de cette détention de pouvoir.
type: object
additionalProperties: false
properties:
decision_ag:
title: Indique si le bénéficiaire détient du
pouvoir de décision en Assemblée Générale
type: boolean
example: false
nommage_membres_conseil_administratif:
title: Indique si le bénéficiaire détient du
pouvoir de nommage des membres du conseil
d'administration
type: boolean
example: false
autres:
title: Indique si le bénéficiaire détient d'autres
moyens de contrôle
type: boolean
example: false
required:
- decision_ag
- nommage_membres_conseil_administratif
- autres
representant_legal:
title: Indique si le bénéficiaire est représentant
légal
type: boolean
example: false
representant_legal_placement_sans_gestion_deleguee:
title: Indique si le bénéficiaire est représentant
légal en placement sans gestion déléguée
type: boolean
example: false
required:
- detention_de_capital
- vocation_a_devenir_titulaire_de_parts
- droits_de_vote
- pouvoirs_de_controle
- representant_legal
- representant_legal_placement_sans_gestion_deleguee
required:
- beneficiaire_uuid
- nom
- nom_usage
- prenoms
- date_naissance
- nationalite
- pays_residence
- modalites
links:
type: object
meta:
type: object
meta:
type: object
properties:
count:
title: Nombre de bénéficiaires
type: integer
example: 1
beneficiaires_sans_modalites_uuids:
title: UUIDs des bénéficiaires sans modalités
type: array
description: UUIDs des bénéficiaires qui ne sont pas affichés
car sans modalité (il s'agit de représentants légaux)
items:
type: string
example: 21120ee0-d42b-44f6-a462-d3724cf6aeaf
required:
- count
- beneficiaires_sans_modalites_uuids
additionalProperties: false
links:
type: object
required:
- data
- meta
'404':
description: |-
Bénéficiaires effectifs non trouvés
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_beneficiaires_effectifs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/beneficiaires_effectifs#erreurs.
content:
application/json:
examples:
entite_non_trouvee_34003:
value:
errors:
- code: '34003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INPI - RNE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_beneficiaires_effectifs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/beneficiaires_effectifs#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_beneficiaires_effectifs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/beneficiaires_effectifs#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_34999:
value:
errors:
- code: '34999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INPI - RNE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_beneficiaires_effectifs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/beneficiaires_effectifs#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '34002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INPI - RNE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_beneficiaires_effectifs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/beneficiaires_effectifs#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_beneficiaires_effectifs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/beneficiaires_effectifs#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '34020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INPI - RNE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_beneficiaires_effectifs, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/beneficiaires_effectifs#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/inpi/rne/unites_legales/130025265/beneficiaires_effectifs?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/inpi/rne/unites_legales/{siren}/extrait_rne":
get:
summary: Attestation d'immatriculation RNE
tags:
- Informations générales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Données figurant sur l'attestation d'immatriculation au registre
national des entreprises et lien vers le document au format PDF.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_extrait_rne, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/attestation_immatriculation#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_extrait_rne, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/attestation_immatriculation#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_extrait_rne, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/attestation_immatriculation#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Extrait RNE trouvés
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). Le cache est valide jusqu'à 3 heures
du matin.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_inpi_rne_extrait_rne
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
document_url:
type: string
description: URL de téléchargement de l'attestation d'immatriculation
au registre national des entreprises (.pdf)
example: https://data.inpi.fr/export/companies?format=pdf&ids=["123456789"]
identite_entreprise:
title: Identité de l'entreprise
type: object
properties:
denomination:
title: Dénomination
type: string
nullable: true
description: Dénomination sociale de l'entreprise
example: TECH SOLUTIONS FRANCE
nom:
title: Nom
type: string
nullable: true
description: Nom de famille de l'entrepreneur (pour les
entreprises individuelles uniquement)
example: MARTIN
prenoms:
title: Prénom(s)
type: array
nullable: true
description: Liste des prénoms de l'entrepreneur (pour
les entreprises individuelles uniquement)
items:
type: string
example:
- JEAN
- PIERRE
- HENRI
siren:
title: SIREN (Siège)
type: string
description: Numéro SIREN de l'entreprise
pattern: "^\\d{9}$"
example: '123456789'
date_immatriculation_rne:
title: Date d'immatriculation au RNE
type: string
format: date
description: Date d'immatriculation au RNE
example: '2018-03-15'
date_debut_activite:
title: Date d'activité
type: string
nullable: true
format: date
description: Date de début d'activité
example: '2018-04-01'
detail_cessation:
type: string
format: boolean
description: Indique la raison de cessation d'activité.
Systématiquement à null, l'API ne fournit pas cette
information.
example:
nullable: true
dissolution:
type: object
properties:
date:
type: string
format: date
description: Date de dissolution de l'entreprise
example: '2023-05-20'
nullable: true
poursuite_activite:
type: boolean
description: Indique si l'entreprise poursuit son
activité après dissolution
example: false
nullable: true
avec_liquidation:
type: boolean
description: Indique si la dissolution est suivie
d'une liquidation. Systématiquement à null, l'API
ne fournit pas cette information.
example: true
nullable: true
required:
- date
- poursuite_activite
- avec_liquidation
date_fin_personne:
title: Date de fin de la personne morale
type: string
format: date
description: Date de fin de la personne morale
example: '2117-03-14'
nullable: true
date_cloture_exercice:
title: Date de clôture
type: string
description: Date de clôture de l'exercice (format DD-MM)
pattern: "^\\d{2}-\\d{2}$"
example: 30-06
nullable: true
date_premiere_cloture_exercice:
title: Date de première clôture d'exercice
type: string
format: date
example: '2023-11-01'
nullable: true
nature_entreprise:
title: Nature de l'activité principale
type: string
description: Nature de l'entreprise
enum:
- COMMERCIALE
- ARTISANALE
- AGRICOLE
- LIBERALE
example: COMMERCIALE
forme_juridique:
title: Forme juridique
type: object
properties:
code:
type: string
description: Code de la forme juridique
example: '5710'
libelle:
type: string
description: Libellé de la forme juridique
example: SAS, société par actions simplifiée
required:
- code
- libelle
associe_unique:
title: Associé unique
type: boolean
description: Indique si l'entreprise a un associé unique
example: false
activite_principales_objet_social:
title: Activités principales de l'objet social
type: string
description: Objet social de l'activités principales de
l'entreprise
example: Développement, édition et commercialisation de
logiciels informatiques
nullable: true
code_APE:
title: Code APE
type: object
properties:
code:
type: string
description: Code APE/NAF de l'entreprise
pattern: "^\\d{4}[A-Z]$"
example: 6201Z
libelle:
type: string
description: Libellé de l'activité principale associé
au code
example: Programmation informatique
required:
- code
- libelle
code_APRM:
title: Code APRM
type: object
properties:
code:
type: string
description: Code de l'activité principale au répertoire
des métiers (APRM) s'appuyant sur le nomenclature
d'activité française pour l'artisanat (NAFA).
pattern: "^\\d{4}[A-Z]{2}$"
example: 6202A
nullable: true
libelle:
type: string
description: Libellé de l'activité APRM associé au
code.
example: Conseil en systèmes et logiciels informatiques
nullable: true
required:
- code
- libelle
capital_social:
title: Capital social
type: object
properties:
montant:
type: number
format: double
nullable: true
description: Montant du capital social
example: 50000.0
devise:
type: string
description: Devise du capital social
example: EUR
required:
- montant
- devise
adresse_siege_social:
title: Adresse du siège
type: object
properties:
voie:
type: string
description: Numéro et voie
example: 42 RUE DE L'INNOVATION
code_postal:
type: string
description: Code postal
pattern: "^\\d{5}$"
example: '69003'
commune:
type: string
description: Commune
example: LYON 3E ARRONDISSEMENT
pays:
type: string
description: Pays
example: FRANCE
complement:
type: string
description: Complément d'adresse
nullable: true
example: Bâtiment B - 2ème étage
required:
- voie
- code_postal
- commune
- pays
- complement
required:
- denomination
- nom
- prenoms
- siren
- date_immatriculation_rne
- date_debut_activite
- detail_cessation
- dissolution
- date_fin_personne
- date_cloture_exercice
- date_premiere_cloture_exercice
- nature_entreprise
- forme_juridique
- associe_unique
- activite_principales_objet_social
- code_APE
- code_APRM
- capital_social
- adresse_siege_social
dirigeants_et_associes:
title: Gestion et Direction
type: array
description: Liste des dirigeants actifs de l'entreprise
items:
type: object
properties:
qualite:
title: Qualité
type: string
description: Fonction dans l'entreprise
example: Président
nom:
title: Nom
type: string
description: Nom de famille
example: MARTIN
prenom:
title: Prénom(s)
type: string
description: Prénom
example: SOPHIE
date_naissance:
title: Date de naissance (mm/aaaa)
type: string
description: Date de naissance (format MM-YYYY)
pattern: "^\\d{2}-\\d{4}$"
example: 07-1985
commune_residence:
title: Commune de résidence
type: string
description: Commune de résidence
example: Lyon
etablissements:
title: Établissements
type: array
description: Liste des établissements actifs
items:
type: object
properties:
type_etablissement:
title: Type d'établissement
type: string
description: Type d'établissement
enum:
- Siège et principal
- Siège
- Secondaire
example: Siège et principal
date_debut_activite:
title: Date début activité
type: string
format: date
description: Date de début d'activité
example: '2018-04-01'
siret:
title: Siret
type: string
description: Numéro SIRET de l'établissement
pattern: "^\\d{14}$"
example: '12345678900001'
code_APE:
title: Code APE
type: object
properties:
code:
type: string
description: Code APE/NAF de l'établissement
pattern: "^\\d{4}[A-Z]$"
example: 6201Z
libelle:
type: string
description: Libellé de l'activité principale associé
au code
example: Programmation informatique
code_APRM:
title: Code APRM
type: object
properties:
code:
type: string
description: Code APRM (Activité Principale Réglementée
du Métier)
pattern: "^\\d{4}[A-Z]{2}$"
example: 6202A
nullable: true
libelle:
type: string
description: Libellé de l'activité APRM associé
au code
example: Conseil en systèmes et logiciels informatiques
nullable: true
nature_etablissement:
title: Nature de l'établissement
type: string
description: Nature de l'établissement
example: COMMERCIALE
activite_principale:
title: Activité principale
type: string
description: Description de l'activité
example: Programmation informatique, développement de
logiciels
autre_activite:
type: string
description: Concaténation des autres activités non
principales
example: Conseil en systèmes informatiques, maintenance
de logiciels
nullable: true
adresse:
title: Adresse
type: object
properties:
voie:
type: string
description: Numéro et voie
example: 42 RUE DE L'INNOVATION
code_postal:
type: string
description: Code postal
pattern: "^\\d{5}$"
example: '69003'
commune:
type: string
description: Commune
example: LYON 3E ARRONDISSEMENT
pays:
type: string
description: Pays
example: FRANCE
complement:
type: string
nullable: true
description: Complément d'adresse
example: Bâtiment B - 2ème étage
statut:
title: Statut de l'établissement
type: string
enum:
- actif
- fermé
example: actif
diffusion_commerciale:
title: Autorisation d'utilisation des données à des fins commerciales
(statut indiqué par l'Inpi)
type: boolean
description: Si le champ est à true, l'utilisation des données
à des fins commerciales est permise.
example: true
diffusion_insee:
title: Autorisation de diffusion du répertoire Sirene de l'Insee
type: boolean
description: Indique le statut de diffusion demandée par l'entreprise
à l'Insee vis à vis du répertoire Sirene. Si le champ est
à true, la diffusion est autorisée car le statut de l'entreprise
est en diffusion totale. Si le champ est à false, la diffusion
n'est pas autorisée pour la totalité des données car le
statut de l'entreprise est en diffusion partielle.
example: true
etablissements_fermes_total:
title: Nombre d'établissements fermés
type: integer
minimum: 0
example: 1
observations:
title: Observations
type: array
description: Observations RCS/RNM
items:
type: object
properties:
fournisseur:
type: string
description: Fournisseur de l'observation
enum:
- rcs
- rnm
example: rcs
numero:
type: string
description: Numéro de l'observation
example: 2023-05-20-001
date:
type: string
format: date
description: Date de l'observation
example: '2023-05-20'
texte:
type: string
description: Texte de l'observation
example: Augmentation de capital de 50000 à 75000 EUR
required:
- document_url
- identite_entreprise
- dirigeants_et_associes
- etablissements
- diffusion_commerciale
- diffusion_insee
- etablissements_fermes_total
- observations
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'404':
description: |-
Extrait RNE non trouvés
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_extrait_rne, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/attestation_immatriculation#erreurs.
content:
application/json:
examples:
entite_non_trouvee_34003:
value:
errors:
- code: '34003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INPI - RNE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_extrait_rne, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/attestation_immatriculation#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_extrait_rne, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/attestation_immatriculation#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_34999:
value:
errors:
- code: '34999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INPI - RNE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_extrait_rne, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/attestation_immatriculation#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '34002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INPI - RNE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_extrait_rne, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/attestation_immatriculation#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_extrait_rne, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/attestation_immatriculation#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '34020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INPI - RNE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_inpi_rne_extrait_rne, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/inpi/rne/attestation_immatriculation#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/inpi/rne/unites_legales/130025265/extrait_rne?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/insee/sirene/etablissements/{siret}/adresse":
get:
summary: Adresse établissement
tags:
- Informations générales
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Adresse d'un établissement inscrit au répertoire Sirene, y compris
celle des établissements en diffusion partielle.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Etablissement trouvé
x-operationId: api_entreprise_v3_insee_adresses_etablissements
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
numero_voie:
title: Numéro dans la voie
type: string
example: '22'
indice_repetition_voie:
title: Indice de répétition du numéro dans la voie
description: 'Plus d''informations dans la documentation Insee
de l''API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#indicerepetitionetablissement'
type: string
nullable: true
enum:
- bis
- ter
- quarter
- quinquies
-
type_voie:
title: Type de la voie de localisation
example: RUE
description: "Le type de la voie de localisation est indiquée
en abrégé et en majuscules. L'information n'est pas toujours
renseignée. Pour certaines petites communes, l'information
n'existe pas. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#typevoieetablissement"
type: string
nullable: true
enum:
- ALLÉE
- AVENUE
- BOULEVARD
- CARREFOUR
- CHEMIN
- CHAUSSÉE
- CITÉ
- CORNICHE
- COURS
- DOMAINE
- DESCENTE
- ECART
- ESPLANADE
- FAUBOURG
- GRANDE RUE
- HAMEAU
- HALLE
- IMPASSE
- LIEU-DIT
- LOTISSEMENT
- MARCHÉ
- MONTÉE
- PASSAGE
- PLACE
- PLAINE
- PLATEAU
- PROMENADE
- PARVIS
- QUARTIER
- QUAI
- RÉSIDENCE
- RUELLE
- ROCADE
- ROND-POINT
- ROUTE
- RUE
- SENTIER
- SQUARE
- TERRE-PLEIN
- TRAVERSE
- VILLA
- VILLAGE
-
libelle_voie:
title: Libellé de la voie
type: string
example: DE LA PAIX
complement_adresse:
title: Complément d'adresse
type: string
description: Le complément d'adresse correspond à des éléments
situés à l'extérieur du bâtiment qui permettent de compléter
l'adresse (résidence, bâtiment, entrée, etc..)
example: ZAE SAINT GUENAULT
nullable: true
code_commune:
title: Code commune
description: "Le code commune désigne le code de la commune
de localisation de l'établissement. Le code renvoyé correspond
à la date de l'appel, ce qui implique que toute modification
du code commune est repercutée sur l'ensemble des établissements
concernés, y compris ceux qui sont fermés. Cette valeur
est à 'null' pour les entreprises à l'étranger. \n \n Les
codes sont listés dans la table d'appartenance géographique
fournie par l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028"
type: string
example: '75112'
nullable: true
code_postal:
title: Code postal
example: '75016'
type: string
nullable: true
distribution_speciale:
title: Distribution spéciale
type: string
nullable: true
description: "La distribution spéciale reprend les éléments
particuliers qui accompagnent une adresse de distribution
spéciale, la modalité la plus connue étant les adresses
en 'CEDEX'. \n \n L'Insee ne gère plus cette variable :
elle est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#distributionspecialeetablissement"
code_cedex:
title: Code cedex
type: string
nullable: true
description: "L'Insee ne gère plus cette variable : elle est
désormais toujours à 'null'. \n \n Plus d'informations dans
la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#codecedexetablissement
\n \n Sur le sigle CEDEX lui-même : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle"
libelle_cedex:
title: Libellé du code cedex
type: string
nullable: true
description: "Ce champ indique le libellé correspondant au
code cedex de l'établissement. Si le code cedex est à 'null',
ce champ est également à 'null'. \n \n L'Insee ne gère plus
cette variable : elle est désormais toujours à 'null'. \n
\n Plus d'informations dans la documentation Insee de l'API
Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#libellecedexetablissement"
libelle_commune:
title: Nom de la commune pour une adresse en France
description: Cette valeur est à 'null' pour les établissements
à l'étranger.
type: string
example: PARIS 12
nullable: true
libelle_commune_etranger:
title: Nom de la commune pour une adresse à l'étranger.
description: Cette valeur est à 'null' pour les établissements
en France.
type: string
nullable: true
code_pays_etranger:
title: Code du pays pour les établissements situés à l'étranger
description: 'La nomenclature des codes pays se trouve ici
: https://www.insee.fr/fr/information/2028273'
type: string
example: '99132'
nullable: true
libelle_pays_etranger:
title: Nom du pays pour les établissements situés à l'étranger
type: string
nullable: true
example: ROYAUME-UNI
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
acheminement_postal:
type: object
additionalProperties: false
title: Éléments constitutifs de l'adresse postale pour son
acheminement.
description: Il ne s'agit pas d'un traitement RNVP mais simplement
d'une réorganisation des éléments renvoyé par l'Insee pour
faciliter l'affichage des adresses postales
properties:
l1:
title: Ligne 1
type: string
description: 'Si l''établissement correspond à une personne
morale : la dénomination sociale de la personne morale.
Le cas contraire: cette variable est vide.'
nullable: true
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
l2:
title: Ligne 2
type: string
description: 'Si l''établissement correspond à une personne
physique : concaténation du nom et prénom'
nullable: true
example: JEAN MARIE DURAND
l3:
title: Ligne 3
type: string
description: Complément d'adresse comme décrit dans la
clé `complement_adresse`
nullable: true
example: ZAE SAINT GUENAULT
l4:
title: Ligne 4
type: string
description: Concaténation du numéro de voie, d'indice
de répétition, du type de voie et du libellé de la voie
nullable: true
example: 51 BIS RUE DE LA PAIX
l5:
title: Ligne 5
type: string
description: 'Distribution spéciale comme décrit dans
la clé `distribution_speciale`, que l''Insee ne gère
plus : cette ligne est désormais toujours vide.'
nullable: true
l6:
title: Ligne 6
type: string
description: "Si le pays est en France : code postal accompagné
du libellé de la commune, sinon : libellé de la commune
de l'établissement situé à l'étranger. \n \n Le code
cedex, qui primait sur le code postal, ne sort plus
de cette ligne : l'Insee ne gère plus cette variable."
nullable: true
example: 75012 PARIS
l7:
title: Ligne 7
type: string
description: Pays de l'établissement
nullable: true
example: FRANCE
required:
- l1
- l2
- l3
- l4
- l5
- l6
- l7
required:
- numero_voie
- indice_repetition_voie
- type_voie
- libelle_voie
- complement_adresse
- code_commune
- code_postal
- distribution_speciale
- code_cedex
- libelle_cedex
- libelle_commune
- libelle_commune_etranger
- code_pays_etranger
- libelle_pays_etranger
- status_diffusion
- acheminement_postal
additionalProperties: false
links:
type: object
properties:
unite_legale:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/unites_legales/130025265
description: Lien vers la ressource 'Donnée Sirene d'une unité
légale' correspondant à cette adresse d'établissement pour
obtenir les données de référence de l'unité légale.
etablissement:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/etablissements/13002526500013
description: Lien vers la ressource 'Donnée Sirene d'un établissement'
correspondant à cette adresse d'établissement pour obtenir
les données de référence de l'établissement.
required:
- unite_legale
- etablissement
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
required:
- date_derniere_mise_a_jour
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
'451':
description: |-
Indisponible pour des raisons légales
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements#erreurs.
content:
application/json:
examples:
error_01005:
value:
errors:
- code: '01005'
title: Indisponible pour des raisons légales
detail: Cette entité n'est accessible par aucun organisme.
source:
meta:
provider: INSEE
summary: Indisponible pour des raisons légales
description: Cette entité n'est accessible par aucun organisme.
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/insee/sirene/etablissements/13002526500013/adresse?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/insee/sirene/etablissements/diffusibles/{siret}/adresse":
get:
summary: Adresse établissement en open data
tags:
- Informations générales
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Adresse d'un établissement inscrit au répertoire Sirene, si celui-ci
n'a pas choisi la diffusion partielle.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements_diffusibles#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements_diffusibles#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements_diffusibles#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Etablissement trouvé
x-operationId: api_entreprise_v3_insee_adresses_etablissements_diffusables
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
numero_voie:
title: Numéro dans la voie
type: string
example: '22'
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
indice_repetition_voie:
title: Indice de répétition du numéro dans la voie
description: "Plus d'informations dans la documentation Insee
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#indicerepetitionetablissement
\n Si la personne morale est en diffusion partielle, la
valeur est remplacée par \"[ND]\"."
type: string
nullable: true
enum:
- bis
- ter
- quarter
- quinquies
-
type_voie:
title: Type de la voie de localisation
example: RUE
description: "Le type de la voie de localisation est indiquée
en abrégé et en majuscules. L'information n'est pas toujours
renseignée. Pour certaines petites communes, l'information
n'existe pas. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#typevoieetablissement
\n Si la personne morale est en diffusion partielle, la
valeur est remplacée par \"[ND]\"."
type: string
nullable: true
enum:
- ALLÉE
- AVENUE
- BOULEVARD
- CARREFOUR
- CHEMIN
- CHAUSSÉE
- CITÉ
- CORNICHE
- COURS
- DOMAINE
- DESCENTE
- ECART
- ESPLANADE
- FAUBOURG
- GRANDE RUE
- HAMEAU
- HALLE
- IMPASSE
- LIEU-DIT
- LOTISSEMENT
- MARCHÉ
- MONTÉE
- PASSAGE
- PLACE
- PLAINE
- PLATEAU
- PROMENADE
- PARVIS
- QUARTIER
- QUAI
- RÉSIDENCE
- RUELLE
- ROCADE
- ROND-POINT
- ROUTE
- RUE
- SENTIER
- SQUARE
- TERRE-PLEIN
- TRAVERSE
- VILLA
- VILLAGE
-
libelle_voie:
title: Libellé de la voie
type: string
example: DE LA PAIX
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
complement_adresse:
title: Complément d'adresse
type: string
description: "Le complément d'adresse correspond à des éléments
situés à l'extérieur du bâtiment qui permettent de compléter
l'adresse (résidence, bâtiment, entrée, etc..) \n Si la
personne morale est en diffusion partielle, le complément
d'adresse n'est pas renvoyé, et la valeur est remplacée
par \"[ND]\"."
example: ZAE SAINT GUENAULT
nullable: true
code_commune:
title: Code commune
description: "Le code commune désigne le code de la commune
de localisation de l'établissement. Le code renvoyé correspond
à la date de l'appel, ce qui implique que toute modification
du code commune est repercutée sur l'ensemble des établissements
concernés, y compris ceux qui sont fermés. Cette valeur
est à 'null' pour les entreprises à l'étranger. \n \n Les
codes sont listés dans la table d'appartenance géographique
fournie par l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028"
type: string
example: '75112'
nullable: true
code_postal:
title: Code postal
example: '75016'
type: string
nullable: true
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
distribution_speciale:
title: Distribution spéciale
type: string
nullable: true
description: "La distribution spéciale reprend les éléments
particuliers qui accompagnent une adresse de distribution
\ spéciale, la modalité la plus connue étant les adresses
en 'CEDEX'. \n \n L'Insee ne gère plus cette variable :
elle est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#distributionspecialeetablissement
\n Si la personne morale est en diffusion partielle, la
valeur est remplacée par \"[ND]\"."
code_cedex:
title: Code cedex
type: string
nullable: true
description: "L'Insee ne gère plus cette variable : elle est
désormais toujours à 'null'. \n Plus d'informations dans
la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#codecedexetablissement
\n Sur le sigle CEDEX lui-même : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle
\n Si la personne morale est en diffusion partielle, la
valeur est remplacée par \"[ND]\"."
libelle_cedex:
title: Libellé du code cedex
type: string
nullable: true
description: "Ce champ indique le libellé correspondant au
code cedex de l'établissement. Si le code cedex est à 'null',
ce champ est également à 'null'. \n L'Insee ne gère plus
cette variable : elle est désormais toujours à 'null'. \n
Plus d'informations dans la documentation Insee de l'API
Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#libellecedexetablissement
\n Si la personne morale est en diffusion partielle, la
valeur est remplacée par \"[ND]\"."
libelle_commune:
title: Nom de la commune pour une adresse en France
description: Cette valeur est à 'null' pour les établissements
à l'étranger.
type: string
example: PARIS 12
nullable: true
libelle_commune_etranger:
title: Nom de la commune pour une adresse à l'étranger.
description: Cette valeur est à 'null' pour les établissements
en France.
type: string
nullable: true
code_pays_etranger:
title: Code du pays pour les établissements situés à l'étranger
description: 'La nomenclature des codes pays se trouve ici
: https://www.insee.fr/fr/information/2028273'
type: string
example: '99132'
nullable: true
libelle_pays_etranger:
title: Nom du pays pour les établissements situés à l'étranger
type: string
nullable: true
example: ROYAUME-UNI
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
acheminement_postal:
type: object
additionalProperties: false
title: Éléments constitutifs de l'adresse postale pour son
acheminement.
description: Il ne s'agit pas d'un traitement RNVP mais simplement
d'une réorganisation des éléments renvoyé par l'Insee pour
faciliter l'affichage des adresses postales
properties:
l1:
title: Ligne 1
type: string
description: "Si l'établissement correspond à une personne
morale : la dénomination sociale de la personne morale.
Le cas contraire: cette variable est vide. \n Si la
personne morale est en diffusion partielle, la valeur
est remplacée par \"[ND]\"."
nullable: true
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
l2:
title: Ligne 2
type: string
description: "Si l'établissement correspond à une personne
physique : concaténation du nom et prénom \n Si la personne
morale est en diffusion partielle, la valeur est remplacée
par \"[ND]\"."
nullable: true
example: JEAN MARIE DURAND
l3:
title: Ligne 3
type: string
description: "Si l'établissement correspond à une personne
physique : concaténation du nom et prénom \n Si la personne
morale est en diffusion partielle, la valeur est remplacée
par \"[ND]\"."
nullable: true
example: ZAE SAINT GUENAULT
l4:
title: Ligne 4
type: string
description: "Concaténation du numéro de voie, d'indice
de répétition, du type de voie et du libellé de la voie
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
example: 51 BIS RUE DE LA PAIX
l5:
title: Ligne 5
type: string
description: "Distribution spéciale comme décrit dans
la clé `distribution_speciale`, que l'Insee ne gère
plus : cette ligne est désormais toujours vide. \n Si
la personne morale est en diffusion partielle, la valeur
est remplacée par \"[ND]\"."
nullable: true
l6:
title: Ligne 6
type: string
description: "Si le pays est en France : code postal accompagné
du libellé de la commune, sinon : libellé de la commune
de l'établissement situé à l'étranger. \n Le code cedex,
qui primait sur le code postal, ne sort plus de cette
ligne : l'Insee ne gère plus cette variable. \n Si la
personne morale est en diffusion partielle, la valeur
est remplacée par \"[ND]\"."
nullable: true
example: 75012 PARIS
l7:
title: Ligne 7
type: string
description: Pays de l'établissement
nullable: true
example: FRANCE
required:
- l1
- l2
- l3
- l4
- l5
- l6
- l7
required:
- numero_voie
- indice_repetition_voie
- type_voie
- libelle_voie
- complement_adresse
- code_commune
- code_postal
- distribution_speciale
- code_cedex
- libelle_cedex
- libelle_commune
- libelle_commune_etranger
- code_pays_etranger
- libelle_pays_etranger
- status_diffusion
- acheminement_postal
additionalProperties: false
links:
type: object
properties:
unite_legale:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/unites_legales/130025265
description: Lien vers la ressource 'Donnée Sirene d'une unité
légale' correspondant à cette adresse d'établissement pour
obtenir les données de référence de l'unité légale.
etablissement:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/etablissements/13002526500013
description: Lien vers la ressource 'Donnée Sirene d'un établissement'
correspondant à cette adresse d'établissement pour obtenir
les données de référence de l'établissement.
required:
- unite_legale
- etablissement
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
required:
- date_derniere_mise_a_jour
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements_diffusibles#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements_diffusibles#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements_diffusibles#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements_diffusibles#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements_diffusibles#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements_diffusibles#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements_diffusibles#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
'451':
description: |-
Indisponible pour des raisons légales
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_adresses_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/adresse_etablissements_diffusibles#erreurs.
content:
application/json:
examples:
error_01005:
value:
errors:
- code: '01005'
title: Indisponible pour des raisons légales
detail: Cette entité n'est accessible par aucun organisme.
source:
meta:
provider: INSEE
summary: Indisponible pour des raisons légales
description: Cette entité n'est accessible par aucun organisme.
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/insee/sirene/etablissements/diffusibles/13002526500013/adresse?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/insee/sirene/etablissements/{siret}":
get:
summary: Données établissement
tags:
- Informations générales
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
deprecated: true
security:
- jwt_bearer_token: []
description: Informations générales concernant un établissement inscrit au répertoire
Sirene. Avec les données protégées des établissements en diffusion partielle.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_v3#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_v3#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_v3#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Etablissement trouvé
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_insee_etablissements
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siret:
title: Siret de l'établissement
type: string
example: '30613890001294'
description: Il peut arriver que le siret renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
siege_social:
type: boolean
example: true
enum:
- true
- false
description: Indique si l'établissement est le siège social
de l'entreprise.
etat_administratif:
title: État administratif de l'établissement
type: string
example: A
enum:
- A
- F
description: "Cette valeur décrit l'état administratif de
l'établissement, qui peut être : \n \n - actif. Sauf exception,
lors de son inscription au répertoire, tout établissement
est à l'état 'actif'\n\n - fermé. Cet état découle de la
prise en compte d'une déclaration de fermeture. Un établissement
fermé peut être rouvert. \n \n Plus d'informations dans
la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#etatadministratifetablissement"
date_fermeture:
title: Date de fermeture de l'établissement
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'établissement
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'un
établissement n'ayant pas encore de code APE peut se
voir affecter la valeur '00.00Z' de manière provisoire.
\n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'établissement
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
title: Code effectif
type: string
nullable: true
example: '51'
description: "Le code effectif correspond à la tranche
d'effectif salarié de l'établissement : \n \n - NN :
Unités non employeuses (pas de salarié au cours de l'année
de référence et pas d'effectif au 31/12). Cette tranche
peut contenir quelques effectifs inconnus \n - 00 :
0 salarié (n'ayant pas d'effectif au 31/12 mais ayant
employé des salariés au cours de l'année de référence)
\n - 01 : 1 ou 2 salariés \n - 02 : 3 à 5 salariés \n
- 03 : 6 à 9 salariés \n - 11 : 10 à 19 salariés \n
- 12 : 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999 salariés
\n - 42 : 1 000 à 1 999 salariés \n - 51 : 2 000 à 4
999 salariés \n - 52 : 5 000 à 9 999 salariés \n - 53
: 10 000 salariés et plus \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#trancheeffectifsetablissement.
\n \n L'effectif mensuel exact de l'établissement est
disponible au travers de l'[API Effectifs - URSSAF Caisse
nationale](https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement).
Si votre jeton contient ce droit d'accès, nous vous
recommandons d'utiliser cette API. Ces données étant
protégées, leur cadre d'utilisation est différent de
la tranche effectif fournie par l'Insee, qui elle est
une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si des
données protégées sont présentes dans la payload (ce qui
est le cas lorsque l'unité légale est en statut de diffusion
partielle). Pour une unité légale : \n \n - diffusible :
'true', car toutes les données sont publiques ; \n - partiellement-diffusible
: 'false', une partie des données est protégée et ne doit
pas être diffusée, pour du pré-remplissage de formulaire
public, préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète) :
'false', dans ce cas, les informations obtenues ne doivent
en aucun cas être accessibles au grand public. Ce cas n'étant
plus censé exister, préférer l'API en open data qui masque
automatiquement les données protégées. \n Plus d'informations
sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
enseigne:
title: Enseigne de l'établissement
type: string
nullable: true
description: "L'enseigne est l'appellation désignant l'emplacement
ou le local dans lequel est exercée l'activité. Un établissement
peut posséder une enseigne, plusieurs enseignes ou aucune.
\n \n Cette variable est la concaténation séparée par des
virgules des 3 champs \"renvoyés\" par l'Insee. Plus d'informations
ici: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#enseigne1etablissement-enseigne2etablissement-enseigne3etablissement"
example: Coiff Land, CoiffureLand
unite_legale:
type: object
additionalProperties: false
title: Unité légale de l'établissement
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit
différent du paramètre d'appel. Il s'agit d'une erreur
généralement temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale
est également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant
à une personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale.
Les valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique.
Les valeurs sont à 'null' pour les personnes morales.
Pour les personnes physiques, la raison sociale / dénomination
/ nom de l'entreprise correspond toujours au nom de
famille et au prénom, précédés ou suivis de la mention
"entrepreneur individuel" ou "EI". Pour en savoir plus,
consulter cette page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: Le pseudonyme correspond au nom qu'une
personne utilise pour se désigner dans l'exercice
de son activité, généralement littéraire ou artistique.
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la
vie courante. Ce prénom fait partie de ceux qui
lui ont été donnés à sa naissance et qui sont inscrits
à l'état civil.
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: Nom que la personne physique a choisi
d'utiliser.
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: Caractère féminin ou masculin de la personne
physique. Cette valeur peut ne pas être renseignée
pour une personne physique.
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n
\n - GE : Grande Entreprise \n - ETI : Entreprise de
Taille Intermédiaire \n - PME : Petite ou Moyenne Entreprise
\n \n Celle-ci peut-être 'null' dans certains cas :
quand il s’agit d’une unité légale nouvellement créée,
ou bien d’une unité légale cessée, ou encore d’une unité
légale hors champ du calcul de la catégorie (unité légale
agricole ou ne faisant pas partie du système productif).
\n \n Définition de 'catégorie d'entreprise' par l'Insee
: https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité
légale : \n \n - Diffusible : Toutes les données de
l'unité légale sont diffusibles, donc publiques. \n
- Partiellement diffusible : Seule une partie des données
est diffusible, suite à une demande de l'entité qui
a exercé sont droit d'opposition à la diffusion de données
personnelles. \n - Non-diffusible (obsolète) : Ce statut
correspond à l'ancien statut, toutes les entités ayant
exercé leur droit d'opposition sont normalement désormais
en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement
publiques et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si
des données protégées sont présentes dans la payload
(ce qui est le cas lorsque l'unité légale est en statut
de diffusion partielle). Pour une unité légale : \n
\n - diffusible : 'true', car toutes les données sont
publiques ; \n - partiellement-diffusible : 'false',
une partie des données est protégée et ne doit pas être
diffusée, pour du pré-remplissage de formulaire public,
préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète)
: 'false', dans ce cas, les informations obtenues ne
doivent en aucun cas être accessibles au grand public.
Ce cas n'étant plus censé exister, préférer l'API en
open data qui masque automatiquement les données protégées.
\n Plus d'informations sur les conditions de diffusion
: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier
niveau de classement contient 9 grandes catégories
identifiables avec le premier chiffre du code :
\n \n - 0 : Organisme de placement collectif en
valeurs mobilières sans personnalité morale \n -
1 : Entrepreneur individuel. La catégorie juridique
des personnes physiques est '1000'. \n - 2 : Groupement
de droit privé non doté de la personnalité morale
\n - 3 : Personne morale de droit étranger \n -
4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 :
Autre personne morale immatriculée au RCS \n - 7
: Personne morale et organisme soumis au droit administratif
\n - 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des
codes fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique
de l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au
code juridique. Si le code ne correspond à aucun
libellé la valeur 'non référencé' est utilisée.
\n \n Nomenclature exhaustive fournie par l'Insee
: https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce
code de 4 chiffres + 1 lettre est extrait de la
nomenclature d'activité française (NAF) de l'Insee.
Si le code n'est pas renseigné dans la nomenclature
'Naf Rév2' (nomenclature en vigueur), le code est
null ici. \n \n À noter qu'une entreprise n'ayant
pas encore de code APE peut se voir affecter la
valeur '00.00Z' de manière provisoire. \n \n Plus
d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de
l'Insee : https://www.insee.fr/fr/information/2120875.
\n \n ⚠️ À partir de janvier 2026, le code APE utilisera
la nouvelle nomenclature NAF 2025, tel qu'explicité
dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par
l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en
vigueur), la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents (créés
il y a moins de trois ans). Les délais de récolte et
traitement font que les valeurs indiquées datent de
l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale :
\n \n - NN : Unités non employeuses (pas de salarié
au cours de l'année de référence et pas d'effectif
au 31/12). Cette tranche peut contenir quelques
effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou
2 salariés \n - 02 : 3 à 5 salariés \n - 03 : 6
à 9 salariés \n - 11 : 10 à 19 salariés \n - 12
: 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999
salariés \n - 42 : 1 000 à 1 999 salariés \n - 51
: 2 000 à 4 999 salariés \n - 52 : 5 000 à 9 999
salariés \n - 53 : 10 000 salariés et plus \n \n
Plus d'informations dans la documentation Insee
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel
et annuel, est disponible au travers de l'API Effectifs
- URSSAF Caisse nationale. Si votre jeton contient
ce droit d'accès, nous vous recommandons d'utiliser
cette API. Ces données étant protégées, leur cadre
d'utilisation est différent de la tranche effectif
fournie par l'Insee, qui elle est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif
de l'unité légale qui peut être « active » ou « cessée
» \n \n **Pour les personnes morales**, l'unité légale
est considérée comme juridiquement « cessée » si : \n
- il y a eu dépôt de la déclaration de disparition
de la personne morale ; \n - 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”) ;
\n - elle n'a plus d'établissement en activité. \n \n
**Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n -
l'exploitant de l'unité légale décède ; \n - l'exploitant
dépose une cessation d'activité. \n \n En dehors de
ces cas, l'état administratif de l'unité légale est
toujours « actif ». \n \n Plus d'informations dans la
documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire
(ESS)
description: "Indique si l'unité légale est une ESS :
\n \n - true : l'entreprise est une ESS \n - false :
l'entreprise n'est pas une ESS \n - null : le statut
ESS est inconnu. Cette information est connue pour environ
1 million d'unités légales, autrement, elle est à null.
\n \n Les unités légales de l'ESS adhèrent aux mêmes
principes : \n * poursuivre un but social autre que
le seul partage des bénéfices ; \n * une lucrativité
encadrée (notamment des bénéfices majoritairement consacrés
au maintien et au développement de l’activité) ; \n
* une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date
qui figure dans les statuts de l'entreprise qui sont
déposés au centre de formalité des entreprises (CFE)
compétent. Cette valeur est renvoyée sous format timestamp.
\n \n Pour certains établissements très anciens, tous
fermés et dont l’unité légale est cessée la date de
création peut être nulle. \n Pour les unités purgées,
la date de création n'est jamais à 'null'. Si elle est
non renseignée, elle sera au 01/01/1900. \n \n Plus
d'informations dans la documentation Insee de l'API
Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
adresse:
type: object
additionalProperties: false
title: Adresse de l'établissement
properties:
numero_voie:
title: Numéro dans la voie
type: string
example: '22'
indice_repetition_voie:
title: Indice de répétition du numéro dans la voie
description: 'Plus d''informations dans la documentation
Insee de l''API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#indicerepetitionetablissement'
type: string
nullable: true
enum:
- bis
- ter
- quarter
- quinquies
-
type_voie:
title: Type de la voie de localisation
example: RUE
description: "Le type de la voie de localisation est indiquée
en abrégé et en majuscules. L'information n'est pas
toujours renseignée. Pour certaines petites communes,
l'information n'existe pas. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#typevoieetablissement"
type: string
nullable: true
enum:
- ALLÉE
- AVENUE
- BOULEVARD
- CARREFOUR
- CHEMIN
- CHAUSSÉE
- CITÉ
- CORNICHE
- COURS
- DOMAINE
- DESCENTE
- ECART
- ESPLANADE
- FAUBOURG
- GRANDE RUE
- HAMEAU
- HALLE
- IMPASSE
- LIEU-DIT
- LOTISSEMENT
- MARCHÉ
- MONTÉE
- PASSAGE
- PLACE
- PLAINE
- PLATEAU
- PROMENADE
- PARVIS
- QUARTIER
- QUAI
- RÉSIDENCE
- RUELLE
- ROCADE
- ROND-POINT
- ROUTE
- RUE
- SENTIER
- SQUARE
- TERRE-PLEIN
- TRAVERSE
- VILLA
- VILLAGE
-
libelle_voie:
title: Libellé de la voie
type: string
example: DE LA PAIX
complement_adresse:
title: Complément d'adresse
type: string
description: Le complément d'adresse correspond à des
éléments situés à l'extérieur du bâtiment qui permettent
de compléter l'adresse (résidence, bâtiment, entrée,
etc..)
example: ZAE SAINT GUENAULT
nullable: true
code_commune:
title: Code commune
description: "Le code commune désigne le code de la commune
de localisation de l'établissement. Le code renvoyé
correspond à la date de l'appel, ce qui implique que
toute modification du code commune est repercutée sur
l'ensemble des établissements concernés, y compris ceux
qui sont fermés. Cette valeur est à 'null' pour les
entreprises à l'étranger. \n \n Les codes sont listés
dans la table d'appartenance géographique fournie par
l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028"
type: string
example: '75112'
nullable: true
code_postal:
title: Code postal
example: '75016'
type: string
nullable: true
distribution_speciale:
title: Distribution spéciale
type: string
nullable: true
description: "La distribution spéciale reprend les éléments
particuliers qui accompagnent une adresse de distribution
spéciale, la modalité la plus connue étant les adresses
en 'CEDEX'. \n \n L'Insee ne gère plus cette variable
: elle est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#distributionspecialeetablissement"
code_cedex:
title: Code cedex
type: string
nullable: true
description: "L'Insee ne gère plus cette variable : elle
est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#codecedexetablissement
\n \n Sur le sigle CEDEX lui-même : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle"
libelle_cedex:
title: Libellé du code cedex
type: string
nullable: true
description: "Ce champ indique le libellé correspondant
au code cedex de l'établissement. Si le code cedex est
à 'null', ce champ est également à 'null'. \n \n L'Insee
ne gère plus cette variable : elle est désormais toujours
à 'null'. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#libellecedexetablissement"
libelle_commune:
title: Nom de la commune pour une adresse en France
description: Cette valeur est à 'null' pour les établissements
à l'étranger.
type: string
example: PARIS 12
nullable: true
libelle_commune_etranger:
title: Nom de la commune pour une adresse à l'étranger.
description: Cette valeur est à 'null' pour les établissements
en France.
type: string
nullable: true
code_pays_etranger:
title: Code du pays pour les établissements situés à l'étranger
description: 'La nomenclature des codes pays se trouve
ici : https://www.insee.fr/fr/information/2028273'
type: string
example: '99132'
nullable: true
libelle_pays_etranger:
title: Nom du pays pour les établissements situés à l'étranger
type: string
nullable: true
example: ROYAUME-UNI
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement
diffusible : Seule une partie des données est diffusible,
suite à une demande de l'entité qui a exercé sont droit
d'opposition à la diffusion de données personnelles.
\n - Non-diffusible (obsolète) : Ce statut correspond
à l'ancien statut, toutes les entités ayant exercé leur
droit d'opposition sont normalement désormais en statut
\"partiellement diffusible\"."
acheminement_postal:
type: object
additionalProperties: false
title: Éléments constitutifs de l'adresse postale pour
son acheminement.
description: Il ne s'agit pas d'un traitement RNVP mais
simplement d'une réorganisation des éléments renvoyé
par l'Insee pour faciliter l'affichage des adresses
postales
properties:
l1:
title: Ligne 1
type: string
description: 'Si l''établissement correspond à une
personne morale : la dénomination sociale de la
personne morale. Le cas contraire: cette variable
est vide.'
nullable: true
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
l2:
title: Ligne 2
type: string
description: 'Si l''établissement correspond à une
personne physique : concaténation du nom et prénom'
nullable: true
example: JEAN MARIE DURAND
l3:
title: Ligne 3
type: string
description: Complément d'adresse comme décrit dans
la clé `complement_adresse`
nullable: true
example: ZAE SAINT GUENAULT
l4:
title: Ligne 4
type: string
description: Concaténation du numéro de voie, d'indice
de répétition, du type de voie et du libellé de
la voie
nullable: true
example: 51 BIS RUE DE LA PAIX
l5:
title: Ligne 5
type: string
description: 'Distribution spéciale comme décrit dans
la clé `distribution_speciale`, que l''Insee ne
gère plus : cette ligne est désormais toujours vide.'
nullable: true
l6:
title: Ligne 6
type: string
description: "Si le pays est en France : code postal
accompagné du libellé de la commune, sinon : libellé
de la commune de l'établissement situé à l'étranger.
\n \n Le code cedex, qui primait sur le code postal,
ne sort plus de cette ligne : l'Insee ne gère plus
cette variable."
nullable: true
example: 75012 PARIS
l7:
title: Ligne 7
type: string
description: Pays de l'établissement
nullable: true
example: FRANCE
required:
- l1
- l2
- l3
- l4
- l5
- l6
- l7
required:
- numero_voie
- indice_repetition_voie
- type_voie
- libelle_voie
- complement_adresse
- code_commune
- code_postal
- distribution_speciale
- code_cedex
- libelle_cedex
- libelle_commune
- libelle_commune_etranger
- code_pays_etranger
- libelle_pays_etranger
- status_diffusion
- acheminement_postal
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
required:
- siret
- siege_social
- etat_administratif
- date_fermeture
- activite_principale
- tranche_effectif_salarie
- status_diffusion
- diffusable_commercialement
- enseigne
- unite_legale
- adresse
- date_creation
additionalProperties: false
links:
type: object
properties:
unite_legale:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/unites_legales/130025265
description: Lien vers la ressource 'Donnée Sirene d'une unité
légale' correspondant à cette adresse d'établissement pour
obtenir les données de référence de l'unité légale.
required:
- unite_legale
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siret:
type: string
title: Siret d'origine de la requête
description: "Si la requête a été effectuée sur un siret qui
a été redirigé vers un autre siret , cette variable contient
le siret d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siret est différent du
paramètre d'appel, et cette variable est le siret d'entrée.
\n \n A noter que le siret de redirection est systématiquement
le siret du siège social de l'unité légale : en effet la
base Sirene ne possède pas la correspondance exacte entre
un siret doublon et le siret d'origine. "
example: '30613890000010'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siret
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_v3#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_v3#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'451':
description: |-
Indisponible pour des raisons légales
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_v3#erreurs.
content:
application/json:
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_v3#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_v3#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_v3#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_v3#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_v3#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/insee/sirene/etablissements/13002526500013?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/insee/sirene/etablissements/{siret}":
get:
summary: Données établissement
tags:
- Informations générales
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Informations générales concernant un établissement inscrit au répertoire
Sirene. Avec les données protégées des établissements en diffusion partielle.
Cette version utilise la nomenclature NAF2025 pour l'activité principale.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Etablissement trouvé
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_insee_etablissements
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siret:
title: Siret de l'établissement
type: string
example: '30613890001294'
description: Il peut arriver que le siret renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
siege_social:
type: boolean
example: true
enum:
- true
- false
description: Indique si l'établissement est le siège social
de l'entreprise.
etat_administratif:
title: État administratif de l'établissement
type: string
example: A
enum:
- A
- F
description: "Cette valeur décrit l'état administratif de
l'établissement, qui peut être : \n \n - actif. Sauf exception,
lors de son inscription au répertoire, tout établissement
est à l'état 'actif'\n\n - fermé. Cet état découle de la
prise en compte d'une déclaration de fermeture. Un établissement
fermé peut être rouvert. \n \n Plus d'informations dans
la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#etatadministratifetablissement"
date_fermeture:
title: Date de fermeture de l'établissement
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'établissement
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'un
établissement n'ayant pas encore de code APE peut se
voir affecter la valeur '00.00Z' de manière provisoire.
\n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'établissement
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
title: Code effectif
type: string
nullable: true
example: '51'
description: "Le code effectif correspond à la tranche
d'effectif salarié de l'établissement : \n \n - NN :
Unités non employeuses (pas de salarié au cours de l'année
de référence et pas d'effectif au 31/12). Cette tranche
peut contenir quelques effectifs inconnus \n - 00 :
0 salarié (n'ayant pas d'effectif au 31/12 mais ayant
employé des salariés au cours de l'année de référence)
\n - 01 : 1 ou 2 salariés \n - 02 : 3 à 5 salariés \n
- 03 : 6 à 9 salariés \n - 11 : 10 à 19 salariés \n
- 12 : 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999 salariés
\n - 42 : 1 000 à 1 999 salariés \n - 51 : 2 000 à 4
999 salariés \n - 52 : 5 000 à 9 999 salariés \n - 53
: 10 000 salariés et plus \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#trancheeffectifsetablissement.
\n \n L'effectif mensuel exact de l'établissement est
disponible au travers de l'[API Effectifs - URSSAF Caisse
nationale](https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement).
Si votre jeton contient ce droit d'accès, nous vous
recommandons d'utiliser cette API. Ces données étant
protégées, leur cadre d'utilisation est différent de
la tranche effectif fournie par l'Insee, qui elle est
une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si des
données protégées sont présentes dans la payload (ce qui
est le cas lorsque l'unité légale est en statut de diffusion
partielle). Pour une unité légale : \n \n - diffusible :
'true', car toutes les données sont publiques ; \n - partiellement-diffusible
: 'false', une partie des données est protégée et ne doit
pas être diffusée, pour du pré-remplissage de formulaire
public, préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète) :
'false', dans ce cas, les informations obtenues ne doivent
en aucun cas être accessibles au grand public. Ce cas n'étant
plus censé exister, préférer l'API en open data qui masque
automatiquement les données protégées. \n Plus d'informations
sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
enseigne:
title: Enseigne de l'établissement
type: string
nullable: true
description: "L'enseigne est l'appellation désignant l'emplacement
ou le local dans lequel est exercée l'activité. Un établissement
peut posséder une enseigne, plusieurs enseignes ou aucune.
\n \n Cette variable est la concaténation séparée par des
virgules des 3 champs \"renvoyés\" par l'Insee. Plus d'informations
ici: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#enseigne1etablissement-enseigne2etablissement-enseigne3etablissement"
example: Coiff Land, CoiffureLand
unite_legale:
type: object
additionalProperties: false
title: Unité légale de l'établissement
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit
différent du paramètre d'appel. Il s'agit d'une erreur
généralement temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale
est également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant
à une personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale.
Les valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique.
Les valeurs sont à 'null' pour les personnes morales.
Pour les personnes physiques, la raison sociale / dénomination
/ nom de l'entreprise correspond toujours au nom de
famille et au prénom, précédés ou suivis de la mention
"entrepreneur individuel" ou "EI". Pour en savoir plus,
consulter cette page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: Le pseudonyme correspond au nom qu'une
personne utilise pour se désigner dans l'exercice
de son activité, généralement littéraire ou artistique.
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la
vie courante. Ce prénom fait partie de ceux qui
lui ont été donnés à sa naissance et qui sont inscrits
à l'état civil.
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: Nom que la personne physique a choisi
d'utiliser.
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: Caractère féminin ou masculin de la personne
physique. Cette valeur peut ne pas être renseignée
pour une personne physique.
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n
\n - GE : Grande Entreprise \n - ETI : Entreprise de
Taille Intermédiaire \n - PME : Petite ou Moyenne Entreprise
\n \n Celle-ci peut-être 'null' dans certains cas :
quand il s’agit d’une unité légale nouvellement créée,
ou bien d’une unité légale cessée, ou encore d’une unité
légale hors champ du calcul de la catégorie (unité légale
agricole ou ne faisant pas partie du système productif).
\n \n Définition de 'catégorie d'entreprise' par l'Insee
: https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité
légale : \n \n - Diffusible : Toutes les données de
l'unité légale sont diffusibles, donc publiques. \n
- Partiellement diffusible : Seule une partie des données
est diffusible, suite à une demande de l'entité qui
a exercé sont droit d'opposition à la diffusion de données
personnelles. \n - Non-diffusible (obsolète) : Ce statut
correspond à l'ancien statut, toutes les entités ayant
exercé leur droit d'opposition sont normalement désormais
en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement
publiques et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si
des données protégées sont présentes dans la payload
(ce qui est le cas lorsque l'unité légale est en statut
de diffusion partielle). Pour une unité légale : \n
\n - diffusible : 'true', car toutes les données sont
publiques ; \n - partiellement-diffusible : 'false',
une partie des données est protégée et ne doit pas être
diffusée, pour du pré-remplissage de formulaire public,
préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète)
: 'false', dans ce cas, les informations obtenues ne
doivent en aucun cas être accessibles au grand public.
Ce cas n'étant plus censé exister, préférer l'API en
open data qui masque automatiquement les données protégées.
\n Plus d'informations sur les conditions de diffusion
: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier
niveau de classement contient 9 grandes catégories
identifiables avec le premier chiffre du code :
\n \n - 0 : Organisme de placement collectif en
valeurs mobilières sans personnalité morale \n -
1 : Entrepreneur individuel. La catégorie juridique
des personnes physiques est '1000'. \n - 2 : Groupement
de droit privé non doté de la personnalité morale
\n - 3 : Personne morale de droit étranger \n -
4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 :
Autre personne morale immatriculée au RCS \n - 7
: Personne morale et organisme soumis au droit administratif
\n - 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des
codes fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique
de l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au
code juridique. Si le code ne correspond à aucun
libellé la valeur 'non référencé' est utilisée.
\n \n Nomenclature exhaustive fournie par l'Insee
: https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce
code de 4 chiffres + 1 lettre est extrait de la
nomenclature d'activité française (NAF) de l'Insee.
Si le code n'est pas renseigné dans la nomenclature
'Naf Rév2' (nomenclature en vigueur), le code est
null ici. \n \n À noter qu'une entreprise n'ayant
pas encore de code APE peut se voir affecter la
valeur '00.00Z' de manière provisoire. \n \n Plus
d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de
l'Insee : https://www.insee.fr/fr/information/2120875.
\n \n ⚠️ À partir de janvier 2026, le code APE utilisera
la nouvelle nomenclature NAF 2025, tel qu'explicité
dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par
l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en
vigueur), la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents (créés
il y a moins de trois ans). Les délais de récolte et
traitement font que les valeurs indiquées datent de
l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale :
\n \n - NN : Unités non employeuses (pas de salarié
au cours de l'année de référence et pas d'effectif
au 31/12). Cette tranche peut contenir quelques
effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou
2 salariés \n - 02 : 3 à 5 salariés \n - 03 : 6
à 9 salariés \n - 11 : 10 à 19 salariés \n - 12
: 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999
salariés \n - 42 : 1 000 à 1 999 salariés \n - 51
: 2 000 à 4 999 salariés \n - 52 : 5 000 à 9 999
salariés \n - 53 : 10 000 salariés et plus \n \n
Plus d'informations dans la documentation Insee
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel
et annuel, est disponible au travers de l'API Effectifs
- URSSAF Caisse nationale. Si votre jeton contient
ce droit d'accès, nous vous recommandons d'utiliser
cette API. Ces données étant protégées, leur cadre
d'utilisation est différent de la tranche effectif
fournie par l'Insee, qui elle est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif
de l'unité légale qui peut être « active » ou « cessée
» \n \n **Pour les personnes morales**, l'unité légale
est considérée comme juridiquement « cessée » si : \n
- il y a eu dépôt de la déclaration de disparition
de la personne morale ; \n - 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”) ;
\n - elle n'a plus d'établissement en activité. \n \n
**Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n -
l'exploitant de l'unité légale décède ; \n - l'exploitant
dépose une cessation d'activité. \n \n En dehors de
ces cas, l'état administratif de l'unité légale est
toujours « actif ». \n \n Plus d'informations dans la
documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire
(ESS)
description: "Indique si l'unité légale est une ESS :
\n \n - true : l'entreprise est une ESS \n - false :
l'entreprise n'est pas une ESS \n - null : le statut
ESS est inconnu. Cette information est connue pour environ
1 million d'unités légales, autrement, elle est à null.
\n \n Les unités légales de l'ESS adhèrent aux mêmes
principes : \n * poursuivre un but social autre que
le seul partage des bénéfices ; \n * une lucrativité
encadrée (notamment des bénéfices majoritairement consacrés
au maintien et au développement de l’activité) ; \n
* une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date
qui figure dans les statuts de l'entreprise qui sont
déposés au centre de formalité des entreprises (CFE)
compétent. Cette valeur est renvoyée sous format timestamp.
\n \n Pour certains établissements très anciens, tous
fermés et dont l’unité légale est cessée la date de
création peut être nulle. \n Pour les unités purgées,
la date de création n'est jamais à 'null'. Si elle est
non renseignée, elle sera au 01/01/1900. \n \n Plus
d'informations dans la documentation Insee de l'API
Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
activite_principale_naf_rev2:
title: Attributs de l'activité principale en nomenclature
NAFRev2
type: object
additionalProperties: false
description: Ce champ permet de retrouver le code APE
dans l'ancienne nomenclature NAFRev2 pour assurer la
rétro-compatibilité.
properties:
code:
title: Code de l'activité principale (APE) en NAFRev2
type: string
example: 8411Z
nullable: true
libelle:
title: Libellé associé au code APE NAFRev2
type: string
nullable: false
example: Administration publique générale
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
required:
- code
- libelle
- nomenclature
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
- activite_principale_naf_rev2
adresse:
type: object
additionalProperties: false
title: Adresse de l'établissement
properties:
numero_voie:
title: Numéro dans la voie
type: string
example: '22'
indice_repetition_voie:
title: Indice de répétition du numéro dans la voie
description: 'Plus d''informations dans la documentation
Insee de l''API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#indicerepetitionetablissement'
type: string
nullable: true
enum:
- bis
- ter
- quarter
- quinquies
-
type_voie:
title: Type de la voie de localisation
example: RUE
description: "Le type de la voie de localisation est indiquée
en abrégé et en majuscules. L'information n'est pas
toujours renseignée. Pour certaines petites communes,
l'information n'existe pas. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#typevoieetablissement"
type: string
nullable: true
enum:
- ALLÉE
- AVENUE
- BOULEVARD
- CARREFOUR
- CHEMIN
- CHAUSSÉE
- CITÉ
- CORNICHE
- COURS
- DOMAINE
- DESCENTE
- ECART
- ESPLANADE
- FAUBOURG
- GRANDE RUE
- HAMEAU
- HALLE
- IMPASSE
- LIEU-DIT
- LOTISSEMENT
- MARCHÉ
- MONTÉE
- PASSAGE
- PLACE
- PLAINE
- PLATEAU
- PROMENADE
- PARVIS
- QUARTIER
- QUAI
- RÉSIDENCE
- RUELLE
- ROCADE
- ROND-POINT
- ROUTE
- RUE
- SENTIER
- SQUARE
- TERRE-PLEIN
- TRAVERSE
- VILLA
- VILLAGE
-
libelle_voie:
title: Libellé de la voie
type: string
example: DE LA PAIX
complement_adresse:
title: Complément d'adresse
type: string
description: Le complément d'adresse correspond à des
éléments situés à l'extérieur du bâtiment qui permettent
de compléter l'adresse (résidence, bâtiment, entrée,
etc..)
example: ZAE SAINT GUENAULT
nullable: true
code_commune:
title: Code commune
description: "Le code commune désigne le code de la commune
de localisation de l'établissement. Le code renvoyé
correspond à la date de l'appel, ce qui implique que
toute modification du code commune est repercutée sur
l'ensemble des établissements concernés, y compris ceux
qui sont fermés. Cette valeur est à 'null' pour les
entreprises à l'étranger. \n \n Les codes sont listés
dans la table d'appartenance géographique fournie par
l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028"
type: string
example: '75112'
nullable: true
code_postal:
title: Code postal
example: '75016'
type: string
nullable: true
distribution_speciale:
title: Distribution spéciale
type: string
nullable: true
description: "La distribution spéciale reprend les éléments
particuliers qui accompagnent une adresse de distribution
spéciale, la modalité la plus connue étant les adresses
en 'CEDEX'. \n \n L'Insee ne gère plus cette variable
: elle est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#distributionspecialeetablissement"
code_cedex:
title: Code cedex
type: string
nullable: true
description: "L'Insee ne gère plus cette variable : elle
est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#codecedexetablissement
\n \n Sur le sigle CEDEX lui-même : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle"
libelle_cedex:
title: Libellé du code cedex
type: string
nullable: true
description: "Ce champ indique le libellé correspondant
au code cedex de l'établissement. Si le code cedex est
à 'null', ce champ est également à 'null'. \n \n L'Insee
ne gère plus cette variable : elle est désormais toujours
à 'null'. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#libellecedexetablissement"
libelle_commune:
title: Nom de la commune pour une adresse en France
description: Cette valeur est à 'null' pour les établissements
à l'étranger.
type: string
example: PARIS 12
nullable: true
libelle_commune_etranger:
title: Nom de la commune pour une adresse à l'étranger.
description: Cette valeur est à 'null' pour les établissements
en France.
type: string
nullable: true
code_pays_etranger:
title: Code du pays pour les établissements situés à l'étranger
description: 'La nomenclature des codes pays se trouve
ici : https://www.insee.fr/fr/information/2028273'
type: string
example: '99132'
nullable: true
libelle_pays_etranger:
title: Nom du pays pour les établissements situés à l'étranger
type: string
nullable: true
example: ROYAUME-UNI
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement
diffusible : Seule une partie des données est diffusible,
suite à une demande de l'entité qui a exercé sont droit
d'opposition à la diffusion de données personnelles.
\n - Non-diffusible (obsolète) : Ce statut correspond
à l'ancien statut, toutes les entités ayant exercé leur
droit d'opposition sont normalement désormais en statut
\"partiellement diffusible\"."
acheminement_postal:
type: object
additionalProperties: false
title: Éléments constitutifs de l'adresse postale pour
son acheminement.
description: Il ne s'agit pas d'un traitement RNVP mais
simplement d'une réorganisation des éléments renvoyé
par l'Insee pour faciliter l'affichage des adresses
postales
properties:
l1:
title: Ligne 1
type: string
description: 'Si l''établissement correspond à une
personne morale : la dénomination sociale de la
personne morale. Le cas contraire: cette variable
est vide.'
nullable: true
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
l2:
title: Ligne 2
type: string
description: 'Si l''établissement correspond à une
personne physique : concaténation du nom et prénom'
nullable: true
example: JEAN MARIE DURAND
l3:
title: Ligne 3
type: string
description: Complément d'adresse comme décrit dans
la clé `complement_adresse`
nullable: true
example: ZAE SAINT GUENAULT
l4:
title: Ligne 4
type: string
description: Concaténation du numéro de voie, d'indice
de répétition, du type de voie et du libellé de
la voie
nullable: true
example: 51 BIS RUE DE LA PAIX
l5:
title: Ligne 5
type: string
description: 'Distribution spéciale comme décrit dans
la clé `distribution_speciale`, que l''Insee ne
gère plus : cette ligne est désormais toujours vide.'
nullable: true
l6:
title: Ligne 6
type: string
description: "Si le pays est en France : code postal
accompagné du libellé de la commune, sinon : libellé
de la commune de l'établissement situé à l'étranger.
\n \n Le code cedex, qui primait sur le code postal,
ne sort plus de cette ligne : l'Insee ne gère plus
cette variable."
nullable: true
example: 75012 PARIS
l7:
title: Ligne 7
type: string
description: Pays de l'établissement
nullable: true
example: FRANCE
required:
- l1
- l2
- l3
- l4
- l5
- l6
- l7
required:
- numero_voie
- indice_repetition_voie
- type_voie
- libelle_voie
- complement_adresse
- code_commune
- code_postal
- distribution_speciale
- code_cedex
- libelle_cedex
- libelle_commune
- libelle_commune_etranger
- code_pays_etranger
- libelle_pays_etranger
- status_diffusion
- acheminement_postal
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
activite_principale_naf_rev2:
title: Attributs de l'activité principale en nomenclature
NAFRev2
type: object
additionalProperties: false
description: Ce champ permet de retrouver le code APE dans
l'ancienne nomenclature NAFRev2 pour assurer la rétro-compatibilité.
properties:
code:
title: Code de l'activité principale (APE) en NAFRev2
type: string
example: 8411Z
nullable: true
libelle:
title: Libellé associé au code APE NAFRev2
type: string
nullable: false
example: Administration publique générale
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
required:
- code
- libelle
- nomenclature
required:
- siret
- siege_social
- etat_administratif
- date_fermeture
- activite_principale
- tranche_effectif_salarie
- status_diffusion
- diffusable_commercialement
- enseigne
- unite_legale
- adresse
- date_creation
- activite_principale_naf_rev2
additionalProperties: false
links:
type: object
properties:
unite_legale:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/unites_legales/130025265
description: Lien vers la ressource 'Donnée Sirene d'une unité
légale' correspondant à cette adresse d'établissement pour
obtenir les données de référence de l'unité légale.
required:
- unite_legale
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siret:
type: string
title: Siret d'origine de la requête
description: "Si la requête a été effectuée sur un siret qui
a été redirigé vers un autre siret , cette variable contient
le siret d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siret est différent du
paramètre d'appel, et cette variable est le siret d'entrée.
\n \n A noter que le siret de redirection est systématiquement
le siret du siège social de l'unité légale : en effet la
base Sirene ne possède pas la correspondance exacte entre
un siret doublon et le siret d'origine. "
example: '30613890000010'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siret
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'451':
description: |-
Indisponible pour des raisons légales
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements#erreurs.
content:
application/json:
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/insee/sirene/etablissements/13002526500013?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/insee/sirene/etablissements/diffusibles/{siret}":
get:
summary: Données établissement en open data
tags:
- Informations générales
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
deprecated: true
security:
- jwt_bearer_token: []
description: Informations générales publiques concernant un établissement inscrit
au répertoire Sirene.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles_v3#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles_v3#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles_v3#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: EtablissementDiffusable trouvé
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_insee_etablissements_diffusables
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siret:
title: Siret de l'établissement
type: string
example: '30613890001294'
description: Il peut arriver que le siret renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
siege_social:
type: boolean
example: true
enum:
- true
- false
description: Indique si l'établissement est le siège social
de l'entreprise.
etat_administratif:
title: État administratif de l'établissement
type: string
example: A
enum:
- A
- F
description: "Cette valeur décrit l'état administratif de
l'établissement, qui peut être : \n \n - actif. Sauf exception,
lors de son inscription au répertoire, tout établissement
est à l'état 'actif'\n\n - fermé. Cet état découle de la
prise en compte d'une déclaration de fermeture. Un établissement
fermé peut être rouvert. \n \n Plus d'informations dans
la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#etatadministratifetablissement"
date_fermeture:
title: Date de fermeture de l'établissement
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'établissement
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'un
établissement n'ayant pas encore de code APE peut se
voir affecter la valeur '00.00Z' de manière provisoire.
\n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'établissement
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
title: Code effectif
type: string
nullable: true
example: '51'
description: "Le code effectif correspond à la tranche
d'effectif salarié de l'établissement : \n \n - NN :
Unités non employeuses (pas de salarié au cours de l'année
de référence et pas d'effectif au 31/12). Cette tranche
peut contenir quelques effectifs inconnus \n - 00 :
0 salarié (n'ayant pas d'effectif au 31/12 mais ayant
employé des salariés au cours de l'année de référence)
\n - 01 : 1 ou 2 salariés \n - 02 : 3 à 5 salariés \n
- 03 : 6 à 9 salariés \n - 11 : 10 à 19 salariés \n
- 12 : 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999 salariés
\n - 42 : 1 000 à 1 999 salariés \n - 51 : 2 000 à 4
999 salariés \n - 52 : 5 000 à 9 999 salariés \n - 53
: 10 000 salariés et plus \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#trancheeffectifsetablissement.
\n \n L'effectif mensuel exact de l'établissement est
disponible au travers de l'[API Effectifs - URSSAF Caisse
nationale](https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement).
Si votre jeton contient ce droit d'accès, nous vous
recommandons d'utiliser cette API. Ces données étant
protégées, leur cadre d'utilisation est différent de
la tranche effectif fournie par l'Insee, qui elle est
une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si des
données protégées sont présentes dans la payload (ce qui
est le cas lorsque l'unité légale est en statut de diffusion
partielle). Pour une unité légale : \n \n - diffusible :
'true', car toutes les données sont publiques ; \n - partiellement-diffusible
: 'false', une partie des données est protégée et ne doit
pas être diffusée, pour du pré-remplissage de formulaire
public, préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète) :
'false', dans ce cas, les informations obtenues ne doivent
en aucun cas être accessibles au grand public. Ce cas n'étant
plus censé exister, préférer l'API en open data qui masque
automatiquement les données protégées. \n Plus d'informations
sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
enseigne:
title: Enseigne de l'établissement
type: string
nullable: true
description: "L'enseigne est l'appellation désignant l'emplacement
ou le local dans lequel est exercée l'activité. Un établissement
peut posséder une enseigne, plusieurs enseignes ou aucune.
\n \n Cette variable est la concaténation séparée par des
virgules des 3 champs \"renvoyés\" par l'Insee. Plus d'informations
ici: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#enseigne1etablissement-enseigne2etablissement-enseigne3etablissement
\n Si la personne morale est en diffusion partielle, l'enseigne
n'est pas renvoyée, et la valeur est remplacée par \"[ND]\"."
example: Coiff Land, CoiffureLand
unite_legale:
type: object
additionalProperties: false
title: Unité légale de l'établissement
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit
différent du paramètre d'appel. Il s'agit d'une erreur
généralement temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale
est également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant
à une personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale.
Les valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
description: Si la personne morale est en diffusion
partielle, le sigle n'est pas renvoyé, et la valeur
est remplacée par "[ND]".
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique.
Les valeurs sont à 'null' pour les personnes morales.
Pour les personnes physiques, la raison sociale / dénomination
/ nom de l'entreprise correspond toujours au nom de
famille et au prénom, précédés ou suivis de la mention
"entrepreneur individuel" ou "EI". Pour en savoir plus,
consulter cette page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: "Le pseudonyme correspond au nom qu'une
personne utilise pour se désigner dans l'exercice
de son activité, généralement littéraire ou artistique.
\n Si la personne physique est en diffusion partielle,
le pseudonyme n'est pas renvoyé et la valeur est
remplacée par \"[ND]\"."
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: "Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la
vie courante. Ce prénom fait partie de ceux qui
lui ont été donnés à sa naissance et qui sont inscrits
à l'état civil. \n Si la personne physique est en
diffusion partielle, le prénom usuel n'est pas renvoyé
et la valeur est remplacée par \"[ND]\"."
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: "Nom que la personne physique a choisi
d'utiliser. \n Si la personne physique est en diffusion
partielle, le nom d'usage n'est pas renvoyé et la
valeur est remplacée par \"[ND]\"."
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
description: Si la personne physique est en diffusion
partielle, le nom de naissance n'est pas renvoyé
et la valeur est remplacée par "[ND]".
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: "Caractère féminin ou masculin de la
personne physique. Cette valeur peut ne pas être
renseignée pour une personne physique. \n Si la
personne physique est en diffusion partielle, la
valeur est remplacée par \"[ND]\"."
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n
\n - GE : Grande Entreprise \n - ETI : Entreprise de
Taille Intermédiaire \n - PME : Petite ou Moyenne Entreprise
\n \n Celle-ci peut-être 'null' dans certains cas :
quand il s’agit d’une unité légale nouvellement créée,
ou bien d’une unité légale cessée, ou encore d’une unité
légale hors champ du calcul de la catégorie (unité légale
agricole ou ne faisant pas partie du système productif).
\n \n Définition de 'catégorie d'entreprise' par l'Insee
: https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité
légale : \n \n - Diffusible : Toutes les données de
l'unité légale sont diffusibles, donc publiques. \n
- Partiellement diffusible : Seule une partie des données
est diffusible, suite à une demande de l'entité qui
a exercé sont droit d'opposition à la diffusion de données
personnelles. \n - Non-diffusible (obsolète) : Ce statut
correspond à l'ancien statut, toutes les entités ayant
exercé leur droit d'opposition sont normalement désormais
en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement
publiques et donc diffusables
type: boolean
example: true
description: "Ce champ est a priori toujours à 'true'
car cette API ne renvoie que de l'open data. Pour une
unité légale : \n \n - diffusible : 'true', car toutes
les données sont publiques ; \n - partiellement-diffusible
: 'true'. Dans ce cas, les informations protégées suite
au droit d'opposition sont masquées par la chaîne de
caractère '[ND]' ; \n Plus d'informations sur les conditions
de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier
niveau de classement contient 9 grandes catégories
identifiables avec le premier chiffre du code :
\n \n - 0 : Organisme de placement collectif en
valeurs mobilières sans personnalité morale \n -
1 : Entrepreneur individuel. La catégorie juridique
des personnes physiques est '1000'. \n - 2 : Groupement
de droit privé non doté de la personnalité morale
\n - 3 : Personne morale de droit étranger \n -
4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 :
Autre personne morale immatriculée au RCS \n - 7
: Personne morale et organisme soumis au droit administratif
\n - 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des
codes fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique
de l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au
code juridique. Si le code ne correspond à aucun
libellé la valeur 'non référencé' est utilisée.
\n \n Nomenclature exhaustive fournie par l'Insee
: https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce
code de 4 chiffres + 1 lettre est extrait de la
nomenclature d'activité française (NAF) de l'Insee.
Si le code n'est pas renseigné dans la nomenclature
'Naf Rév2' (nomenclature en vigueur), le code est
null ici. \n \n À noter qu'une entreprise n'ayant
pas encore de code APE peut se voir affecter la
valeur '00.00Z' de manière provisoire. \n \n Plus
d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de
l'Insee : https://www.insee.fr/fr/information/2120875.
\n \n ⚠️ À partir de janvier 2026, le code APE utilisera
la nouvelle nomenclature NAF 2025, tel qu'explicité
dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par
l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en
vigueur), la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents (créés
il y a moins de trois ans). Les délais de récolte et
traitement font que les valeurs indiquées datent de
l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale :
\n \n - NN : Unités non employeuses (pas de salarié
au cours de l'année de référence et pas d'effectif
au 31/12). Cette tranche peut contenir quelques
effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou
2 salariés \n - 02 : 3 à 5 salariés \n - 03 : 6
à 9 salariés \n - 11 : 10 à 19 salariés \n - 12
: 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999
salariés \n - 42 : 1 000 à 1 999 salariés \n - 51
: 2 000 à 4 999 salariés \n - 52 : 5 000 à 9 999
salariés \n - 53 : 10 000 salariés et plus \n \n
Plus d'informations dans la documentation Insee
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel
et annuel, est disponible au travers de l'API Effectifs
- URSSAF Caisse nationale. Si votre jeton contient
ce droit d'accès, nous vous recommandons d'utiliser
cette API. Ces données étant protégées, leur cadre
d'utilisation est différent de la tranche effectif
fournie par l'Insee, qui elle est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif
de l'unité légale qui peut être « active » ou « cessée
» \n \n **Pour les personnes morales**, l'unité légale
est considérée comme juridiquement « cessée » si : \n
- il y a eu dépôt de la déclaration de disparition
de la personne morale ; \n - 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”) ;
\n - elle n'a plus d'établissement en activité. \n \n
**Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n -
l'exploitant de l'unité légale décède ; \n - l'exploitant
dépose une cessation d'activité. \n \n En dehors de
ces cas, l'état administratif de l'unité légale est
toujours « actif ». \n \n Plus d'informations dans la
documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire
(ESS)
description: "Indique si l'unité légale est une ESS :
\n \n - true : l'entreprise est une ESS \n - false :
l'entreprise n'est pas une ESS \n - null : le statut
ESS est inconnu. Cette information est connue pour environ
1 million d'unités légales, autrement, elle est à null.
\n \n Les unités légales de l'ESS adhèrent aux mêmes
principes : \n * poursuivre un but social autre que
le seul partage des bénéfices ; \n * une lucrativité
encadrée (notamment des bénéfices majoritairement consacrés
au maintien et au développement de l’activité) ; \n
* une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date
qui figure dans les statuts de l'entreprise qui sont
déposés au centre de formalité des entreprises (CFE)
compétent. Cette valeur est renvoyée sous format timestamp.
\n \n Pour certains établissements très anciens, tous
fermés et dont l’unité légale est cessée la date de
création peut être nulle. \n Pour les unités purgées,
la date de création n'est jamais à 'null'. Si elle est
non renseignée, elle sera au 01/01/1900. \n \n Plus
d'informations dans la documentation Insee de l'API
Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
adresse:
type: object
additionalProperties: false
title: Adresse de l'établissement
properties:
numero_voie:
title: Numéro dans la voie
type: string
example: '22'
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
indice_repetition_voie:
title: Indice de répétition du numéro dans la voie
description: "Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#indicerepetitionetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
type: string
nullable: true
enum:
- bis
- ter
- quarter
- quinquies
-
type_voie:
title: Type de la voie de localisation
example: RUE
description: "Le type de la voie de localisation est indiquée
en abrégé et en majuscules. L'information n'est pas
toujours renseignée. Pour certaines petites communes,
l'information n'existe pas. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#typevoieetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
type: string
nullable: true
enum:
- ALLÉE
- AVENUE
- BOULEVARD
- CARREFOUR
- CHEMIN
- CHAUSSÉE
- CITÉ
- CORNICHE
- COURS
- DOMAINE
- DESCENTE
- ECART
- ESPLANADE
- FAUBOURG
- GRANDE RUE
- HAMEAU
- HALLE
- IMPASSE
- LIEU-DIT
- LOTISSEMENT
- MARCHÉ
- MONTÉE
- PASSAGE
- PLACE
- PLAINE
- PLATEAU
- PROMENADE
- PARVIS
- QUARTIER
- QUAI
- RÉSIDENCE
- RUELLE
- ROCADE
- ROND-POINT
- ROUTE
- RUE
- SENTIER
- SQUARE
- TERRE-PLEIN
- TRAVERSE
- VILLA
- VILLAGE
-
libelle_voie:
title: Libellé de la voie
type: string
example: DE LA PAIX
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
complement_adresse:
title: Complément d'adresse
type: string
description: "Le complément d'adresse correspond à des
éléments situés à l'extérieur du bâtiment qui permettent
de compléter l'adresse (résidence, bâtiment, entrée,
etc..) \n Si la personne morale est en diffusion partielle,
le complément d'adresse n'est pas renvoyé, et la valeur
est remplacée par \"[ND]\"."
example: ZAE SAINT GUENAULT
nullable: true
code_commune:
title: Code commune
description: "Le code commune désigne le code de la commune
de localisation de l'établissement. Le code renvoyé
correspond à la date de l'appel, ce qui implique que
toute modification du code commune est repercutée sur
l'ensemble des établissements concernés, y compris ceux
qui sont fermés. Cette valeur est à 'null' pour les
entreprises à l'étranger. \n \n Les codes sont listés
dans la table d'appartenance géographique fournie par
l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028"
type: string
example: '75112'
nullable: true
code_postal:
title: Code postal
example: '75016'
type: string
nullable: true
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
distribution_speciale:
title: Distribution spéciale
type: string
nullable: true
description: "La distribution spéciale reprend les éléments
particuliers qui accompagnent une adresse de distribution
\ spéciale, la modalité la plus connue étant les adresses
en 'CEDEX'. \n \n L'Insee ne gère plus cette variable
: elle est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#distributionspecialeetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
code_cedex:
title: Code cedex
type: string
nullable: true
description: "L'Insee ne gère plus cette variable : elle
est désormais toujours à 'null'. \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#codecedexetablissement
\n Sur le sigle CEDEX lui-même : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
libelle_cedex:
title: Libellé du code cedex
type: string
nullable: true
description: "Ce champ indique le libellé correspondant
au code cedex de l'établissement. Si le code cedex est
à 'null', ce champ est également à 'null'. \n L'Insee
ne gère plus cette variable : elle est désormais toujours
à 'null'. \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#libellecedexetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
libelle_commune:
title: Nom de la commune pour une adresse en France
description: Cette valeur est à 'null' pour les établissements
à l'étranger.
type: string
example: PARIS 12
nullable: true
libelle_commune_etranger:
title: Nom de la commune pour une adresse à l'étranger.
description: Cette valeur est à 'null' pour les établissements
en France.
type: string
nullable: true
code_pays_etranger:
title: Code du pays pour les établissements situés à l'étranger
description: 'La nomenclature des codes pays se trouve
ici : https://www.insee.fr/fr/information/2028273'
type: string
example: '99132'
nullable: true
libelle_pays_etranger:
title: Nom du pays pour les établissements situés à l'étranger
type: string
nullable: true
example: ROYAUME-UNI
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement
diffusible : Seule une partie des données est diffusible,
suite à une demande de l'entité qui a exercé sont droit
d'opposition à la diffusion de données personnelles.
\n - Non-diffusible (obsolète) : Ce statut correspond
à l'ancien statut, toutes les entités ayant exercé leur
droit d'opposition sont normalement désormais en statut
\"partiellement diffusible\"."
acheminement_postal:
type: object
additionalProperties: false
title: Éléments constitutifs de l'adresse postale pour
son acheminement.
description: Il ne s'agit pas d'un traitement RNVP mais
simplement d'une réorganisation des éléments renvoyé
par l'Insee pour faciliter l'affichage des adresses
postales
properties:
l1:
title: Ligne 1
type: string
description: "Si l'établissement correspond à une
personne morale : la dénomination sociale de la
personne morale. Le cas contraire: cette variable
est vide. \n Si la personne morale est en diffusion
partielle, la valeur est remplacée par \"[ND]\"."
nullable: true
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
l2:
title: Ligne 2
type: string
description: "Si l'établissement correspond à une
personne physique : concaténation du nom et prénom
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
example: JEAN MARIE DURAND
l3:
title: Ligne 3
type: string
description: "Si l'établissement correspond à une
personne physique : concaténation du nom et prénom
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
example: ZAE SAINT GUENAULT
l4:
title: Ligne 4
type: string
description: "Concaténation du numéro de voie, d'indice
de répétition, du type de voie et du libellé de
la voie \n Si la personne morale est en diffusion
partielle, la valeur est remplacée par \"[ND]\"."
nullable: true
example: 51 BIS RUE DE LA PAIX
l5:
title: Ligne 5
type: string
description: "Distribution spéciale comme décrit dans
la clé `distribution_speciale`, que l'Insee ne gère
plus : cette ligne est désormais toujours vide.
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
l6:
title: Ligne 6
type: string
description: "Si le pays est en France : code postal
accompagné du libellé de la commune, sinon : libellé
de la commune de l'établissement situé à l'étranger.
\n Le code cedex, qui primait sur le code postal,
ne sort plus de cette ligne : l'Insee ne gère plus
cette variable. \n Si la personne morale est en
diffusion partielle, la valeur est remplacée par
\"[ND]\"."
nullable: true
example: 75012 PARIS
l7:
title: Ligne 7
type: string
description: Pays de l'établissement
nullable: true
example: FRANCE
required:
- l1
- l2
- l3
- l4
- l5
- l6
- l7
required:
- numero_voie
- indice_repetition_voie
- type_voie
- libelle_voie
- complement_adresse
- code_commune
- code_postal
- distribution_speciale
- code_cedex
- libelle_cedex
- libelle_commune
- libelle_commune_etranger
- code_pays_etranger
- libelle_pays_etranger
- status_diffusion
- acheminement_postal
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
required:
- siret
- siege_social
- etat_administratif
- date_fermeture
- activite_principale
- tranche_effectif_salarie
- status_diffusion
- diffusable_commercialement
- enseigne
- unite_legale
- adresse
- date_creation
additionalProperties: false
links:
type: object
properties:
unite_legale:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/unites_legales/130025265
description: Lien vers la ressource 'Donnée Sirene d'une unité
légale' correspondant à cette adresse d'établissement pour
obtenir les données de référence de l'unité légale.
required:
- unite_legale
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siret:
type: string
title: Siret d'origine de la requête
description: "Si la requête a été effectuée sur un siret qui
a été redirigé vers un autre siret , cette variable contient
le siret d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siret est différent du
paramètre d'appel, et cette variable est le siret d'entrée.
\n \n A noter que le siret de redirection est systématiquement
le siret du siège social de l'unité légale : en effet la
base Sirene ne possède pas la correspondance exacte entre
un siret doublon et le siret d'origine. "
example: '30613890000010'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siret
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles_v3#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles_v3#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles_v3#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles_v3#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles_v3#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles_v3#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles_v3#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
'451':
description: |-
Indisponible pour des raisons légales
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles_v3#erreurs.
content:
application/json:
examples:
error_01005:
value:
errors:
- code: '01005'
title: Indisponible pour des raisons légales
detail: Cette entité n'est accessible par aucun organisme.
source:
meta:
provider: INSEE
summary: Indisponible pour des raisons légales
description: Cette entité n'est accessible par aucun organisme.
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/insee/sirene/etablissements/diffusibles/13002526500013?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/insee/sirene/etablissements/diffusibles/{siret}":
get:
summary: Données établissement en open data
tags:
- Informations générales
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Informations générales publiques concernant un établissement inscrit
au répertoire Sirene. Cette version utilise la nomenclature NAF2025 pour l'activité
principale.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: EtablissementDiffusable trouve
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_insee_etablissements_diffusables
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siret:
title: Siret de l'établissement
type: string
example: '30613890001294'
description: Il peut arriver que le siret renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
siege_social:
type: boolean
example: true
enum:
- true
- false
description: Indique si l'établissement est le siège social
de l'entreprise.
etat_administratif:
title: État administratif de l'établissement
type: string
example: A
enum:
- A
- F
description: "Cette valeur décrit l'état administratif de
l'établissement, qui peut être : \n \n - actif. Sauf exception,
lors de son inscription au répertoire, tout établissement
est à l'état 'actif'\n\n - fermé. Cet état découle de la
prise en compte d'une déclaration de fermeture. Un établissement
fermé peut être rouvert. \n \n Plus d'informations dans
la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#etatadministratifetablissement"
date_fermeture:
title: Date de fermeture de l'établissement
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'établissement
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'un
établissement n'ayant pas encore de code APE peut se
voir affecter la valeur '00.00Z' de manière provisoire.
\n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'établissement
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
title: Code effectif
type: string
nullable: true
example: '51'
description: "Le code effectif correspond à la tranche
d'effectif salarié de l'établissement : \n \n - NN :
Unités non employeuses (pas de salarié au cours de l'année
de référence et pas d'effectif au 31/12). Cette tranche
peut contenir quelques effectifs inconnus \n - 00 :
0 salarié (n'ayant pas d'effectif au 31/12 mais ayant
employé des salariés au cours de l'année de référence)
\n - 01 : 1 ou 2 salariés \n - 02 : 3 à 5 salariés \n
- 03 : 6 à 9 salariés \n - 11 : 10 à 19 salariés \n
- 12 : 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999 salariés
\n - 42 : 1 000 à 1 999 salariés \n - 51 : 2 000 à 4
999 salariés \n - 52 : 5 000 à 9 999 salariés \n - 53
: 10 000 salariés et plus \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#trancheeffectifsetablissement.
\n \n L'effectif mensuel exact de l'établissement est
disponible au travers de l'[API Effectifs - URSSAF Caisse
nationale](https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement).
Si votre jeton contient ce droit d'accès, nous vous
recommandons d'utiliser cette API. Ces données étant
protégées, leur cadre d'utilisation est différent de
la tranche effectif fournie par l'Insee, qui elle est
une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si des
données protégées sont présentes dans la payload (ce qui
est le cas lorsque l'unité légale est en statut de diffusion
partielle). Pour une unité légale : \n \n - diffusible :
'true', car toutes les données sont publiques ; \n - partiellement-diffusible
: 'false', une partie des données est protégée et ne doit
pas être diffusée, pour du pré-remplissage de formulaire
public, préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète) :
'false', dans ce cas, les informations obtenues ne doivent
en aucun cas être accessibles au grand public. Ce cas n'étant
plus censé exister, préférer l'API en open data qui masque
automatiquement les données protégées. \n Plus d'informations
sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
enseigne:
title: Enseigne de l'établissement
type: string
nullable: true
description: "L'enseigne est l'appellation désignant l'emplacement
ou le local dans lequel est exercée l'activité. Un établissement
peut posséder une enseigne, plusieurs enseignes ou aucune.
\n \n Cette variable est la concaténation séparée par des
virgules des 3 champs \"renvoyés\" par l'Insee. Plus d'informations
ici: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#enseigne1etablissement-enseigne2etablissement-enseigne3etablissement
\n Si la personne morale est en diffusion partielle, l'enseigne
n'est pas renvoyée, et la valeur est remplacée par \"[ND]\"."
example: Coiff Land, CoiffureLand
unite_legale:
type: object
additionalProperties: false
title: Unité légale de l'établissement
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit
différent du paramètre d'appel. Il s'agit d'une erreur
généralement temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale
est également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant
à une personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale.
Les valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
description: Si la personne morale est en diffusion
partielle, le sigle n'est pas renvoyé, et la valeur
est remplacée par "[ND]".
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique.
Les valeurs sont à 'null' pour les personnes morales.
Pour les personnes physiques, la raison sociale / dénomination
/ nom de l'entreprise correspond toujours au nom de
famille et au prénom, précédés ou suivis de la mention
"entrepreneur individuel" ou "EI". Pour en savoir plus,
consulter cette page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: "Le pseudonyme correspond au nom qu'une
personne utilise pour se désigner dans l'exercice
de son activité, généralement littéraire ou artistique.
\n Si la personne physique est en diffusion partielle,
le pseudonyme n'est pas renvoyé et la valeur est
remplacée par \"[ND]\"."
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: "Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la
vie courante. Ce prénom fait partie de ceux qui
lui ont été donnés à sa naissance et qui sont inscrits
à l'état civil. \n Si la personne physique est en
diffusion partielle, le prénom usuel n'est pas renvoyé
et la valeur est remplacée par \"[ND]\"."
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: "Nom que la personne physique a choisi
d'utiliser. \n Si la personne physique est en diffusion
partielle, le nom d'usage n'est pas renvoyé et la
valeur est remplacée par \"[ND]\"."
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
description: Si la personne physique est en diffusion
partielle, le nom de naissance n'est pas renvoyé
et la valeur est remplacée par "[ND]".
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: "Caractère féminin ou masculin de la
personne physique. Cette valeur peut ne pas être
renseignée pour une personne physique. \n Si la
personne physique est en diffusion partielle, la
valeur est remplacée par \"[ND]\"."
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n
\n - GE : Grande Entreprise \n - ETI : Entreprise de
Taille Intermédiaire \n - PME : Petite ou Moyenne Entreprise
\n \n Celle-ci peut-être 'null' dans certains cas :
quand il s’agit d’une unité légale nouvellement créée,
ou bien d’une unité légale cessée, ou encore d’une unité
légale hors champ du calcul de la catégorie (unité légale
agricole ou ne faisant pas partie du système productif).
\n \n Définition de 'catégorie d'entreprise' par l'Insee
: https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité
légale : \n \n - Diffusible : Toutes les données de
l'unité légale sont diffusibles, donc publiques. \n
- Partiellement diffusible : Seule une partie des données
est diffusible, suite à une demande de l'entité qui
a exercé sont droit d'opposition à la diffusion de données
personnelles. \n - Non-diffusible (obsolète) : Ce statut
correspond à l'ancien statut, toutes les entités ayant
exercé leur droit d'opposition sont normalement désormais
en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement
publiques et donc diffusables
type: boolean
example: true
description: "Ce champ est a priori toujours à 'true'
car cette API ne renvoie que de l'open data. Pour une
unité légale : \n \n - diffusible : 'true', car toutes
les données sont publiques ; \n - partiellement-diffusible
: 'true'. Dans ce cas, les informations protégées suite
au droit d'opposition sont masquées par la chaîne de
caractère '[ND]' ; \n Plus d'informations sur les conditions
de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier
niveau de classement contient 9 grandes catégories
identifiables avec le premier chiffre du code :
\n \n - 0 : Organisme de placement collectif en
valeurs mobilières sans personnalité morale \n -
1 : Entrepreneur individuel. La catégorie juridique
des personnes physiques est '1000'. \n - 2 : Groupement
de droit privé non doté de la personnalité morale
\n - 3 : Personne morale de droit étranger \n -
4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 :
Autre personne morale immatriculée au RCS \n - 7
: Personne morale et organisme soumis au droit administratif
\n - 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des
codes fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique
de l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au
code juridique. Si le code ne correspond à aucun
libellé la valeur 'non référencé' est utilisée.
\n \n Nomenclature exhaustive fournie par l'Insee
: https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce
code de 4 chiffres + 1 lettre est extrait de la
nomenclature d'activité française (NAF) de l'Insee.
Si le code n'est pas renseigné dans la nomenclature
'Naf Rév2' (nomenclature en vigueur), le code est
null ici. \n \n À noter qu'une entreprise n'ayant
pas encore de code APE peut se voir affecter la
valeur '00.00Z' de manière provisoire. \n \n Plus
d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de
l'Insee : https://www.insee.fr/fr/information/2120875.
\n \n ⚠️ À partir de janvier 2026, le code APE utilisera
la nouvelle nomenclature NAF 2025, tel qu'explicité
dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par
l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en
vigueur), la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents (créés
il y a moins de trois ans). Les délais de récolte et
traitement font que les valeurs indiquées datent de
l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale :
\n \n - NN : Unités non employeuses (pas de salarié
au cours de l'année de référence et pas d'effectif
au 31/12). Cette tranche peut contenir quelques
effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou
2 salariés \n - 02 : 3 à 5 salariés \n - 03 : 6
à 9 salariés \n - 11 : 10 à 19 salariés \n - 12
: 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999
salariés \n - 42 : 1 000 à 1 999 salariés \n - 51
: 2 000 à 4 999 salariés \n - 52 : 5 000 à 9 999
salariés \n - 53 : 10 000 salariés et plus \n \n
Plus d'informations dans la documentation Insee
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel
et annuel, est disponible au travers de l'API Effectifs
- URSSAF Caisse nationale. Si votre jeton contient
ce droit d'accès, nous vous recommandons d'utiliser
cette API. Ces données étant protégées, leur cadre
d'utilisation est différent de la tranche effectif
fournie par l'Insee, qui elle est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif
de l'unité légale qui peut être « active » ou « cessée
» \n \n **Pour les personnes morales**, l'unité légale
est considérée comme juridiquement « cessée » si : \n
- il y a eu dépôt de la déclaration de disparition
de la personne morale ; \n - 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”) ;
\n - elle n'a plus d'établissement en activité. \n \n
**Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n -
l'exploitant de l'unité légale décède ; \n - l'exploitant
dépose une cessation d'activité. \n \n En dehors de
ces cas, l'état administratif de l'unité légale est
toujours « actif ». \n \n Plus d'informations dans la
documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire
(ESS)
description: "Indique si l'unité légale est une ESS :
\n \n - true : l'entreprise est une ESS \n - false :
l'entreprise n'est pas une ESS \n - null : le statut
ESS est inconnu. Cette information est connue pour environ
1 million d'unités légales, autrement, elle est à null.
\n \n Les unités légales de l'ESS adhèrent aux mêmes
principes : \n * poursuivre un but social autre que
le seul partage des bénéfices ; \n * une lucrativité
encadrée (notamment des bénéfices majoritairement consacrés
au maintien et au développement de l’activité) ; \n
* une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date
qui figure dans les statuts de l'entreprise qui sont
déposés au centre de formalité des entreprises (CFE)
compétent. Cette valeur est renvoyée sous format timestamp.
\n \n Pour certains établissements très anciens, tous
fermés et dont l’unité légale est cessée la date de
création peut être nulle. \n Pour les unités purgées,
la date de création n'est jamais à 'null'. Si elle est
non renseignée, elle sera au 01/01/1900. \n \n Plus
d'informations dans la documentation Insee de l'API
Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
activite_principale_naf_rev2:
title: Attributs de l'activité principale en nomenclature
NAFRev2
type: object
additionalProperties: false
description: Ce champ permet de retrouver le code APE
dans l'ancienne nomenclature NAFRev2 pour assurer la
rétro-compatibilité.
properties:
code:
title: Code de l'activité principale (APE) en NAFRev2
type: string
example: 8411Z
nullable: true
libelle:
title: Libellé associé au code APE NAFRev2
type: string
nullable: false
example: Administration publique générale
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
required:
- code
- libelle
- nomenclature
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
- activite_principale_naf_rev2
adresse:
type: object
additionalProperties: false
title: Adresse de l'établissement
properties:
numero_voie:
title: Numéro dans la voie
type: string
example: '22'
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
indice_repetition_voie:
title: Indice de répétition du numéro dans la voie
description: "Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#indicerepetitionetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
type: string
nullable: true
enum:
- bis
- ter
- quarter
- quinquies
-
type_voie:
title: Type de la voie de localisation
example: RUE
description: "Le type de la voie de localisation est indiquée
en abrégé et en majuscules. L'information n'est pas
toujours renseignée. Pour certaines petites communes,
l'information n'existe pas. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#typevoieetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
type: string
nullable: true
enum:
- ALLÉE
- AVENUE
- BOULEVARD
- CARREFOUR
- CHEMIN
- CHAUSSÉE
- CITÉ
- CORNICHE
- COURS
- DOMAINE
- DESCENTE
- ECART
- ESPLANADE
- FAUBOURG
- GRANDE RUE
- HAMEAU
- HALLE
- IMPASSE
- LIEU-DIT
- LOTISSEMENT
- MARCHÉ
- MONTÉE
- PASSAGE
- PLACE
- PLAINE
- PLATEAU
- PROMENADE
- PARVIS
- QUARTIER
- QUAI
- RÉSIDENCE
- RUELLE
- ROCADE
- ROND-POINT
- ROUTE
- RUE
- SENTIER
- SQUARE
- TERRE-PLEIN
- TRAVERSE
- VILLA
- VILLAGE
-
libelle_voie:
title: Libellé de la voie
type: string
example: DE LA PAIX
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
complement_adresse:
title: Complément d'adresse
type: string
description: "Le complément d'adresse correspond à des
éléments situés à l'extérieur du bâtiment qui permettent
de compléter l'adresse (résidence, bâtiment, entrée,
etc..) \n Si la personne morale est en diffusion partielle,
le complément d'adresse n'est pas renvoyé, et la valeur
est remplacée par \"[ND]\"."
example: ZAE SAINT GUENAULT
nullable: true
code_commune:
title: Code commune
description: "Le code commune désigne le code de la commune
de localisation de l'établissement. Le code renvoyé
correspond à la date de l'appel, ce qui implique que
toute modification du code commune est repercutée sur
l'ensemble des établissements concernés, y compris ceux
qui sont fermés. Cette valeur est à 'null' pour les
entreprises à l'étranger. \n \n Les codes sont listés
dans la table d'appartenance géographique fournie par
l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028"
type: string
example: '75112'
nullable: true
code_postal:
title: Code postal
example: '75016'
type: string
nullable: true
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
distribution_speciale:
title: Distribution spéciale
type: string
nullable: true
description: "La distribution spéciale reprend les éléments
particuliers qui accompagnent une adresse de distribution
\ spéciale, la modalité la plus connue étant les adresses
en 'CEDEX'. \n \n L'Insee ne gère plus cette variable
: elle est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#distributionspecialeetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
code_cedex:
title: Code cedex
type: string
nullable: true
description: "L'Insee ne gère plus cette variable : elle
est désormais toujours à 'null'. \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#codecedexetablissement
\n Sur le sigle CEDEX lui-même : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
libelle_cedex:
title: Libellé du code cedex
type: string
nullable: true
description: "Ce champ indique le libellé correspondant
au code cedex de l'établissement. Si le code cedex est
à 'null', ce champ est également à 'null'. \n L'Insee
ne gère plus cette variable : elle est désormais toujours
à 'null'. \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#libellecedexetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
libelle_commune:
title: Nom de la commune pour une adresse en France
description: Cette valeur est à 'null' pour les établissements
à l'étranger.
type: string
example: PARIS 12
nullable: true
libelle_commune_etranger:
title: Nom de la commune pour une adresse à l'étranger.
description: Cette valeur est à 'null' pour les établissements
en France.
type: string
nullable: true
code_pays_etranger:
title: Code du pays pour les établissements situés à l'étranger
description: 'La nomenclature des codes pays se trouve
ici : https://www.insee.fr/fr/information/2028273'
type: string
example: '99132'
nullable: true
libelle_pays_etranger:
title: Nom du pays pour les établissements situés à l'étranger
type: string
nullable: true
example: ROYAUME-UNI
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement
diffusible : Seule une partie des données est diffusible,
suite à une demande de l'entité qui a exercé sont droit
d'opposition à la diffusion de données personnelles.
\n - Non-diffusible (obsolète) : Ce statut correspond
à l'ancien statut, toutes les entités ayant exercé leur
droit d'opposition sont normalement désormais en statut
\"partiellement diffusible\"."
acheminement_postal:
type: object
additionalProperties: false
title: Éléments constitutifs de l'adresse postale pour
son acheminement.
description: Il ne s'agit pas d'un traitement RNVP mais
simplement d'une réorganisation des éléments renvoyé
par l'Insee pour faciliter l'affichage des adresses
postales
properties:
l1:
title: Ligne 1
type: string
description: "Si l'établissement correspond à une
personne morale : la dénomination sociale de la
personne morale. Le cas contraire: cette variable
est vide. \n Si la personne morale est en diffusion
partielle, la valeur est remplacée par \"[ND]\"."
nullable: true
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
l2:
title: Ligne 2
type: string
description: "Si l'établissement correspond à une
personne physique : concaténation du nom et prénom
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
example: JEAN MARIE DURAND
l3:
title: Ligne 3
type: string
description: "Si l'établissement correspond à une
personne physique : concaténation du nom et prénom
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
example: ZAE SAINT GUENAULT
l4:
title: Ligne 4
type: string
description: "Concaténation du numéro de voie, d'indice
de répétition, du type de voie et du libellé de
la voie \n Si la personne morale est en diffusion
partielle, la valeur est remplacée par \"[ND]\"."
nullable: true
example: 51 BIS RUE DE LA PAIX
l5:
title: Ligne 5
type: string
description: "Distribution spéciale comme décrit dans
la clé `distribution_speciale`, que l'Insee ne gère
plus : cette ligne est désormais toujours vide.
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
l6:
title: Ligne 6
type: string
description: "Si le pays est en France : code postal
accompagné du libellé de la commune, sinon : libellé
de la commune de l'établissement situé à l'étranger.
\n Le code cedex, qui primait sur le code postal,
ne sort plus de cette ligne : l'Insee ne gère plus
cette variable. \n Si la personne morale est en
diffusion partielle, la valeur est remplacée par
\"[ND]\"."
nullable: true
example: 75012 PARIS
l7:
title: Ligne 7
type: string
description: Pays de l'établissement
nullable: true
example: FRANCE
required:
- l1
- l2
- l3
- l4
- l5
- l6
- l7
required:
- numero_voie
- indice_repetition_voie
- type_voie
- libelle_voie
- complement_adresse
- code_commune
- code_postal
- distribution_speciale
- code_cedex
- libelle_cedex
- libelle_commune
- libelle_commune_etranger
- code_pays_etranger
- libelle_pays_etranger
- status_diffusion
- acheminement_postal
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
activite_principale_naf_rev2:
title: Attributs de l'activité principale en nomenclature
NAFRev2
type: object
additionalProperties: false
description: Ce champ permet de retrouver le code APE dans
l'ancienne nomenclature NAFRev2 pour assurer la rétro-compatibilité.
properties:
code:
title: Code de l'activité principale (APE) en NAFRev2
type: string
example: 8411Z
nullable: true
libelle:
title: Libellé associé au code APE NAFRev2
type: string
nullable: false
example: Administration publique générale
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
required:
- code
- libelle
- nomenclature
required:
- siret
- siege_social
- etat_administratif
- date_fermeture
- activite_principale
- tranche_effectif_salarie
- status_diffusion
- diffusable_commercialement
- enseigne
- unite_legale
- adresse
- date_creation
- activite_principale_naf_rev2
additionalProperties: false
links:
type: object
properties:
unite_legale:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/unites_legales/130025265
description: Lien vers la ressource 'Donnée Sirene d'une unité
légale' correspondant à cette adresse d'établissement pour
obtenir les données de référence de l'unité légale.
required:
- unite_legale
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siret:
type: string
title: Siret d'origine de la requête
description: "Si la requête a été effectuée sur un siret qui
a été redirigé vers un autre siret , cette variable contient
le siret d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siret est différent du
paramètre d'appel, et cette variable est le siret d'entrée.
\n \n A noter que le siret de redirection est systématiquement
le siret du siège social de l'unité légale : en effet la
base Sirene ne possède pas la correspondance exacte entre
un siret doublon et le siret d'origine. "
example: '30613890000010'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siret
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouve
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
'451':
description: |-
Indisponible pour des raisons légales
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_etablissements_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/etablissements_diffusibles#erreurs.
content:
application/json:
examples:
error_01005:
value:
errors:
- code: '01005'
title: Indisponible pour des raisons légales
detail: Cette entité n'est accessible par aucun organisme.
source:
meta:
provider: INSEE
summary: Indisponible pour des raisons légales
description: Cette entité n'est accessible par aucun organisme.
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/insee/sirene/etablissements/diffusibles/13002526500013?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/insee/sirene/unites_legales/diffusibles/{siren}/siege_social":
get:
summary: Données siège social en open data
tags:
- Informations générales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
deprecated: true
security:
- jwt_bearer_token: []
description: Informations générales publiques concernant le siège d'une unité
légale inscrite au répertoire Sirene.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles_v3#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles_v3#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles_v3#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Établissement trouvé
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_insee_sieges_diffusables_unites_legales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siret:
title: Siret de l'établissement
type: string
example: '30613890001294'
description: Il peut arriver que le siret renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
siege_social:
type: boolean
example: true
enum:
- true
- false
description: Indique si l'établissement est le siège social
de l'entreprise.
etat_administratif:
title: État administratif de l'établissement
type: string
example: A
enum:
- A
- F
description: "Cette valeur décrit l'état administratif de
l'établissement, qui peut être : \n \n - actif. Sauf exception,
lors de son inscription au répertoire, tout établissement
est à l'état 'actif'\n\n - fermé. Cet état découle de la
prise en compte d'une déclaration de fermeture. Un établissement
fermé peut être rouvert. \n \n Plus d'informations dans
la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#etatadministratifetablissement"
date_fermeture:
title: Date de fermeture de l'établissement
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'établissement
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'un
établissement n'ayant pas encore de code APE peut se
voir affecter la valeur '00.00Z' de manière provisoire.
\n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'établissement
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
title: Code effectif
type: string
nullable: true
example: '51'
description: "Le code effectif correspond à la tranche
d'effectif salarié de l'établissement : \n \n - NN :
Unités non employeuses (pas de salarié au cours de l'année
de référence et pas d'effectif au 31/12). Cette tranche
peut contenir quelques effectifs inconnus \n - 00 :
0 salarié (n'ayant pas d'effectif au 31/12 mais ayant
employé des salariés au cours de l'année de référence)
\n - 01 : 1 ou 2 salariés \n - 02 : 3 à 5 salariés \n
- 03 : 6 à 9 salariés \n - 11 : 10 à 19 salariés \n
- 12 : 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999 salariés
\n - 42 : 1 000 à 1 999 salariés \n - 51 : 2 000 à 4
999 salariés \n - 52 : 5 000 à 9 999 salariés \n - 53
: 10 000 salariés et plus \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#trancheeffectifsetablissement.
\n \n L'effectif mensuel exact de l'établissement est
disponible au travers de l'[API Effectifs - URSSAF Caisse
nationale](https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement).
Si votre jeton contient ce droit d'accès, nous vous
recommandons d'utiliser cette API. Ces données étant
protégées, leur cadre d'utilisation est différent de
la tranche effectif fournie par l'Insee, qui elle est
une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si des
données protégées sont présentes dans la payload (ce qui
est le cas lorsque l'unité légale est en statut de diffusion
partielle). Pour une unité légale : \n \n - diffusible :
'true', car toutes les données sont publiques ; \n - partiellement-diffusible
: 'false', une partie des données est protégée et ne doit
pas être diffusée, pour du pré-remplissage de formulaire
public, préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète) :
'false', dans ce cas, les informations obtenues ne doivent
en aucun cas être accessibles au grand public. Ce cas n'étant
plus censé exister, préférer l'API en open data qui masque
automatiquement les données protégées. \n Plus d'informations
sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
enseigne:
title: Enseigne de l'établissement
type: string
nullable: true
description: "L'enseigne est l'appellation désignant l'emplacement
ou le local dans lequel est exercée l'activité. Un établissement
peut posséder une enseigne, plusieurs enseignes ou aucune.
\n \n Cette variable est la concaténation séparée par des
virgules des 3 champs \"renvoyés\" par l'Insee. Plus d'informations
ici: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#enseigne1etablissement-enseigne2etablissement-enseigne3etablissement
\n Si la personne morale est en diffusion partielle, l'enseigne
n'est pas renvoyée, et la valeur est remplacée par \"[ND]\"."
example: Coiff Land, CoiffureLand
unite_legale:
type: object
additionalProperties: false
title: Unité légale de l'établissement
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit
différent du paramètre d'appel. Il s'agit d'une erreur
généralement temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale
est également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant
à une personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale.
Les valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
description: Si la personne morale est en diffusion
partielle, le sigle n'est pas renvoyé, et la valeur
est remplacée par "[ND]".
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique.
Les valeurs sont à 'null' pour les personnes morales.
Pour les personnes physiques, la raison sociale / dénomination
/ nom de l'entreprise correspond toujours au nom de
famille et au prénom, précédés ou suivis de la mention
"entrepreneur individuel" ou "EI". Pour en savoir plus,
consulter cette page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: "Le pseudonyme correspond au nom qu'une
personne utilise pour se désigner dans l'exercice
de son activité, généralement littéraire ou artistique.
\n Si la personne physique est en diffusion partielle,
le pseudonyme n'est pas renvoyé et la valeur est
remplacée par \"[ND]\"."
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: "Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la
vie courante. Ce prénom fait partie de ceux qui
lui ont été donnés à sa naissance et qui sont inscrits
à l'état civil. \n Si la personne physique est en
diffusion partielle, le prénom usuel n'est pas renvoyé
et la valeur est remplacée par \"[ND]\"."
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: "Nom que la personne physique a choisi
d'utiliser. \n Si la personne physique est en diffusion
partielle, le nom d'usage n'est pas renvoyé et la
valeur est remplacée par \"[ND]\"."
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
description: Si la personne physique est en diffusion
partielle, le nom de naissance n'est pas renvoyé
et la valeur est remplacée par "[ND]".
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: "Caractère féminin ou masculin de la
personne physique. Cette valeur peut ne pas être
renseignée pour une personne physique. \n Si la
personne physique est en diffusion partielle, la
valeur est remplacée par \"[ND]\"."
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n
\n - GE : Grande Entreprise \n - ETI : Entreprise de
Taille Intermédiaire \n - PME : Petite ou Moyenne Entreprise
\n \n Celle-ci peut-être 'null' dans certains cas :
quand il s’agit d’une unité légale nouvellement créée,
ou bien d’une unité légale cessée, ou encore d’une unité
légale hors champ du calcul de la catégorie (unité légale
agricole ou ne faisant pas partie du système productif).
\n \n Définition de 'catégorie d'entreprise' par l'Insee
: https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité
légale : \n \n - Diffusible : Toutes les données de
l'unité légale sont diffusibles, donc publiques. \n
- Partiellement diffusible : Seule une partie des données
est diffusible, suite à une demande de l'entité qui
a exercé sont droit d'opposition à la diffusion de données
personnelles. \n - Non-diffusible (obsolète) : Ce statut
correspond à l'ancien statut, toutes les entités ayant
exercé leur droit d'opposition sont normalement désormais
en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement
publiques et donc diffusables
type: boolean
example: true
description: "Ce champ est a priori toujours à 'true'
car cette API ne renvoie que de l'open data. Pour une
unité légale : \n \n - diffusible : 'true', car toutes
les données sont publiques ; \n - partiellement-diffusible
: 'true'. Dans ce cas, les informations protégées suite
au droit d'opposition sont masquées par la chaîne de
caractère '[ND]' ; \n Plus d'informations sur les conditions
de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier
niveau de classement contient 9 grandes catégories
identifiables avec le premier chiffre du code :
\n \n - 0 : Organisme de placement collectif en
valeurs mobilières sans personnalité morale \n -
1 : Entrepreneur individuel. La catégorie juridique
des personnes physiques est '1000'. \n - 2 : Groupement
de droit privé non doté de la personnalité morale
\n - 3 : Personne morale de droit étranger \n -
4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 :
Autre personne morale immatriculée au RCS \n - 7
: Personne morale et organisme soumis au droit administratif
\n - 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des
codes fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique
de l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au
code juridique. Si le code ne correspond à aucun
libellé la valeur 'non référencé' est utilisée.
\n \n Nomenclature exhaustive fournie par l'Insee
: https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce
code de 4 chiffres + 1 lettre est extrait de la
nomenclature d'activité française (NAF) de l'Insee.
Si le code n'est pas renseigné dans la nomenclature
'Naf Rév2' (nomenclature en vigueur), le code est
null ici. \n \n À noter qu'une entreprise n'ayant
pas encore de code APE peut se voir affecter la
valeur '00.00Z' de manière provisoire. \n \n Plus
d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de
l'Insee : https://www.insee.fr/fr/information/2120875.
\n \n ⚠️ À partir de janvier 2026, le code APE utilisera
la nouvelle nomenclature NAF 2025, tel qu'explicité
dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par
l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en
vigueur), la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents (créés
il y a moins de trois ans). Les délais de récolte et
traitement font que les valeurs indiquées datent de
l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale :
\n \n - NN : Unités non employeuses (pas de salarié
au cours de l'année de référence et pas d'effectif
au 31/12). Cette tranche peut contenir quelques
effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou
2 salariés \n - 02 : 3 à 5 salariés \n - 03 : 6
à 9 salariés \n - 11 : 10 à 19 salariés \n - 12
: 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999
salariés \n - 42 : 1 000 à 1 999 salariés \n - 51
: 2 000 à 4 999 salariés \n - 52 : 5 000 à 9 999
salariés \n - 53 : 10 000 salariés et plus \n \n
Plus d'informations dans la documentation Insee
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel
et annuel, est disponible au travers de l'API Effectifs
- URSSAF Caisse nationale. Si votre jeton contient
ce droit d'accès, nous vous recommandons d'utiliser
cette API. Ces données étant protégées, leur cadre
d'utilisation est différent de la tranche effectif
fournie par l'Insee, qui elle est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif
de l'unité légale qui peut être « active » ou « cessée
» \n \n **Pour les personnes morales**, l'unité légale
est considérée comme juridiquement « cessée » si : \n
- il y a eu dépôt de la déclaration de disparition
de la personne morale ; \n - 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”) ;
\n - elle n'a plus d'établissement en activité. \n \n
**Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n -
l'exploitant de l'unité légale décède ; \n - l'exploitant
dépose une cessation d'activité. \n \n En dehors de
ces cas, l'état administratif de l'unité légale est
toujours « actif ». \n \n Plus d'informations dans la
documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire
(ESS)
description: "Indique si l'unité légale est une ESS :
\n \n - true : l'entreprise est une ESS \n - false :
l'entreprise n'est pas une ESS \n - null : le statut
ESS est inconnu. Cette information est connue pour environ
1 million d'unités légales, autrement, elle est à null.
\n \n Les unités légales de l'ESS adhèrent aux mêmes
principes : \n * poursuivre un but social autre que
le seul partage des bénéfices ; \n * une lucrativité
encadrée (notamment des bénéfices majoritairement consacrés
au maintien et au développement de l’activité) ; \n
* une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date
qui figure dans les statuts de l'entreprise qui sont
déposés au centre de formalité des entreprises (CFE)
compétent. Cette valeur est renvoyée sous format timestamp.
\n \n Pour certains établissements très anciens, tous
fermés et dont l’unité légale est cessée la date de
création peut être nulle. \n Pour les unités purgées,
la date de création n'est jamais à 'null'. Si elle est
non renseignée, elle sera au 01/01/1900. \n \n Plus
d'informations dans la documentation Insee de l'API
Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
adresse:
type: object
additionalProperties: false
title: Adresse de l'établissement
properties:
numero_voie:
title: Numéro dans la voie
type: string
example: '22'
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
indice_repetition_voie:
title: Indice de répétition du numéro dans la voie
description: "Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#indicerepetitionetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
type: string
nullable: true
enum:
- bis
- ter
- quarter
- quinquies
-
type_voie:
title: Type de la voie de localisation
example: RUE
description: "Le type de la voie de localisation est indiquée
en abrégé et en majuscules. L'information n'est pas
toujours renseignée. Pour certaines petites communes,
l'information n'existe pas. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#typevoieetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
type: string
nullable: true
enum:
- ALLÉE
- AVENUE
- BOULEVARD
- CARREFOUR
- CHEMIN
- CHAUSSÉE
- CITÉ
- CORNICHE
- COURS
- DOMAINE
- DESCENTE
- ECART
- ESPLANADE
- FAUBOURG
- GRANDE RUE
- HAMEAU
- HALLE
- IMPASSE
- LIEU-DIT
- LOTISSEMENT
- MARCHÉ
- MONTÉE
- PASSAGE
- PLACE
- PLAINE
- PLATEAU
- PROMENADE
- PARVIS
- QUARTIER
- QUAI
- RÉSIDENCE
- RUELLE
- ROCADE
- ROND-POINT
- ROUTE
- RUE
- SENTIER
- SQUARE
- TERRE-PLEIN
- TRAVERSE
- VILLA
- VILLAGE
-
libelle_voie:
title: Libellé de la voie
type: string
example: DE LA PAIX
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
complement_adresse:
title: Complément d'adresse
type: string
description: "Le complément d'adresse correspond à des
éléments situés à l'extérieur du bâtiment qui permettent
de compléter l'adresse (résidence, bâtiment, entrée,
etc..) \n Si la personne morale est en diffusion partielle,
le complément d'adresse n'est pas renvoyé, et la valeur
est remplacée par \"[ND]\"."
example: ZAE SAINT GUENAULT
nullable: true
code_commune:
title: Code commune
description: "Le code commune désigne le code de la commune
de localisation de l'établissement. Le code renvoyé
correspond à la date de l'appel, ce qui implique que
toute modification du code commune est repercutée sur
l'ensemble des établissements concernés, y compris ceux
qui sont fermés. Cette valeur est à 'null' pour les
entreprises à l'étranger. \n \n Les codes sont listés
dans la table d'appartenance géographique fournie par
l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028"
type: string
example: '75112'
nullable: true
code_postal:
title: Code postal
example: '75016'
type: string
nullable: true
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
distribution_speciale:
title: Distribution spéciale
type: string
nullable: true
description: "La distribution spéciale reprend les éléments
particuliers qui accompagnent une adresse de distribution
\ spéciale, la modalité la plus connue étant les adresses
en 'CEDEX'. \n \n L'Insee ne gère plus cette variable
: elle est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#distributionspecialeetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
code_cedex:
title: Code cedex
type: string
nullable: true
description: "L'Insee ne gère plus cette variable : elle
est désormais toujours à 'null'. \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#codecedexetablissement
\n Sur le sigle CEDEX lui-même : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
libelle_cedex:
title: Libellé du code cedex
type: string
nullable: true
description: "Ce champ indique le libellé correspondant
au code cedex de l'établissement. Si le code cedex est
à 'null', ce champ est également à 'null'. \n L'Insee
ne gère plus cette variable : elle est désormais toujours
à 'null'. \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#libellecedexetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
libelle_commune:
title: Nom de la commune pour une adresse en France
description: Cette valeur est à 'null' pour les établissements
à l'étranger.
type: string
example: PARIS 12
nullable: true
libelle_commune_etranger:
title: Nom de la commune pour une adresse à l'étranger.
description: Cette valeur est à 'null' pour les établissements
en France.
type: string
nullable: true
code_pays_etranger:
title: Code du pays pour les établissements situés à l'étranger
description: 'La nomenclature des codes pays se trouve
ici : https://www.insee.fr/fr/information/2028273'
type: string
example: '99132'
nullable: true
libelle_pays_etranger:
title: Nom du pays pour les établissements situés à l'étranger
type: string
nullable: true
example: ROYAUME-UNI
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement
diffusible : Seule une partie des données est diffusible,
suite à une demande de l'entité qui a exercé sont droit
d'opposition à la diffusion de données personnelles.
\n - Non-diffusible (obsolète) : Ce statut correspond
à l'ancien statut, toutes les entités ayant exercé leur
droit d'opposition sont normalement désormais en statut
\"partiellement diffusible\"."
acheminement_postal:
type: object
additionalProperties: false
title: Éléments constitutifs de l'adresse postale pour
son acheminement.
description: Il ne s'agit pas d'un traitement RNVP mais
simplement d'une réorganisation des éléments renvoyé
par l'Insee pour faciliter l'affichage des adresses
postales
properties:
l1:
title: Ligne 1
type: string
description: "Si l'établissement correspond à une
personne morale : la dénomination sociale de la
personne morale. Le cas contraire: cette variable
est vide. \n Si la personne morale est en diffusion
partielle, la valeur est remplacée par \"[ND]\"."
nullable: true
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
l2:
title: Ligne 2
type: string
description: "Si l'établissement correspond à une
personne physique : concaténation du nom et prénom
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
example: JEAN MARIE DURAND
l3:
title: Ligne 3
type: string
description: "Si l'établissement correspond à une
personne physique : concaténation du nom et prénom
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
example: ZAE SAINT GUENAULT
l4:
title: Ligne 4
type: string
description: "Concaténation du numéro de voie, d'indice
de répétition, du type de voie et du libellé de
la voie \n Si la personne morale est en diffusion
partielle, la valeur est remplacée par \"[ND]\"."
nullable: true
example: 51 BIS RUE DE LA PAIX
l5:
title: Ligne 5
type: string
description: "Distribution spéciale comme décrit dans
la clé `distribution_speciale`, que l'Insee ne gère
plus : cette ligne est désormais toujours vide.
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
l6:
title: Ligne 6
type: string
description: "Si le pays est en France : code postal
accompagné du libellé de la commune, sinon : libellé
de la commune de l'établissement situé à l'étranger.
\n Le code cedex, qui primait sur le code postal,
ne sort plus de cette ligne : l'Insee ne gère plus
cette variable. \n Si la personne morale est en
diffusion partielle, la valeur est remplacée par
\"[ND]\"."
nullable: true
example: 75012 PARIS
l7:
title: Ligne 7
type: string
description: Pays de l'établissement
nullable: true
example: FRANCE
required:
- l1
- l2
- l3
- l4
- l5
- l6
- l7
required:
- numero_voie
- indice_repetition_voie
- type_voie
- libelle_voie
- complement_adresse
- code_commune
- code_postal
- distribution_speciale
- code_cedex
- libelle_cedex
- libelle_commune
- libelle_commune_etranger
- code_pays_etranger
- libelle_pays_etranger
- status_diffusion
- acheminement_postal
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
required:
- siret
- siege_social
- etat_administratif
- date_fermeture
- activite_principale
- tranche_effectif_salarie
- status_diffusion
- diffusable_commercialement
- enseigne
- unite_legale
- adresse
- date_creation
additionalProperties: false
links:
type: object
properties:
unite_legale:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/unites_legales/130025265
description: Lien vers la ressource 'Donnée Sirene d'une unité
légale' correspondant à cette adresse d'établissement pour
obtenir les données de référence de l'unité légale.
required:
- unite_legale
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siret:
type: string
title: Siret d'origine de la requête
description: "Si la requête a été effectuée sur un siret qui
a été redirigé vers un autre siret , cette variable contient
le siret d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siret est différent du
paramètre d'appel, et cette variable est le siret d'entrée.
\n \n A noter que le siret de redirection est systématiquement
le siret du siège social de l'unité légale : en effet la
base Sirene ne possède pas la correspondance exacte entre
un siret doublon et le siret d'origine. "
example: '30613890000010'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siret
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles_v3#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles_v3#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles_v3#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles_v3#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles_v3#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles_v3#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles_v3#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/insee/sirene/unites_legales/diffusibles/130025265/siege_social?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/insee/sirene/unites_legales/diffusibles/{siren}/siege_social":
get:
summary: Données siège social en open data
tags:
- Informations generales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Informations générales publiques concernant le siège d'une unité
légale inscrite au répertoire Sirene. Cette version utilise la nomenclature
NAF2025 pour l'activité principale.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Etablissement trouve
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_insee_sieges_diffusables_unites_legales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siret:
title: Siret de l'établissement
type: string
example: '30613890001294'
description: Il peut arriver que le siret renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
siege_social:
type: boolean
example: true
enum:
- true
- false
description: Indique si l'établissement est le siège social
de l'entreprise.
etat_administratif:
title: État administratif de l'établissement
type: string
example: A
enum:
- A
- F
description: "Cette valeur décrit l'état administratif de
l'établissement, qui peut être : \n \n - actif. Sauf exception,
lors de son inscription au répertoire, tout établissement
est à l'état 'actif'\n\n - fermé. Cet état découle de la
prise en compte d'une déclaration de fermeture. Un établissement
fermé peut être rouvert. \n \n Plus d'informations dans
la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#etatadministratifetablissement"
date_fermeture:
title: Date de fermeture de l'établissement
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'établissement
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'un
établissement n'ayant pas encore de code APE peut se
voir affecter la valeur '00.00Z' de manière provisoire.
\n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'établissement
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
title: Code effectif
type: string
nullable: true
example: '51'
description: "Le code effectif correspond à la tranche
d'effectif salarié de l'établissement : \n \n - NN :
Unités non employeuses (pas de salarié au cours de l'année
de référence et pas d'effectif au 31/12). Cette tranche
peut contenir quelques effectifs inconnus \n - 00 :
0 salarié (n'ayant pas d'effectif au 31/12 mais ayant
employé des salariés au cours de l'année de référence)
\n - 01 : 1 ou 2 salariés \n - 02 : 3 à 5 salariés \n
- 03 : 6 à 9 salariés \n - 11 : 10 à 19 salariés \n
- 12 : 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999 salariés
\n - 42 : 1 000 à 1 999 salariés \n - 51 : 2 000 à 4
999 salariés \n - 52 : 5 000 à 9 999 salariés \n - 53
: 10 000 salariés et plus \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#trancheeffectifsetablissement.
\n \n L'effectif mensuel exact de l'établissement est
disponible au travers de l'[API Effectifs - URSSAF Caisse
nationale](https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement).
Si votre jeton contient ce droit d'accès, nous vous
recommandons d'utiliser cette API. Ces données étant
protégées, leur cadre d'utilisation est différent de
la tranche effectif fournie par l'Insee, qui elle est
une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si des
données protégées sont présentes dans la payload (ce qui
est le cas lorsque l'unité légale est en statut de diffusion
partielle). Pour une unité légale : \n \n - diffusible :
'true', car toutes les données sont publiques ; \n - partiellement-diffusible
: 'false', une partie des données est protégée et ne doit
pas être diffusée, pour du pré-remplissage de formulaire
public, préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète) :
'false', dans ce cas, les informations obtenues ne doivent
en aucun cas être accessibles au grand public. Ce cas n'étant
plus censé exister, préférer l'API en open data qui masque
automatiquement les données protégées. \n Plus d'informations
sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
enseigne:
title: Enseigne de l'établissement
type: string
nullable: true
description: "L'enseigne est l'appellation désignant l'emplacement
ou le local dans lequel est exercée l'activité. Un établissement
peut posséder une enseigne, plusieurs enseignes ou aucune.
\n \n Cette variable est la concaténation séparée par des
virgules des 3 champs \"renvoyés\" par l'Insee. Plus d'informations
ici: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#enseigne1etablissement-enseigne2etablissement-enseigne3etablissement
\n Si la personne morale est en diffusion partielle, l'enseigne
n'est pas renvoyée, et la valeur est remplacée par \"[ND]\"."
example: Coiff Land, CoiffureLand
unite_legale:
type: object
additionalProperties: false
title: Unité légale de l'établissement
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit
différent du paramètre d'appel. Il s'agit d'une erreur
généralement temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale
est également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant
à une personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale.
Les valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
description: Si la personne morale est en diffusion
partielle, le sigle n'est pas renvoyé, et la valeur
est remplacée par "[ND]".
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique.
Les valeurs sont à 'null' pour les personnes morales.
Pour les personnes physiques, la raison sociale / dénomination
/ nom de l'entreprise correspond toujours au nom de
famille et au prénom, précédés ou suivis de la mention
"entrepreneur individuel" ou "EI". Pour en savoir plus,
consulter cette page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: "Le pseudonyme correspond au nom qu'une
personne utilise pour se désigner dans l'exercice
de son activité, généralement littéraire ou artistique.
\n Si la personne physique est en diffusion partielle,
le pseudonyme n'est pas renvoyé et la valeur est
remplacée par \"[ND]\"."
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: "Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la
vie courante. Ce prénom fait partie de ceux qui
lui ont été donnés à sa naissance et qui sont inscrits
à l'état civil. \n Si la personne physique est en
diffusion partielle, le prénom usuel n'est pas renvoyé
et la valeur est remplacée par \"[ND]\"."
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: "Nom que la personne physique a choisi
d'utiliser. \n Si la personne physique est en diffusion
partielle, le nom d'usage n'est pas renvoyé et la
valeur est remplacée par \"[ND]\"."
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
description: Si la personne physique est en diffusion
partielle, le nom de naissance n'est pas renvoyé
et la valeur est remplacée par "[ND]".
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: "Caractère féminin ou masculin de la
personne physique. Cette valeur peut ne pas être
renseignée pour une personne physique. \n Si la
personne physique est en diffusion partielle, la
valeur est remplacée par \"[ND]\"."
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n
\n - GE : Grande Entreprise \n - ETI : Entreprise de
Taille Intermédiaire \n - PME : Petite ou Moyenne Entreprise
\n \n Celle-ci peut-être 'null' dans certains cas :
quand il s’agit d’une unité légale nouvellement créée,
ou bien d’une unité légale cessée, ou encore d’une unité
légale hors champ du calcul de la catégorie (unité légale
agricole ou ne faisant pas partie du système productif).
\n \n Définition de 'catégorie d'entreprise' par l'Insee
: https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité
légale : \n \n - Diffusible : Toutes les données de
l'unité légale sont diffusibles, donc publiques. \n
- Partiellement diffusible : Seule une partie des données
est diffusible, suite à une demande de l'entité qui
a exercé sont droit d'opposition à la diffusion de données
personnelles. \n - Non-diffusible (obsolète) : Ce statut
correspond à l'ancien statut, toutes les entités ayant
exercé leur droit d'opposition sont normalement désormais
en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement
publiques et donc diffusables
type: boolean
example: true
description: "Ce champ est a priori toujours à 'true'
car cette API ne renvoie que de l'open data. Pour une
unité légale : \n \n - diffusible : 'true', car toutes
les données sont publiques ; \n - partiellement-diffusible
: 'true'. Dans ce cas, les informations protégées suite
au droit d'opposition sont masquées par la chaîne de
caractère '[ND]' ; \n Plus d'informations sur les conditions
de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier
niveau de classement contient 9 grandes catégories
identifiables avec le premier chiffre du code :
\n \n - 0 : Organisme de placement collectif en
valeurs mobilières sans personnalité morale \n -
1 : Entrepreneur individuel. La catégorie juridique
des personnes physiques est '1000'. \n - 2 : Groupement
de droit privé non doté de la personnalité morale
\n - 3 : Personne morale de droit étranger \n -
4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 :
Autre personne morale immatriculée au RCS \n - 7
: Personne morale et organisme soumis au droit administratif
\n - 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des
codes fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique
de l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au
code juridique. Si le code ne correspond à aucun
libellé la valeur 'non référencé' est utilisée.
\n \n Nomenclature exhaustive fournie par l'Insee
: https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce
code de 4 chiffres + 1 lettre est extrait de la
nomenclature d'activité française (NAF) de l'Insee.
Si le code n'est pas renseigné dans la nomenclature
'Naf Rév2' (nomenclature en vigueur), le code est
null ici. \n \n À noter qu'une entreprise n'ayant
pas encore de code APE peut se voir affecter la
valeur '00.00Z' de manière provisoire. \n \n Plus
d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de
l'Insee : https://www.insee.fr/fr/information/2120875.
\n \n ⚠️ À partir de janvier 2026, le code APE utilisera
la nouvelle nomenclature NAF 2025, tel qu'explicité
dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par
l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en
vigueur), la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents (créés
il y a moins de trois ans). Les délais de récolte et
traitement font que les valeurs indiquées datent de
l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale :
\n \n - NN : Unités non employeuses (pas de salarié
au cours de l'année de référence et pas d'effectif
au 31/12). Cette tranche peut contenir quelques
effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou
2 salariés \n - 02 : 3 à 5 salariés \n - 03 : 6
à 9 salariés \n - 11 : 10 à 19 salariés \n - 12
: 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999
salariés \n - 42 : 1 000 à 1 999 salariés \n - 51
: 2 000 à 4 999 salariés \n - 52 : 5 000 à 9 999
salariés \n - 53 : 10 000 salariés et plus \n \n
Plus d'informations dans la documentation Insee
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel
et annuel, est disponible au travers de l'API Effectifs
- URSSAF Caisse nationale. Si votre jeton contient
ce droit d'accès, nous vous recommandons d'utiliser
cette API. Ces données étant protégées, leur cadre
d'utilisation est différent de la tranche effectif
fournie par l'Insee, qui elle est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif
de l'unité légale qui peut être « active » ou « cessée
» \n \n **Pour les personnes morales**, l'unité légale
est considérée comme juridiquement « cessée » si : \n
- il y a eu dépôt de la déclaration de disparition
de la personne morale ; \n - 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”) ;
\n - elle n'a plus d'établissement en activité. \n \n
**Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n -
l'exploitant de l'unité légale décède ; \n - l'exploitant
dépose une cessation d'activité. \n \n En dehors de
ces cas, l'état administratif de l'unité légale est
toujours « actif ». \n \n Plus d'informations dans la
documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire
(ESS)
description: "Indique si l'unité légale est une ESS :
\n \n - true : l'entreprise est une ESS \n - false :
l'entreprise n'est pas une ESS \n - null : le statut
ESS est inconnu. Cette information est connue pour environ
1 million d'unités légales, autrement, elle est à null.
\n \n Les unités légales de l'ESS adhèrent aux mêmes
principes : \n * poursuivre un but social autre que
le seul partage des bénéfices ; \n * une lucrativité
encadrée (notamment des bénéfices majoritairement consacrés
au maintien et au développement de l’activité) ; \n
* une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date
qui figure dans les statuts de l'entreprise qui sont
déposés au centre de formalité des entreprises (CFE)
compétent. Cette valeur est renvoyée sous format timestamp.
\n \n Pour certains établissements très anciens, tous
fermés et dont l’unité légale est cessée la date de
création peut être nulle. \n Pour les unités purgées,
la date de création n'est jamais à 'null'. Si elle est
non renseignée, elle sera au 01/01/1900. \n \n Plus
d'informations dans la documentation Insee de l'API
Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
activite_principale_naf_rev2:
title: Attributs de l'activité principale en nomenclature
NAFRev2
type: object
additionalProperties: false
description: Ce champ permet de retrouver le code APE
dans l'ancienne nomenclature NAFRev2 pour assurer la
rétro-compatibilité.
properties:
code:
title: Code de l'activité principale (APE) en NAFRev2
type: string
example: 8411Z
nullable: true
libelle:
title: Libellé associé au code APE NAFRev2
type: string
nullable: false
example: Administration publique générale
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
required:
- code
- libelle
- nomenclature
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
- activite_principale_naf_rev2
adresse:
type: object
additionalProperties: false
title: Adresse de l'établissement
properties:
numero_voie:
title: Numéro dans la voie
type: string
example: '22'
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
indice_repetition_voie:
title: Indice de répétition du numéro dans la voie
description: "Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#indicerepetitionetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
type: string
nullable: true
enum:
- bis
- ter
- quarter
- quinquies
-
type_voie:
title: Type de la voie de localisation
example: RUE
description: "Le type de la voie de localisation est indiquée
en abrégé et en majuscules. L'information n'est pas
toujours renseignée. Pour certaines petites communes,
l'information n'existe pas. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#typevoieetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
type: string
nullable: true
enum:
- ALLÉE
- AVENUE
- BOULEVARD
- CARREFOUR
- CHEMIN
- CHAUSSÉE
- CITÉ
- CORNICHE
- COURS
- DOMAINE
- DESCENTE
- ECART
- ESPLANADE
- FAUBOURG
- GRANDE RUE
- HAMEAU
- HALLE
- IMPASSE
- LIEU-DIT
- LOTISSEMENT
- MARCHÉ
- MONTÉE
- PASSAGE
- PLACE
- PLAINE
- PLATEAU
- PROMENADE
- PARVIS
- QUARTIER
- QUAI
- RÉSIDENCE
- RUELLE
- ROCADE
- ROND-POINT
- ROUTE
- RUE
- SENTIER
- SQUARE
- TERRE-PLEIN
- TRAVERSE
- VILLA
- VILLAGE
-
libelle_voie:
title: Libellé de la voie
type: string
example: DE LA PAIX
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
complement_adresse:
title: Complément d'adresse
type: string
description: "Le complément d'adresse correspond à des
éléments situés à l'extérieur du bâtiment qui permettent
de compléter l'adresse (résidence, bâtiment, entrée,
etc..) \n Si la personne morale est en diffusion partielle,
le complément d'adresse n'est pas renvoyé, et la valeur
est remplacée par \"[ND]\"."
example: ZAE SAINT GUENAULT
nullable: true
code_commune:
title: Code commune
description: "Le code commune désigne le code de la commune
de localisation de l'établissement. Le code renvoyé
correspond à la date de l'appel, ce qui implique que
toute modification du code commune est repercutée sur
l'ensemble des établissements concernés, y compris ceux
qui sont fermés. Cette valeur est à 'null' pour les
entreprises à l'étranger. \n \n Les codes sont listés
dans la table d'appartenance géographique fournie par
l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028"
type: string
example: '75112'
nullable: true
code_postal:
title: Code postal
example: '75016'
type: string
nullable: true
description: Si la personne morale est en diffusion partielle,
la valeur est remplacée par "[ND]".
distribution_speciale:
title: Distribution spéciale
type: string
nullable: true
description: "La distribution spéciale reprend les éléments
particuliers qui accompagnent une adresse de distribution
\ spéciale, la modalité la plus connue étant les adresses
en 'CEDEX'. \n \n L'Insee ne gère plus cette variable
: elle est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#distributionspecialeetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
code_cedex:
title: Code cedex
type: string
nullable: true
description: "L'Insee ne gère plus cette variable : elle
est désormais toujours à 'null'. \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#codecedexetablissement
\n Sur le sigle CEDEX lui-même : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
libelle_cedex:
title: Libellé du code cedex
type: string
nullable: true
description: "Ce champ indique le libellé correspondant
au code cedex de l'établissement. Si le code cedex est
à 'null', ce champ est également à 'null'. \n L'Insee
ne gère plus cette variable : elle est désormais toujours
à 'null'. \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#libellecedexetablissement
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
libelle_commune:
title: Nom de la commune pour une adresse en France
description: Cette valeur est à 'null' pour les établissements
à l'étranger.
type: string
example: PARIS 12
nullable: true
libelle_commune_etranger:
title: Nom de la commune pour une adresse à l'étranger.
description: Cette valeur est à 'null' pour les établissements
en France.
type: string
nullable: true
code_pays_etranger:
title: Code du pays pour les établissements situés à l'étranger
description: 'La nomenclature des codes pays se trouve
ici : https://www.insee.fr/fr/information/2028273'
type: string
example: '99132'
nullable: true
libelle_pays_etranger:
title: Nom du pays pour les établissements situés à l'étranger
type: string
nullable: true
example: ROYAUME-UNI
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement
diffusible : Seule une partie des données est diffusible,
suite à une demande de l'entité qui a exercé sont droit
d'opposition à la diffusion de données personnelles.
\n - Non-diffusible (obsolète) : Ce statut correspond
à l'ancien statut, toutes les entités ayant exercé leur
droit d'opposition sont normalement désormais en statut
\"partiellement diffusible\"."
acheminement_postal:
type: object
additionalProperties: false
title: Éléments constitutifs de l'adresse postale pour
son acheminement.
description: Il ne s'agit pas d'un traitement RNVP mais
simplement d'une réorganisation des éléments renvoyé
par l'Insee pour faciliter l'affichage des adresses
postales
properties:
l1:
title: Ligne 1
type: string
description: "Si l'établissement correspond à une
personne morale : la dénomination sociale de la
personne morale. Le cas contraire: cette variable
est vide. \n Si la personne morale est en diffusion
partielle, la valeur est remplacée par \"[ND]\"."
nullable: true
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
l2:
title: Ligne 2
type: string
description: "Si l'établissement correspond à une
personne physique : concaténation du nom et prénom
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
example: JEAN MARIE DURAND
l3:
title: Ligne 3
type: string
description: "Si l'établissement correspond à une
personne physique : concaténation du nom et prénom
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
example: ZAE SAINT GUENAULT
l4:
title: Ligne 4
type: string
description: "Concaténation du numéro de voie, d'indice
de répétition, du type de voie et du libellé de
la voie \n Si la personne morale est en diffusion
partielle, la valeur est remplacée par \"[ND]\"."
nullable: true
example: 51 BIS RUE DE LA PAIX
l5:
title: Ligne 5
type: string
description: "Distribution spéciale comme décrit dans
la clé `distribution_speciale`, que l'Insee ne gère
plus : cette ligne est désormais toujours vide.
\n Si la personne morale est en diffusion partielle,
la valeur est remplacée par \"[ND]\"."
nullable: true
l6:
title: Ligne 6
type: string
description: "Si le pays est en France : code postal
accompagné du libellé de la commune, sinon : libellé
de la commune de l'établissement situé à l'étranger.
\n Le code cedex, qui primait sur le code postal,
ne sort plus de cette ligne : l'Insee ne gère plus
cette variable. \n Si la personne morale est en
diffusion partielle, la valeur est remplacée par
\"[ND]\"."
nullable: true
example: 75012 PARIS
l7:
title: Ligne 7
type: string
description: Pays de l'établissement
nullable: true
example: FRANCE
required:
- l1
- l2
- l3
- l4
- l5
- l6
- l7
required:
- numero_voie
- indice_repetition_voie
- type_voie
- libelle_voie
- complement_adresse
- code_commune
- code_postal
- distribution_speciale
- code_cedex
- libelle_cedex
- libelle_commune
- libelle_commune_etranger
- code_pays_etranger
- libelle_pays_etranger
- status_diffusion
- acheminement_postal
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
activite_principale_naf_rev2:
title: Attributs de l'activité principale en nomenclature
NAFRev2
type: object
additionalProperties: false
description: Ce champ permet de retrouver le code APE dans
l'ancienne nomenclature NAFRev2 pour assurer la rétro-compatibilité.
properties:
code:
title: Code de l'activité principale (APE) en NAFRev2
type: string
example: 8411Z
nullable: true
libelle:
title: Libellé associé au code APE NAFRev2
type: string
nullable: false
example: Administration publique générale
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
required:
- code
- libelle
- nomenclature
required:
- siret
- siege_social
- etat_administratif
- date_fermeture
- activite_principale
- tranche_effectif_salarie
- status_diffusion
- diffusable_commercialement
- enseigne
- unite_legale
- adresse
- date_creation
- activite_principale_naf_rev2
additionalProperties: false
links:
type: object
properties:
unite_legale:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/unites_legales/130025265
description: Lien vers la ressource 'Donnée Sirene d'une unité
légale' correspondant à cette adresse d'établissement pour
obtenir les données de référence de l'unité légale.
required:
- unite_legale
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siret:
type: string
title: Siret d'origine de la requête
description: "Si la requête a été effectuée sur un siret qui
a été redirigé vers un autre siret , cette variable contient
le siret d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siret est différent du
paramètre d'appel, et cette variable est le siret d'entrée.
\n \n A noter que le siret de redirection est systématiquement
le siret du siège social de l'unité légale : en effet la
base Sirene ne possède pas la correspondance exacte entre
un siret doublon et le siret d'origine. "
example: '30613890000010'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siret
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouve
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_diffusables_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_diffusibles#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/insee/sirene/unites_legales/diffusibles/130025265/siege_social?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/insee/sirene/unites_legales/{siren}/siege_social":
get:
summary: Données siège social
tags:
- Informations générales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
deprecated: true
security:
- jwt_bearer_token: []
description: Informations générales concernant le siège social d'une unité légale
inscrite au répertoire Sirene. Avec les données protégées des sièges sociaux
en diffusion partielle.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_v3#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_v3#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_v3#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Établissement trouvé
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_insee_sieges_unites_legales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siret:
title: Siret de l'établissement
type: string
example: '30613890001294'
description: Il peut arriver que le siret renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
siege_social:
type: boolean
example: true
enum:
- true
- false
description: Indique si l'établissement est le siège social
de l'entreprise.
etat_administratif:
title: État administratif de l'établissement
type: string
example: A
enum:
- A
- F
description: "Cette valeur décrit l'état administratif de
l'établissement, qui peut être : \n \n - actif. Sauf exception,
lors de son inscription au répertoire, tout établissement
est à l'état 'actif'\n\n - fermé. Cet état découle de la
prise en compte d'une déclaration de fermeture. Un établissement
fermé peut être rouvert. \n \n Plus d'informations dans
la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#etatadministratifetablissement"
date_fermeture:
title: Date de fermeture de l'établissement
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'établissement
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'un
établissement n'ayant pas encore de code APE peut se
voir affecter la valeur '00.00Z' de manière provisoire.
\n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'établissement
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
title: Code effectif
type: string
nullable: true
example: '51'
description: "Le code effectif correspond à la tranche
d'effectif salarié de l'établissement : \n \n - NN :
Unités non employeuses (pas de salarié au cours de l'année
de référence et pas d'effectif au 31/12). Cette tranche
peut contenir quelques effectifs inconnus \n - 00 :
0 salarié (n'ayant pas d'effectif au 31/12 mais ayant
employé des salariés au cours de l'année de référence)
\n - 01 : 1 ou 2 salariés \n - 02 : 3 à 5 salariés \n
- 03 : 6 à 9 salariés \n - 11 : 10 à 19 salariés \n
- 12 : 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999 salariés
\n - 42 : 1 000 à 1 999 salariés \n - 51 : 2 000 à 4
999 salariés \n - 52 : 5 000 à 9 999 salariés \n - 53
: 10 000 salariés et plus \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#trancheeffectifsetablissement.
\n \n L'effectif mensuel exact de l'établissement est
disponible au travers de l'[API Effectifs - URSSAF Caisse
nationale](https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement).
Si votre jeton contient ce droit d'accès, nous vous
recommandons d'utiliser cette API. Ces données étant
protégées, leur cadre d'utilisation est différent de
la tranche effectif fournie par l'Insee, qui elle est
une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si des
données protégées sont présentes dans la payload (ce qui
est le cas lorsque l'unité légale est en statut de diffusion
partielle). Pour une unité légale : \n \n - diffusible :
'true', car toutes les données sont publiques ; \n - partiellement-diffusible
: 'false', une partie des données est protégée et ne doit
pas être diffusée, pour du pré-remplissage de formulaire
public, préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète) :
'false', dans ce cas, les informations obtenues ne doivent
en aucun cas être accessibles au grand public. Ce cas n'étant
plus censé exister, préférer l'API en open data qui masque
automatiquement les données protégées. \n Plus d'informations
sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
enseigne:
title: Enseigne de l'établissement
type: string
nullable: true
description: "L'enseigne est l'appellation désignant l'emplacement
ou le local dans lequel est exercée l'activité. Un établissement
peut posséder une enseigne, plusieurs enseignes ou aucune.
\n \n Cette variable est la concaténation séparée par des
virgules des 3 champs \"renvoyés\" par l'Insee. Plus d'informations
ici: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#enseigne1etablissement-enseigne2etablissement-enseigne3etablissement"
example: Coiff Land, CoiffureLand
unite_legale:
type: object
additionalProperties: false
title: Unité légale de l'établissement
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit
différent du paramètre d'appel. Il s'agit d'une erreur
généralement temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale
est également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant
à une personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale.
Les valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique.
Les valeurs sont à 'null' pour les personnes morales.
Pour les personnes physiques, la raison sociale / dénomination
/ nom de l'entreprise correspond toujours au nom de
famille et au prénom, précédés ou suivis de la mention
"entrepreneur individuel" ou "EI". Pour en savoir plus,
consulter cette page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: Le pseudonyme correspond au nom qu'une
personne utilise pour se désigner dans l'exercice
de son activité, généralement littéraire ou artistique.
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la
vie courante. Ce prénom fait partie de ceux qui
lui ont été donnés à sa naissance et qui sont inscrits
à l'état civil.
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: Nom que la personne physique a choisi
d'utiliser.
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: Caractère féminin ou masculin de la personne
physique. Cette valeur peut ne pas être renseignée
pour une personne physique.
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n
\n - GE : Grande Entreprise \n - ETI : Entreprise de
Taille Intermédiaire \n - PME : Petite ou Moyenne Entreprise
\n \n Celle-ci peut-être 'null' dans certains cas :
quand il s’agit d’une unité légale nouvellement créée,
ou bien d’une unité légale cessée, ou encore d’une unité
légale hors champ du calcul de la catégorie (unité légale
agricole ou ne faisant pas partie du système productif).
\n \n Définition de 'catégorie d'entreprise' par l'Insee
: https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité
légale : \n \n - Diffusible : Toutes les données de
l'unité légale sont diffusibles, donc publiques. \n
- Partiellement diffusible : Seule une partie des données
est diffusible, suite à une demande de l'entité qui
a exercé sont droit d'opposition à la diffusion de données
personnelles. \n - Non-diffusible (obsolète) : Ce statut
correspond à l'ancien statut, toutes les entités ayant
exercé leur droit d'opposition sont normalement désormais
en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement
publiques et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si
des données protégées sont présentes dans la payload
(ce qui est le cas lorsque l'unité légale est en statut
de diffusion partielle). Pour une unité légale : \n
\n - diffusible : 'true', car toutes les données sont
publiques ; \n - partiellement-diffusible : 'false',
une partie des données est protégée et ne doit pas être
diffusée, pour du pré-remplissage de formulaire public,
préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète)
: 'false', dans ce cas, les informations obtenues ne
doivent en aucun cas être accessibles au grand public.
Ce cas n'étant plus censé exister, préférer l'API en
open data qui masque automatiquement les données protégées.
\n Plus d'informations sur les conditions de diffusion
: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier
niveau de classement contient 9 grandes catégories
identifiables avec le premier chiffre du code :
\n \n - 0 : Organisme de placement collectif en
valeurs mobilières sans personnalité morale \n -
1 : Entrepreneur individuel. La catégorie juridique
des personnes physiques est '1000'. \n - 2 : Groupement
de droit privé non doté de la personnalité morale
\n - 3 : Personne morale de droit étranger \n -
4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 :
Autre personne morale immatriculée au RCS \n - 7
: Personne morale et organisme soumis au droit administratif
\n - 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des
codes fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique
de l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au
code juridique. Si le code ne correspond à aucun
libellé la valeur 'non référencé' est utilisée.
\n \n Nomenclature exhaustive fournie par l'Insee
: https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce
code de 4 chiffres + 1 lettre est extrait de la
nomenclature d'activité française (NAF) de l'Insee.
Si le code n'est pas renseigné dans la nomenclature
'Naf Rév2' (nomenclature en vigueur), le code est
null ici. \n \n À noter qu'une entreprise n'ayant
pas encore de code APE peut se voir affecter la
valeur '00.00Z' de manière provisoire. \n \n Plus
d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de
l'Insee : https://www.insee.fr/fr/information/2120875.
\n \n ⚠️ À partir de janvier 2026, le code APE utilisera
la nouvelle nomenclature NAF 2025, tel qu'explicité
dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par
l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en
vigueur), la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents (créés
il y a moins de trois ans). Les délais de récolte et
traitement font que les valeurs indiquées datent de
l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale :
\n \n - NN : Unités non employeuses (pas de salarié
au cours de l'année de référence et pas d'effectif
au 31/12). Cette tranche peut contenir quelques
effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou
2 salariés \n - 02 : 3 à 5 salariés \n - 03 : 6
à 9 salariés \n - 11 : 10 à 19 salariés \n - 12
: 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999
salariés \n - 42 : 1 000 à 1 999 salariés \n - 51
: 2 000 à 4 999 salariés \n - 52 : 5 000 à 9 999
salariés \n - 53 : 10 000 salariés et plus \n \n
Plus d'informations dans la documentation Insee
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel
et annuel, est disponible au travers de l'API Effectifs
- URSSAF Caisse nationale. Si votre jeton contient
ce droit d'accès, nous vous recommandons d'utiliser
cette API. Ces données étant protégées, leur cadre
d'utilisation est différent de la tranche effectif
fournie par l'Insee, qui elle est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif
de l'unité légale qui peut être « active » ou « cessée
» \n \n **Pour les personnes morales**, l'unité légale
est considérée comme juridiquement « cessée » si : \n
- il y a eu dépôt de la déclaration de disparition
de la personne morale ; \n - 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”) ;
\n - elle n'a plus d'établissement en activité. \n \n
**Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n -
l'exploitant de l'unité légale décède ; \n - l'exploitant
dépose une cessation d'activité. \n \n En dehors de
ces cas, l'état administratif de l'unité légale est
toujours « actif ». \n \n Plus d'informations dans la
documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire
(ESS)
description: "Indique si l'unité légale est une ESS :
\n \n - true : l'entreprise est une ESS \n - false :
l'entreprise n'est pas une ESS \n - null : le statut
ESS est inconnu. Cette information est connue pour environ
1 million d'unités légales, autrement, elle est à null.
\n \n Les unités légales de l'ESS adhèrent aux mêmes
principes : \n * poursuivre un but social autre que
le seul partage des bénéfices ; \n * une lucrativité
encadrée (notamment des bénéfices majoritairement consacrés
au maintien et au développement de l’activité) ; \n
* une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date
qui figure dans les statuts de l'entreprise qui sont
déposés au centre de formalité des entreprises (CFE)
compétent. Cette valeur est renvoyée sous format timestamp.
\n \n Pour certains établissements très anciens, tous
fermés et dont l’unité légale est cessée la date de
création peut être nulle. \n Pour les unités purgées,
la date de création n'est jamais à 'null'. Si elle est
non renseignée, elle sera au 01/01/1900. \n \n Plus
d'informations dans la documentation Insee de l'API
Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
adresse:
type: object
additionalProperties: false
title: Adresse de l'établissement
properties:
numero_voie:
title: Numéro dans la voie
type: string
example: '22'
indice_repetition_voie:
title: Indice de répétition du numéro dans la voie
description: 'Plus d''informations dans la documentation
Insee de l''API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#indicerepetitionetablissement'
type: string
nullable: true
enum:
- bis
- ter
- quarter
- quinquies
-
type_voie:
title: Type de la voie de localisation
example: RUE
description: "Le type de la voie de localisation est indiquée
en abrégé et en majuscules. L'information n'est pas
toujours renseignée. Pour certaines petites communes,
l'information n'existe pas. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#typevoieetablissement"
type: string
nullable: true
enum:
- ALLÉE
- AVENUE
- BOULEVARD
- CARREFOUR
- CHEMIN
- CHAUSSÉE
- CITÉ
- CORNICHE
- COURS
- DOMAINE
- DESCENTE
- ECART
- ESPLANADE
- FAUBOURG
- GRANDE RUE
- HAMEAU
- HALLE
- IMPASSE
- LIEU-DIT
- LOTISSEMENT
- MARCHÉ
- MONTÉE
- PASSAGE
- PLACE
- PLAINE
- PLATEAU
- PROMENADE
- PARVIS
- QUARTIER
- QUAI
- RÉSIDENCE
- RUELLE
- ROCADE
- ROND-POINT
- ROUTE
- RUE
- SENTIER
- SQUARE
- TERRE-PLEIN
- TRAVERSE
- VILLA
- VILLAGE
-
libelle_voie:
title: Libellé de la voie
type: string
example: DE LA PAIX
complement_adresse:
title: Complément d'adresse
type: string
description: Le complément d'adresse correspond à des
éléments situés à l'extérieur du bâtiment qui permettent
de compléter l'adresse (résidence, bâtiment, entrée,
etc..)
example: ZAE SAINT GUENAULT
nullable: true
code_commune:
title: Code commune
description: "Le code commune désigne le code de la commune
de localisation de l'établissement. Le code renvoyé
correspond à la date de l'appel, ce qui implique que
toute modification du code commune est repercutée sur
l'ensemble des établissements concernés, y compris ceux
qui sont fermés. Cette valeur est à 'null' pour les
entreprises à l'étranger. \n \n Les codes sont listés
dans la table d'appartenance géographique fournie par
l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028"
type: string
example: '75112'
nullable: true
code_postal:
title: Code postal
example: '75016'
type: string
nullable: true
distribution_speciale:
title: Distribution spéciale
type: string
nullable: true
description: "La distribution spéciale reprend les éléments
particuliers qui accompagnent une adresse de distribution
spéciale, la modalité la plus connue étant les adresses
en 'CEDEX'. \n \n L'Insee ne gère plus cette variable
: elle est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#distributionspecialeetablissement"
code_cedex:
title: Code cedex
type: string
nullable: true
description: "L'Insee ne gère plus cette variable : elle
est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#codecedexetablissement
\n \n Sur le sigle CEDEX lui-même : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle"
libelle_cedex:
title: Libellé du code cedex
type: string
nullable: true
description: "Ce champ indique le libellé correspondant
au code cedex de l'établissement. Si le code cedex est
à 'null', ce champ est également à 'null'. \n \n L'Insee
ne gère plus cette variable : elle est désormais toujours
à 'null'. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#libellecedexetablissement"
libelle_commune:
title: Nom de la commune pour une adresse en France
description: Cette valeur est à 'null' pour les établissements
à l'étranger.
type: string
example: PARIS 12
nullable: true
libelle_commune_etranger:
title: Nom de la commune pour une adresse à l'étranger.
description: Cette valeur est à 'null' pour les établissements
en France.
type: string
nullable: true
code_pays_etranger:
title: Code du pays pour les établissements situés à l'étranger
description: 'La nomenclature des codes pays se trouve
ici : https://www.insee.fr/fr/information/2028273'
type: string
example: '99132'
nullable: true
libelle_pays_etranger:
title: Nom du pays pour les établissements situés à l'étranger
type: string
nullable: true
example: ROYAUME-UNI
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement
diffusible : Seule une partie des données est diffusible,
suite à une demande de l'entité qui a exercé sont droit
d'opposition à la diffusion de données personnelles.
\n - Non-diffusible (obsolète) : Ce statut correspond
à l'ancien statut, toutes les entités ayant exercé leur
droit d'opposition sont normalement désormais en statut
\"partiellement diffusible\"."
acheminement_postal:
type: object
additionalProperties: false
title: Éléments constitutifs de l'adresse postale pour
son acheminement.
description: Il ne s'agit pas d'un traitement RNVP mais
simplement d'une réorganisation des éléments renvoyé
par l'Insee pour faciliter l'affichage des adresses
postales
properties:
l1:
title: Ligne 1
type: string
description: 'Si l''établissement correspond à une
personne morale : la dénomination sociale de la
personne morale. Le cas contraire: cette variable
est vide.'
nullable: true
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
l2:
title: Ligne 2
type: string
description: 'Si l''établissement correspond à une
personne physique : concaténation du nom et prénom'
nullable: true
example: JEAN MARIE DURAND
l3:
title: Ligne 3
type: string
description: Complément d'adresse comme décrit dans
la clé `complement_adresse`
nullable: true
example: ZAE SAINT GUENAULT
l4:
title: Ligne 4
type: string
description: Concaténation du numéro de voie, d'indice
de répétition, du type de voie et du libellé de
la voie
nullable: true
example: 51 BIS RUE DE LA PAIX
l5:
title: Ligne 5
type: string
description: 'Distribution spéciale comme décrit dans
la clé `distribution_speciale`, que l''Insee ne
gère plus : cette ligne est désormais toujours vide.'
nullable: true
l6:
title: Ligne 6
type: string
description: "Si le pays est en France : code postal
accompagné du libellé de la commune, sinon : libellé
de la commune de l'établissement situé à l'étranger.
\n \n Le code cedex, qui primait sur le code postal,
ne sort plus de cette ligne : l'Insee ne gère plus
cette variable."
nullable: true
example: 75012 PARIS
l7:
title: Ligne 7
type: string
description: Pays de l'établissement
nullable: true
example: FRANCE
required:
- l1
- l2
- l3
- l4
- l5
- l6
- l7
required:
- numero_voie
- indice_repetition_voie
- type_voie
- libelle_voie
- complement_adresse
- code_commune
- code_postal
- distribution_speciale
- code_cedex
- libelle_cedex
- libelle_commune
- libelle_commune_etranger
- code_pays_etranger
- libelle_pays_etranger
- status_diffusion
- acheminement_postal
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
required:
- siret
- siege_social
- etat_administratif
- date_fermeture
- activite_principale
- tranche_effectif_salarie
- status_diffusion
- diffusable_commercialement
- enseigne
- unite_legale
- adresse
- date_creation
additionalProperties: false
links:
type: object
properties:
unite_legale:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/unites_legales/130025265
description: Lien vers la ressource 'Donnée Sirene d'une unité
légale' correspondant à cette adresse d'établissement pour
obtenir les données de référence de l'unité légale.
required:
- unite_legale
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siret:
type: string
title: Siret d'origine de la requête
description: "Si la requête a été effectuée sur un siret qui
a été redirigé vers un autre siret , cette variable contient
le siret d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siret est différent du
paramètre d'appel, et cette variable est le siret d'entrée.
\n \n A noter que le siret de redirection est systématiquement
le siret du siège social de l'unité légale : en effet la
base Sirene ne possède pas la correspondance exacte entre
un siret doublon et le siret d'origine. "
example: '30613890000010'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siret
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_v3#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_v3#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_v3#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_v3#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_v3#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_v3#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social_v3#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/insee/sirene/unites_legales/130025265/siege_social?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/insee/sirene/unites_legales/{siren}/siege_social":
get:
summary: Données siège social
tags:
- Informations generales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Informations générales concernant le siège social d'une unité légale
inscrite au répertoire Sirene. Avec les données protégées des sièges sociaux
en diffusion partielle. Cette version utilise la nomenclature NAF2025 pour
l'activité principale.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Etablissement trouve
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_insee_sieges_unites_legales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siret:
title: Siret de l'établissement
type: string
example: '30613890001294'
description: Il peut arriver que le siret renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
siege_social:
type: boolean
example: true
enum:
- true
- false
description: Indique si l'établissement est le siège social
de l'entreprise.
etat_administratif:
title: État administratif de l'établissement
type: string
example: A
enum:
- A
- F
description: "Cette valeur décrit l'état administratif de
l'établissement, qui peut être : \n \n - actif. Sauf exception,
lors de son inscription au répertoire, tout établissement
est à l'état 'actif'\n\n - fermé. Cet état découle de la
prise en compte d'une déclaration de fermeture. Un établissement
fermé peut être rouvert. \n \n Plus d'informations dans
la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#etatadministratifetablissement"
date_fermeture:
title: Date de fermeture de l'établissement
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'établissement
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'un
établissement n'ayant pas encore de code APE peut se
voir affecter la valeur '00.00Z' de manière provisoire.
\n \n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'établissement
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
title: Code effectif
type: string
nullable: true
example: '51'
description: "Le code effectif correspond à la tranche
d'effectif salarié de l'établissement : \n \n - NN :
Unités non employeuses (pas de salarié au cours de l'année
de référence et pas d'effectif au 31/12). Cette tranche
peut contenir quelques effectifs inconnus \n - 00 :
0 salarié (n'ayant pas d'effectif au 31/12 mais ayant
employé des salariés au cours de l'année de référence)
\n - 01 : 1 ou 2 salariés \n - 02 : 3 à 5 salariés \n
- 03 : 6 à 9 salariés \n - 11 : 10 à 19 salariés \n
- 12 : 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999 salariés
\n - 42 : 1 000 à 1 999 salariés \n - 51 : 2 000 à 4
999 salariés \n - 52 : 5 000 à 9 999 salariés \n - 53
: 10 000 salariés et plus \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#trancheeffectifsetablissement.
\n \n L'effectif mensuel exact de l'établissement est
disponible au travers de l'[API Effectifs - URSSAF Caisse
nationale](https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement).
Si votre jeton contient ce droit d'accès, nous vous
recommandons d'utiliser cette API. Ces données étant
protégées, leur cadre d'utilisation est différent de
la tranche effectif fournie par l'Insee, qui elle est
une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si des
données protégées sont présentes dans la payload (ce qui
est le cas lorsque l'unité légale est en statut de diffusion
partielle). Pour une unité légale : \n \n - diffusible :
'true', car toutes les données sont publiques ; \n - partiellement-diffusible
: 'false', une partie des données est protégée et ne doit
pas être diffusée, pour du pré-remplissage de formulaire
public, préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète) :
'false', dans ce cas, les informations obtenues ne doivent
en aucun cas être accessibles au grand public. Ce cas n'étant
plus censé exister, préférer l'API en open data qui masque
automatiquement les données protégées. \n Plus d'informations
sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
enseigne:
title: Enseigne de l'établissement
type: string
nullable: true
description: "L'enseigne est l'appellation désignant l'emplacement
ou le local dans lequel est exercée l'activité. Un établissement
peut posséder une enseigne, plusieurs enseignes ou aucune.
\n \n Cette variable est la concaténation séparée par des
virgules des 3 champs \"renvoyés\" par l'Insee. Plus d'informations
ici: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#enseigne1etablissement-enseigne2etablissement-enseigne3etablissement"
example: Coiff Land, CoiffureLand
unite_legale:
type: object
additionalProperties: false
title: Unité légale de l'établissement
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit
différent du paramètre d'appel. Il s'agit d'une erreur
généralement temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale
est également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant
à une personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale.
Les valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique.
Les valeurs sont à 'null' pour les personnes morales.
Pour les personnes physiques, la raison sociale / dénomination
/ nom de l'entreprise correspond toujours au nom de
famille et au prénom, précédés ou suivis de la mention
"entrepreneur individuel" ou "EI". Pour en savoir plus,
consulter cette page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: Le pseudonyme correspond au nom qu'une
personne utilise pour se désigner dans l'exercice
de son activité, généralement littéraire ou artistique.
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la
vie courante. Ce prénom fait partie de ceux qui
lui ont été donnés à sa naissance et qui sont inscrits
à l'état civil.
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: Nom que la personne physique a choisi
d'utiliser.
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: Caractère féminin ou masculin de la personne
physique. Cette valeur peut ne pas être renseignée
pour une personne physique.
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n
\n - GE : Grande Entreprise \n - ETI : Entreprise de
Taille Intermédiaire \n - PME : Petite ou Moyenne Entreprise
\n \n Celle-ci peut-être 'null' dans certains cas :
quand il s’agit d’une unité légale nouvellement créée,
ou bien d’une unité légale cessée, ou encore d’une unité
légale hors champ du calcul de la catégorie (unité légale
agricole ou ne faisant pas partie du système productif).
\n \n Définition de 'catégorie d'entreprise' par l'Insee
: https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité
légale : \n \n - Diffusible : Toutes les données de
l'unité légale sont diffusibles, donc publiques. \n
- Partiellement diffusible : Seule une partie des données
est diffusible, suite à une demande de l'entité qui
a exercé sont droit d'opposition à la diffusion de données
personnelles. \n - Non-diffusible (obsolète) : Ce statut
correspond à l'ancien statut, toutes les entités ayant
exercé leur droit d'opposition sont normalement désormais
en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement
publiques et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si
des données protégées sont présentes dans la payload
(ce qui est le cas lorsque l'unité légale est en statut
de diffusion partielle). Pour une unité légale : \n
\n - diffusible : 'true', car toutes les données sont
publiques ; \n - partiellement-diffusible : 'false',
une partie des données est protégée et ne doit pas être
diffusée, pour du pré-remplissage de formulaire public,
préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète)
: 'false', dans ce cas, les informations obtenues ne
doivent en aucun cas être accessibles au grand public.
Ce cas n'étant plus censé exister, préférer l'API en
open data qui masque automatiquement les données protégées.
\n Plus d'informations sur les conditions de diffusion
: https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier
niveau de classement contient 9 grandes catégories
identifiables avec le premier chiffre du code :
\n \n - 0 : Organisme de placement collectif en
valeurs mobilières sans personnalité morale \n -
1 : Entrepreneur individuel. La catégorie juridique
des personnes physiques est '1000'. \n - 2 : Groupement
de droit privé non doté de la personnalité morale
\n - 3 : Personne morale de droit étranger \n -
4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 :
Autre personne morale immatriculée au RCS \n - 7
: Personne morale et organisme soumis au droit administratif
\n - 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des
codes fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique
de l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au
code juridique. Si le code ne correspond à aucun
libellé la valeur 'non référencé' est utilisée.
\n \n Nomenclature exhaustive fournie par l'Insee
: https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce
code de 4 chiffres + 1 lettre est extrait de la
nomenclature d'activité française (NAF) de l'Insee.
Si le code n'est pas renseigné dans la nomenclature
'Naf Rév2' (nomenclature en vigueur), le code est
null ici. \n \n À noter qu'une entreprise n'ayant
pas encore de code APE peut se voir affecter la
valeur '00.00Z' de manière provisoire. \n \n Plus
d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de
l'Insee : https://www.insee.fr/fr/information/2120875.
\n \n ⚠️ À partir de janvier 2026, le code APE utilisera
la nouvelle nomenclature NAF 2025, tel qu'explicité
dans ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par
l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en
vigueur), la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements,
la tranche d'effectif salarié n'est pas renseignée.
Il s'agit principalement d'établissements récents (créés
il y a moins de trois ans). Les délais de récolte et
traitement font que les valeurs indiquées datent de
l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche
d'effectif salarié de l'unité légale. Le nombre
de salarié est déterminé en fonction de l'effectif
de chacun des établissements de l'unité légale :
\n \n - NN : Unités non employeuses (pas de salarié
au cours de l'année de référence et pas d'effectif
au 31/12). Cette tranche peut contenir quelques
effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou
2 salariés \n - 02 : 3 à 5 salariés \n - 03 : 6
à 9 salariés \n - 11 : 10 à 19 salariés \n - 12
: 20 à 49 salariés \n - 21 : 50 à 99 salariés \n
- 22 : 100 à 199 salariés \n - 31 : 200 à 249 salariés
\n - 32 : 250 à 499 salariés \n - 41 : 500 à 999
salariés \n - 42 : 1 000 à 1 999 salariés \n - 51
: 2 000 à 4 999 salariés \n - 52 : 5 000 à 9 999
salariés \n - 53 : 10 000 salariés et plus \n \n
Plus d'informations dans la documentation Insee
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel
et annuel, est disponible au travers de l'API Effectifs
- URSSAF Caisse nationale. Si votre jeton contient
ce droit d'accès, nous vous recommandons d'utiliser
cette API. Ces données étant protégées, leur cadre
d'utilisation est différent de la tranche effectif
fournie par l'Insee, qui elle est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif
de l'unité légale qui peut être « active » ou « cessée
» \n \n **Pour les personnes morales**, l'unité légale
est considérée comme juridiquement « cessée » si : \n
- il y a eu dépôt de la déclaration de disparition
de la personne morale ; \n - 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”) ;
\n - elle n'a plus d'établissement en activité. \n \n
**Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n -
l'exploitant de l'unité légale décède ; \n - l'exploitant
dépose une cessation d'activité. \n \n En dehors de
ces cas, l'état administratif de l'unité légale est
toujours « actif ». \n \n Plus d'informations dans la
documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire
(ESS)
description: "Indique si l'unité légale est une ESS :
\n \n - true : l'entreprise est une ESS \n - false :
l'entreprise n'est pas une ESS \n - null : le statut
ESS est inconnu. Cette information est connue pour environ
1 million d'unités légales, autrement, elle est à null.
\n \n Les unités légales de l'ESS adhèrent aux mêmes
principes : \n * poursuivre un but social autre que
le seul partage des bénéfices ; \n * une lucrativité
encadrée (notamment des bénéfices majoritairement consacrés
au maintien et au développement de l’activité) ; \n
* une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE
de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date
qui figure dans les statuts de l'entreprise qui sont
déposés au centre de formalité des entreprises (CFE)
compétent. Cette valeur est renvoyée sous format timestamp.
\n \n Pour certains établissements très anciens, tous
fermés et dont l’unité légale est cessée la date de
création peut être nulle. \n Pour les unités purgées,
la date de création n'est jamais à 'null'. Si elle est
non renseignée, elle sera au 01/01/1900. \n \n Plus
d'informations dans la documentation Insee de l'API
Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
activite_principale_naf_rev2:
title: Attributs de l'activité principale en nomenclature
NAFRev2
type: object
additionalProperties: false
description: Ce champ permet de retrouver le code APE
dans l'ancienne nomenclature NAFRev2 pour assurer la
rétro-compatibilité.
properties:
code:
title: Code de l'activité principale (APE) en NAFRev2
type: string
example: 8411Z
nullable: true
libelle:
title: Libellé associé au code APE NAFRev2
type: string
nullable: false
example: Administration publique générale
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
required:
- code
- libelle
- nomenclature
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
- activite_principale_naf_rev2
adresse:
type: object
additionalProperties: false
title: Adresse de l'établissement
properties:
numero_voie:
title: Numéro dans la voie
type: string
example: '22'
indice_repetition_voie:
title: Indice de répétition du numéro dans la voie
description: 'Plus d''informations dans la documentation
Insee de l''API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#indicerepetitionetablissement'
type: string
nullable: true
enum:
- bis
- ter
- quarter
- quinquies
-
type_voie:
title: Type de la voie de localisation
example: RUE
description: "Le type de la voie de localisation est indiquée
en abrégé et en majuscules. L'information n'est pas
toujours renseignée. Pour certaines petites communes,
l'information n'existe pas. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#typevoieetablissement"
type: string
nullable: true
enum:
- ALLÉE
- AVENUE
- BOULEVARD
- CARREFOUR
- CHEMIN
- CHAUSSÉE
- CITÉ
- CORNICHE
- COURS
- DOMAINE
- DESCENTE
- ECART
- ESPLANADE
- FAUBOURG
- GRANDE RUE
- HAMEAU
- HALLE
- IMPASSE
- LIEU-DIT
- LOTISSEMENT
- MARCHÉ
- MONTÉE
- PASSAGE
- PLACE
- PLAINE
- PLATEAU
- PROMENADE
- PARVIS
- QUARTIER
- QUAI
- RÉSIDENCE
- RUELLE
- ROCADE
- ROND-POINT
- ROUTE
- RUE
- SENTIER
- SQUARE
- TERRE-PLEIN
- TRAVERSE
- VILLA
- VILLAGE
-
libelle_voie:
title: Libellé de la voie
type: string
example: DE LA PAIX
complement_adresse:
title: Complément d'adresse
type: string
description: Le complément d'adresse correspond à des
éléments situés à l'extérieur du bâtiment qui permettent
de compléter l'adresse (résidence, bâtiment, entrée,
etc..)
example: ZAE SAINT GUENAULT
nullable: true
code_commune:
title: Code commune
description: "Le code commune désigne le code de la commune
de localisation de l'établissement. Le code renvoyé
correspond à la date de l'appel, ce qui implique que
toute modification du code commune est repercutée sur
l'ensemble des établissements concernés, y compris ceux
qui sont fermés. Cette valeur est à 'null' pour les
entreprises à l'étranger. \n \n Les codes sont listés
dans la table d'appartenance géographique fournie par
l'Insee et disponible ici: https://www.insee.fr/fr/information/2028028"
type: string
example: '75112'
nullable: true
code_postal:
title: Code postal
example: '75016'
type: string
nullable: true
distribution_speciale:
title: Distribution spéciale
type: string
nullable: true
description: "La distribution spéciale reprend les éléments
particuliers qui accompagnent une adresse de distribution
spéciale, la modalité la plus connue étant les adresses
en 'CEDEX'. \n \n L'Insee ne gère plus cette variable
: elle est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#distributionspecialeetablissement"
code_cedex:
title: Code cedex
type: string
nullable: true
description: "L'Insee ne gère plus cette variable : elle
est désormais toujours à 'null'. \n \n Plus d'informations
dans la documentation Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#codecedexetablissement
\n \n Sur le sigle CEDEX lui-même : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle"
libelle_cedex:
title: Libellé du code cedex
type: string
nullable: true
description: "Ce champ indique le libellé correspondant
au code cedex de l'établissement. Si le code cedex est
à 'null', ce champ est également à 'null'. \n \n L'Insee
ne gère plus cette variable : elle est désormais toujours
à 'null'. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=754efef5-1e50-41d3-8efe-f51e5071d320#libellecedexetablissement"
libelle_commune:
title: Nom de la commune pour une adresse en France
description: Cette valeur est à 'null' pour les établissements
à l'étranger.
type: string
example: PARIS 12
nullable: true
libelle_commune_etranger:
title: Nom de la commune pour une adresse à l'étranger.
description: Cette valeur est à 'null' pour les établissements
en France.
type: string
nullable: true
code_pays_etranger:
title: Code du pays pour les établissements situés à l'étranger
description: 'La nomenclature des codes pays se trouve
ici : https://www.insee.fr/fr/information/2028273'
type: string
example: '99132'
nullable: true
libelle_pays_etranger:
title: Nom du pays pour les établissements situés à l'étranger
type: string
nullable: true
example: ROYAUME-UNI
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'établissement
: \n \n - Diffusible : Toutes les données de l'établissement
sont diffusibles, donc publiques. \n - Partiellement
diffusible : Seule une partie des données est diffusible,
suite à une demande de l'entité qui a exercé sont droit
d'opposition à la diffusion de données personnelles.
\n - Non-diffusible (obsolète) : Ce statut correspond
à l'ancien statut, toutes les entités ayant exercé leur
droit d'opposition sont normalement désormais en statut
\"partiellement diffusible\"."
acheminement_postal:
type: object
additionalProperties: false
title: Éléments constitutifs de l'adresse postale pour
son acheminement.
description: Il ne s'agit pas d'un traitement RNVP mais
simplement d'une réorganisation des éléments renvoyé
par l'Insee pour faciliter l'affichage des adresses
postales
properties:
l1:
title: Ligne 1
type: string
description: 'Si l''établissement correspond à une
personne morale : la dénomination sociale de la
personne morale. Le cas contraire: cette variable
est vide.'
nullable: true
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
l2:
title: Ligne 2
type: string
description: 'Si l''établissement correspond à une
personne physique : concaténation du nom et prénom'
nullable: true
example: JEAN MARIE DURAND
l3:
title: Ligne 3
type: string
description: Complément d'adresse comme décrit dans
la clé `complement_adresse`
nullable: true
example: ZAE SAINT GUENAULT
l4:
title: Ligne 4
type: string
description: Concaténation du numéro de voie, d'indice
de répétition, du type de voie et du libellé de
la voie
nullable: true
example: 51 BIS RUE DE LA PAIX
l5:
title: Ligne 5
type: string
description: 'Distribution spéciale comme décrit dans
la clé `distribution_speciale`, que l''Insee ne
gère plus : cette ligne est désormais toujours vide.'
nullable: true
l6:
title: Ligne 6
type: string
description: "Si le pays est en France : code postal
accompagné du libellé de la commune, sinon : libellé
de la commune de l'établissement situé à l'étranger.
\n \n Le code cedex, qui primait sur le code postal,
ne sort plus de cette ligne : l'Insee ne gère plus
cette variable."
nullable: true
example: 75012 PARIS
l7:
title: Ligne 7
type: string
description: Pays de l'établissement
nullable: true
example: FRANCE
required:
- l1
- l2
- l3
- l4
- l5
- l6
- l7
required:
- numero_voie
- indice_repetition_voie
- type_voie
- libelle_voie
- complement_adresse
- code_commune
- code_postal
- distribution_speciale
- code_cedex
- libelle_cedex
- libelle_commune
- libelle_commune_etranger
- code_pays_etranger
- libelle_pays_etranger
- status_diffusion
- acheminement_postal
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
activite_principale_naf_rev2:
title: Attributs de l'activité principale en nomenclature
NAFRev2
type: object
additionalProperties: false
description: Ce champ permet de retrouver le code APE dans
l'ancienne nomenclature NAFRev2 pour assurer la rétro-compatibilité.
properties:
code:
title: Code de l'activité principale (APE) en NAFRev2
type: string
example: 8411Z
nullable: true
libelle:
title: Libellé associé au code APE NAFRev2
type: string
nullable: false
example: Administration publique générale
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
required:
- code
- libelle
- nomenclature
required:
- siret
- siege_social
- etat_administratif
- date_fermeture
- activite_principale
- tranche_effectif_salarie
- status_diffusion
- diffusable_commercialement
- enseigne
- unite_legale
- adresse
- date_creation
- activite_principale_naf_rev2
additionalProperties: false
links:
type: object
properties:
unite_legale:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/unites_legales/130025265
description: Lien vers la ressource 'Donnée Sirene d'une unité
légale' correspondant à cette adresse d'établissement pour
obtenir les données de référence de l'unité légale.
required:
- unite_legale
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siret:
type: string
title: Siret d'origine de la requête
description: "Si la requête a été effectuée sur un siret qui
a été redirigé vers un autre siret , cette variable contient
le siret d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siret est différent du
paramètre d'appel, et cette variable est le siret d'entrée.
\n \n A noter que le siret de redirection est systématiquement
le siret du siège social de l'unité légale : en effet la
base Sirene ne possède pas la correspondance exacte entre
un siret doublon et le siret d'origine. "
example: '30613890000010'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siret
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouve
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_sieges_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/siege_social#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/insee/sirene/unites_legales/130025265/siege_social?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/insee/sirene/etablissements/{siret}/successions":
get:
summary: Liens de succession
tags:
- Informations générales
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Liste des prédécesseurs et successeurs d'un établissement.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_successions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/successions#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_successions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/successions#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_successions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/successions#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Successions trouvées
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_insee_successions
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
predecesseurs:
title: Établissements prédécesseurs
description: Liste des établissements prédécesseurs de l'établissement
appelé.
type: array
items:
type: object
properties:
siret:
title: SIRET
type: string
example: '30613890001294'
description: SIRET de l'établissement prédécesseur.
date_succession:
title: Date d'effet du lien de succession
type: date
example: '2021-10-15'
description: Date à laquelle la succession a eu lieu.
transfert_siege:
title: Transfert de siège
type: boolean
example: true
description: 'Indique si la succession est un transfert
de siège. Pour en savoir plus, consulter cette rubrique
: http://entreprise.api.gouv.fr/catalogue/insee/successions#definition-transfert-siege.'
continuite_economique:
title: Continuité économique
type: boolean
example: true
description: 'Indique si la succession est une continuité
économique. Pour en savoir plus, consulter cette rubrique
: http://entreprise.api.gouv.fr/catalogue/insee/successions#definition-continuite-economique.'
successeurs:
title: Établissements successeurs
description: Liste des établissements successeurs de l'établissement
appelé.
type: array
items:
type: object
properties:
siret:
title: SIRET
type: string
example: '30613890001294'
description: SIRET de l'établissement successeur.
date_succession:
title: Date d'effet du lien de succession
type: date
example: '2021-10-15'
description: Date à laquelle la succession a eu lieu.
transfert_siege:
title: Transfert de siège
type: boolean
example: true
description: 'Indique si la succession est un transfert
de siège. Pour en savoir plus, consulter cette rubrique
: http://entreprise.api.gouv.fr/catalogue/insee/successions#definition-transfert-siege.'
continuite_economique:
title: Continuité économique
type: boolean
example: true
description: 'Indique si la succession est une continuité
économique. Pour en savoir plus, consulter cette rubrique
: http://entreprise.api.gouv.fr/catalogue/insee/successions#definition-continuite-economique.'
required:
- predecesseurs
- successeurs
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_successions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/successions#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_successions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/successions#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_successions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/successions#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_successions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/successions#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_successions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/successions#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_successions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/successions#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_successions, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/successions#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/insee/sirene/etablissements/13002526500013/successions?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/insee/sirene/unites_legales/{siren}":
get:
summary: Données unité légale
tags:
- Informations générales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
deprecated: true
security:
- jwt_bearer_token: []
description: Informations de référence d'une unité légale (entreprise, association
ou administration) inscrite au répertoire Sirene. Avec les données protégées
des unités légales en diffusion partielle.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_v3#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_v3#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_v3#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Unité légale trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_insee_unites_legales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale est
également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant à une
personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale. Les
valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique. Les
valeurs sont à 'null' pour les personnes morales. Pour les
personnes physiques, la raison sociale / dénomination /
nom de l'entreprise correspond toujours au nom de famille
et au prénom, précédés ou suivis de la mention "entrepreneur
individuel" ou "EI". Pour en savoir plus, consulter cette
page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: Le pseudonyme correspond au nom qu'une personne
utilise pour se désigner dans l'exercice de son activité,
généralement littéraire ou artistique.
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la vie
courante. Ce prénom fait partie de ceux qui lui ont
été donnés à sa naissance et qui sont inscrits à l'état
civil.
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: Nom que la personne physique a choisi d'utiliser.
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: Caractère féminin ou masculin de la personne
physique. Cette valeur peut ne pas être renseignée pour
une personne physique.
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n \n
- GE : Grande Entreprise \n - ETI : Entreprise de Taille
Intermédiaire \n - PME : Petite ou Moyenne Entreprise \n
\n Celle-ci peut-être 'null' dans certains cas : quand il
s’agit d’une unité légale nouvellement créée, ou bien d’une
unité légale cessée, ou encore d’une unité légale hors champ
du calcul de la catégorie (unité légale agricole ou ne faisant
pas partie du système productif). \n \n Définition de 'catégorie
d'entreprise' par l'Insee : https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité légale
: \n \n - Diffusible : Toutes les données de l'unité légale
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si des
données protégées sont présentes dans la payload (ce qui
est le cas lorsque l'unité légale est en statut de diffusion
partielle). Pour une unité légale : \n \n - diffusible :
'true', car toutes les données sont publiques ; \n - partiellement-diffusible
: 'false', une partie des données est protégée et ne doit
pas être diffusée, pour du pré-remplissage de formulaire
public, préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète) :
'false', dans ce cas, les informations obtenues ne doivent
en aucun cas être accessibles au grand public. Ce cas n'étant
plus censé exister, préférer l'API en open data qui masque
automatiquement les données protégées. \n Plus d'informations
sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier niveau
de classement contient 9 grandes catégories identifiables
avec le premier chiffre du code : \n \n - 0 : Organisme
de placement collectif en valeurs mobilières sans personnalité
morale \n - 1 : Entrepreneur individuel. La catégorie
juridique des personnes physiques est '1000'. \n - 2
: Groupement de droit privé non doté de la personnalité
morale \n - 3 : Personne morale de droit étranger \n
- 4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 : Autre
personne morale immatriculée au RCS \n - 7 : Personne
morale et organisme soumis au droit administratif \n
- 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des codes
fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique de
l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au code
juridique. Si le code ne correspond à aucun libellé
la valeur 'non référencé' est utilisée. \n \n Nomenclature
exhaustive fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'une
entreprise n'ayant pas encore de code APE peut se voir
affecter la valeur '00.00Z' de manière provisoire. \n
\n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche d'effectif
salarié de l'unité légale. Le nombre de salarié est
déterminé en fonction de l'effectif de chacun des établissements
de l'unité légale : \n \n - NN : Unités non employeuses
(pas de salarié au cours de l'année de référence et
pas d'effectif au 31/12). Cette tranche peut contenir
quelques effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou 2 salariés
\n - 02 : 3 à 5 salariés \n - 03 : 6 à 9 salariés \n
- 11 : 10 à 19 salariés \n - 12 : 20 à 49 salariés \n
- 21 : 50 à 99 salariés \n - 22 : 100 à 199 salariés
\n - 31 : 200 à 249 salariés \n - 32 : 250 à 499 salariés
\n - 41 : 500 à 999 salariés \n - 42 : 1 000 à 1 999
salariés \n - 51 : 2 000 à 4 999 salariés \n - 52 :
5 000 à 9 999 salariés \n - 53 : 10 000 salariés et
plus \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel et annuel,
est disponible au travers de l'API Effectifs - URSSAF
Caisse nationale. Si votre jeton contient ce droit d'accès,
nous vous recommandons d'utiliser cette API. Ces données
étant protégées, leur cadre d'utilisation est différent
de la tranche effectif fournie par l'Insee, qui elle
est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif de
l'unité légale qui peut être « active » ou « cessée » \n
\n **Pour les personnes morales**, l'unité légale est considérée
comme juridiquement « cessée » si : \n - il y a eu dépôt
de la déclaration de disparition de la personne morale
; \n - 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”) ; \n - elle n'a plus d'établissement en activité.
\n \n **Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n - l'exploitant
de l'unité légale décède ; \n - l'exploitant dépose une
cessation d'activité. \n \n En dehors de ces cas, l'état
administratif de l'unité légale est toujours « actif ».
\n \n Plus d'informations dans la documentation Insee de
l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire (ESS)
description: "Indique si l'unité légale est une ESS : \n \n
- true : l'entreprise est une ESS \n - false : l'entreprise
n'est pas une ESS \n - null : le statut ESS est inconnu.
Cette information est connue pour environ 1 million d'unités
légales, autrement, elle est à null. \n \n Les unités légales
de l'ESS adhèrent aux mêmes principes : \n * poursuivre
un but social autre que le seul partage des bénéfices ;
\n * une lucrativité encadrée (notamment des bénéfices majoritairement
consacrés au maintien et au développement de l’activité)
; \n * une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE de
l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
date_cessation:
title: Date de cessation de l'unité légale
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp.
Si l'entreprise est juridique active, cette valeur est à
'null'.
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
- date_cessation
additionalProperties: false
links:
type: object
properties:
siege_social:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/etablissements/30613890001294
description: Lien vers la ressource 'Données de référence
d'un établissement' correspondant au siège social de cette
unité légale.
siege_social_adresse:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/etablissements/30613890001294/adresse
description: Lien vers la ressource 'Adresse d'un établissement'
correspondant au siège social de cette unité légale.
required:
- siege_social
- siege_social_adresse
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siren:
type: string
title: Siren d'origine de la requête
description: "Si la requête a été effectuée sur un siren qui
a été redirigé vers un autre siren, cette variable contient
le siren d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siren est différent du
paramètre d'appel, et cette variable est le siren d'entrée."
example: '306138900'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siren
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_v3#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_v3#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_v3#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_v3#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'451':
description: |-
Indisponible pour des raisons légales
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_v3#erreurs.
content:
application/json:
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_v3#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_v3#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_v3#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/insee/sirene/unites_legales/130025265?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/insee/sirene/unites_legales/{siren}":
get:
summary: Données unité légale
tags:
- Informations générales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Informations de référence d'une unité légale (entreprise, association
ou administration) inscrite au répertoire Sirene. Avec les données protégées
des unités légales en diffusion partielle. Cette version utilise la nomenclature
NAF2025 pour l'activité principale.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Unité légale trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_insee_unites_legales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale est
également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant à une
personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale. Les
valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique. Les
valeurs sont à 'null' pour les personnes morales. Pour les
personnes physiques, la raison sociale / dénomination /
nom de l'entreprise correspond toujours au nom de famille
et au prénom, précédés ou suivis de la mention "entrepreneur
individuel" ou "EI". Pour en savoir plus, consulter cette
page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: Le pseudonyme correspond au nom qu'une personne
utilise pour se désigner dans l'exercice de son activité,
généralement littéraire ou artistique.
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la vie
courante. Ce prénom fait partie de ceux qui lui ont
été donnés à sa naissance et qui sont inscrits à l'état
civil.
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: Nom que la personne physique a choisi d'utiliser.
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: Caractère féminin ou masculin de la personne
physique. Cette valeur peut ne pas être renseignée pour
une personne physique.
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n \n
- GE : Grande Entreprise \n - ETI : Entreprise de Taille
Intermédiaire \n - PME : Petite ou Moyenne Entreprise \n
\n Celle-ci peut-être 'null' dans certains cas : quand il
s’agit d’une unité légale nouvellement créée, ou bien d’une
unité légale cessée, ou encore d’une unité légale hors champ
du calcul de la catégorie (unité légale agricole ou ne faisant
pas partie du système productif). \n \n Définition de 'catégorie
d'entreprise' par l'Insee : https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité légale
: \n \n - Diffusible : Toutes les données de l'unité légale
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ permet de savoir s'il est possible
de diffuser les données sans restriction ou bien si des
données protégées sont présentes dans la payload (ce qui
est le cas lorsque l'unité légale est en statut de diffusion
partielle). Pour une unité légale : \n \n - diffusible :
'true', car toutes les données sont publiques ; \n - partiellement-diffusible
: 'false', une partie des données est protégée et ne doit
pas être diffusée, pour du pré-remplissage de formulaire
public, préférer l'API en open data qui masque automatiquement
les données protégées ; \n - non-diffusible (obsolète) :
'false', dans ce cas, les informations obtenues ne doivent
en aucun cas être accessibles au grand public. Ce cas n'étant
plus censé exister, préférer l'API en open data qui masque
automatiquement les données protégées. \n Plus d'informations
sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier niveau
de classement contient 9 grandes catégories identifiables
avec le premier chiffre du code : \n \n - 0 : Organisme
de placement collectif en valeurs mobilières sans personnalité
morale \n - 1 : Entrepreneur individuel. La catégorie
juridique des personnes physiques est '1000'. \n - 2
: Groupement de droit privé non doté de la personnalité
morale \n - 3 : Personne morale de droit étranger \n
- 4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 : Autre
personne morale immatriculée au RCS \n - 7 : Personne
morale et organisme soumis au droit administratif \n
- 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des codes
fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique de
l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au code
juridique. Si le code ne correspond à aucun libellé
la valeur 'non référencé' est utilisée. \n \n Nomenclature
exhaustive fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'une
entreprise n'ayant pas encore de code APE peut se voir
affecter la valeur '00.00Z' de manière provisoire. \n
\n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche d'effectif
salarié de l'unité légale. Le nombre de salarié est
déterminé en fonction de l'effectif de chacun des établissements
de l'unité légale : \n \n - NN : Unités non employeuses
(pas de salarié au cours de l'année de référence et
pas d'effectif au 31/12). Cette tranche peut contenir
quelques effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou 2 salariés
\n - 02 : 3 à 5 salariés \n - 03 : 6 à 9 salariés \n
- 11 : 10 à 19 salariés \n - 12 : 20 à 49 salariés \n
- 21 : 50 à 99 salariés \n - 22 : 100 à 199 salariés
\n - 31 : 200 à 249 salariés \n - 32 : 250 à 499 salariés
\n - 41 : 500 à 999 salariés \n - 42 : 1 000 à 1 999
salariés \n - 51 : 2 000 à 4 999 salariés \n - 52 :
5 000 à 9 999 salariés \n - 53 : 10 000 salariés et
plus \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel et annuel,
est disponible au travers de l'API Effectifs - URSSAF
Caisse nationale. Si votre jeton contient ce droit d'accès,
nous vous recommandons d'utiliser cette API. Ces données
étant protégées, leur cadre d'utilisation est différent
de la tranche effectif fournie par l'Insee, qui elle
est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif de
l'unité légale qui peut être « active » ou « cessée » \n
\n **Pour les personnes morales**, l'unité légale est considérée
comme juridiquement « cessée » si : \n - il y a eu dépôt
de la déclaration de disparition de la personne morale
; \n - 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”) ; \n - elle n'a plus d'établissement en activité.
\n \n **Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n - l'exploitant
de l'unité légale décède ; \n - l'exploitant dépose une
cessation d'activité. \n \n En dehors de ces cas, l'état
administratif de l'unité légale est toujours « actif ».
\n \n Plus d'informations dans la documentation Insee de
l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire (ESS)
description: "Indique si l'unité légale est une ESS : \n \n
- true : l'entreprise est une ESS \n - false : l'entreprise
n'est pas une ESS \n - null : le statut ESS est inconnu.
Cette information est connue pour environ 1 million d'unités
légales, autrement, elle est à null. \n \n Les unités légales
de l'ESS adhèrent aux mêmes principes : \n * poursuivre
un but social autre que le seul partage des bénéfices ;
\n * une lucrativité encadrée (notamment des bénéfices majoritairement
consacrés au maintien et au développement de l’activité)
; \n * une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE de
l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
activite_principale_naf_rev2:
title: Attributs de l'activité principale en nomenclature
NAFRev2
type: object
additionalProperties: false
description: Ce champ permet de retrouver le code APE dans
l'ancienne nomenclature NAFRev2 pour assurer la rétro-compatibilité.
properties:
code:
title: Code de l'activité principale (APE) en NAFRev2
type: string
example: 8411Z
nullable: true
libelle:
title: Libellé associé au code APE NAFRev2
type: string
nullable: false
example: Administration publique générale
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
required:
- code
- libelle
- nomenclature
date_cessation:
title: Date de cessation de l'unité légale
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp.
Si l'entreprise est juridique active, cette valeur est à
'null'.
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
- activite_principale_naf_rev2
- date_cessation
additionalProperties: false
links:
type: object
properties:
siege_social:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/etablissements/30613890001294
description: Lien vers la ressource 'Données de référence
d'un établissement' correspondant au siège social de cette
unité légale.
siege_social_adresse:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/etablissements/30613890001294/adresse
description: Lien vers la ressource 'Adresse d'un établissement'
correspondant au siège social de cette unité légale.
required:
- siege_social
- siege_social_adresse
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siren:
type: string
title: Siren d'origine de la requête
description: "Si la requête a été effectuée sur un siren qui
a été redirigé vers un autre siren, cette variable contient
le siren d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siren est différent du
paramètre d'appel, et cette variable est le siren d'entrée."
example: '306138900'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siren
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'451':
description: |-
Indisponible pour des raisons légales
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales#erreurs.
content:
application/json:
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/insee/sirene/unites_legales/130025265?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/insee/sirene/unites_legales/diffusibles/{siren}":
get:
summary: Données unité légale en open data
tags:
- Informations générales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
deprecated: true
security:
- jwt_bearer_token: []
description: Informations de référence publiques d'une unité légale (entreprise,
association ou administration) inscrite au répertoire Sirene.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles_v3#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles_v3#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles_v3#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Unité légale trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_insee_unites_legales_diffusables
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale est
également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant à une
personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale. Les
valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
description: Si la personne morale est en diffusion partielle,
le sigle n'est pas renvoyé, et la valeur est remplacée
par "[ND]".
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique. Les
valeurs sont à 'null' pour les personnes morales. Pour les
personnes physiques, la raison sociale / dénomination /
nom de l'entreprise correspond toujours au nom de famille
et au prénom, précédés ou suivis de la mention "entrepreneur
individuel" ou "EI". Pour en savoir plus, consulter cette
page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: "Le pseudonyme correspond au nom qu'une personne
utilise pour se désigner dans l'exercice de son activité,
généralement littéraire ou artistique. \n Si la personne
physique est en diffusion partielle, le pseudonyme n'est
pas renvoyé et la valeur est remplacée par \"[ND]\"."
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: "Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la vie
courante. Ce prénom fait partie de ceux qui lui ont
été donnés à sa naissance et qui sont inscrits à l'état
civil. \n Si la personne physique est en diffusion partielle,
le prénom usuel n'est pas renvoyé et la valeur est remplacée
par \"[ND]\"."
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: "Nom que la personne physique a choisi d'utiliser.
\n Si la personne physique est en diffusion partielle,
le nom d'usage n'est pas renvoyé et la valeur est remplacée
par \"[ND]\"."
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
description: Si la personne physique est en diffusion
partielle, le nom de naissance n'est pas renvoyé et
la valeur est remplacée par "[ND]".
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: "Caractère féminin ou masculin de la personne
physique. Cette valeur peut ne pas être renseignée pour
une personne physique. \n Si la personne physique est
en diffusion partielle, la valeur est remplacée par
\"[ND]\"."
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n \n
- GE : Grande Entreprise \n - ETI : Entreprise de Taille
Intermédiaire \n - PME : Petite ou Moyenne Entreprise \n
\n Celle-ci peut-être 'null' dans certains cas : quand il
s’agit d’une unité légale nouvellement créée, ou bien d’une
unité légale cessée, ou encore d’une unité légale hors champ
du calcul de la catégorie (unité légale agricole ou ne faisant
pas partie du système productif). \n \n Définition de 'catégorie
d'entreprise' par l'Insee : https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité légale
: \n \n - Diffusible : Toutes les données de l'unité légale
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ est a priori toujours à 'true' car
cette API ne renvoie que de l'open data. Pour une unité
légale : \n \n - diffusible : 'true', car toutes les données
sont publiques ; \n - partiellement-diffusible : 'true'.
Dans ce cas, les informations protégées suite au droit d'opposition
sont masquées par la chaîne de caractère '[ND]' ; \n Plus
d'informations sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier niveau
de classement contient 9 grandes catégories identifiables
avec le premier chiffre du code : \n \n - 0 : Organisme
de placement collectif en valeurs mobilières sans personnalité
morale \n - 1 : Entrepreneur individuel. La catégorie
juridique des personnes physiques est '1000'. \n - 2
: Groupement de droit privé non doté de la personnalité
morale \n - 3 : Personne morale de droit étranger \n
- 4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 : Autre
personne morale immatriculée au RCS \n - 7 : Personne
morale et organisme soumis au droit administratif \n
- 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des codes
fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique de
l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au code
juridique. Si le code ne correspond à aucun libellé
la valeur 'non référencé' est utilisée. \n \n Nomenclature
exhaustive fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'une
entreprise n'ayant pas encore de code APE peut se voir
affecter la valeur '00.00Z' de manière provisoire. \n
\n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche d'effectif
salarié de l'unité légale. Le nombre de salarié est
déterminé en fonction de l'effectif de chacun des établissements
de l'unité légale : \n \n - NN : Unités non employeuses
(pas de salarié au cours de l'année de référence et
pas d'effectif au 31/12). Cette tranche peut contenir
quelques effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou 2 salariés
\n - 02 : 3 à 5 salariés \n - 03 : 6 à 9 salariés \n
- 11 : 10 à 19 salariés \n - 12 : 20 à 49 salariés \n
- 21 : 50 à 99 salariés \n - 22 : 100 à 199 salariés
\n - 31 : 200 à 249 salariés \n - 32 : 250 à 499 salariés
\n - 41 : 500 à 999 salariés \n - 42 : 1 000 à 1 999
salariés \n - 51 : 2 000 à 4 999 salariés \n - 52 :
5 000 à 9 999 salariés \n - 53 : 10 000 salariés et
plus \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel et annuel,
est disponible au travers de l'API Effectifs - URSSAF
Caisse nationale. Si votre jeton contient ce droit d'accès,
nous vous recommandons d'utiliser cette API. Ces données
étant protégées, leur cadre d'utilisation est différent
de la tranche effectif fournie par l'Insee, qui elle
est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif de
l'unité légale qui peut être « active » ou « cessée » \n
\n **Pour les personnes morales**, l'unité légale est considérée
comme juridiquement « cessée » si : \n - il y a eu dépôt
de la déclaration de disparition de la personne morale
; \n - 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”) ; \n - elle n'a plus d'établissement en activité.
\n \n **Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n - l'exploitant
de l'unité légale décède ; \n - l'exploitant dépose une
cessation d'activité. \n \n En dehors de ces cas, l'état
administratif de l'unité légale est toujours « actif ».
\n \n Plus d'informations dans la documentation Insee de
l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire (ESS)
description: "Indique si l'unité légale est une ESS : \n \n
- true : l'entreprise est une ESS \n - false : l'entreprise
n'est pas une ESS \n - null : le statut ESS est inconnu.
Cette information est connue pour environ 1 million d'unités
légales, autrement, elle est à null. \n \n Les unités légales
de l'ESS adhèrent aux mêmes principes : \n * poursuivre
un but social autre que le seul partage des bénéfices ;
\n * une lucrativité encadrée (notamment des bénéfices majoritairement
consacrés au maintien et au développement de l’activité)
; \n * une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE de
l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
date_cessation:
title: Date de cessation de l'unité légale
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp.
Si l'entreprise est juridique active, cette valeur est à
'null'.
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
- date_cessation
additionalProperties: false
links:
type: object
properties:
siege_social:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/etablissements/30613890001294
description: Lien vers la ressource 'Données de référence
d'un établissement' correspondant au siège social de cette
unité légale.
siege_social_adresse:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/etablissements/30613890001294/adresse
description: Lien vers la ressource 'Adresse d'un établissement'
correspondant au siège social de cette unité légale.
required:
- siege_social
- siege_social_adresse
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siren:
type: string
title: Siren d'origine de la requête
description: "Si la requête a été effectuée sur un siren qui
a été redirigé vers un autre siren, cette variable contient
le siren d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siren est différent du
paramètre d'appel, et cette variable est le siren d'entrée."
example: '306138900'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siren
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles_v3#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles_v3#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles_v3#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles_v3#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'451':
description: |-
Indisponible pour des raisons légales
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles_v3#erreurs.
content:
application/json:
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles_v3#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles_v3#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles_v3#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/insee/sirene/unites_legales/diffusibles/130025265?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/insee/sirene/unites_legales/diffusibles/{siren}":
get:
summary: Données unité légale en open data
tags:
- Informations générales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Informations de référence publiques d'une unité légale (entreprise,
association ou administration) inscrite au répertoire Sirene. Cette version
utilise la nomenclature NAF2025 pour l'activité principale.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Unite legale trouvee
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_insee_unites_legales_diffusables
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
siren:
title: Siren de l'unité légale
description: Il peut arriver que le siren renvoyé soit différent
du paramètre d'appel. Il s'agit d'une erreur généralement
temporaire dans la base de données Sirene.
type: string
example: '130025265'
rna:
title: Numéro RNA de l'unité légale
description: Ce champ n'est rempli que si l'unité légale est
également une association enregistré dans le RNA.
type: string
example: W751004076
nullable: true
siret_siege_social:
title: SIRET du siège social
type: string
example: '13002526500013'
type:
title: Type de personne
type: string
enum:
- personne_physique
- personne_morale
example: personne_morale
description: 'Indique si l''unité légale est une personne
morale ou une personne physique. Cette valeur est déterminée
à l''aide du code juridique : ''1000'' correspondant à une
personne physique.'
personne_morale_attributs:
type: object
additionalProperties: false
title: Attributs de la personne morale
description: Attributs associés à la personne morale. Les
valeurs sont à 'null' pour les personnes physiques.
properties:
raison_sociale:
title: Raison sociale de l'unité légale
type: string
example: DIRECTION INTERMINISTERIELLE DU NUMERIQUE
nullable: true
sigle:
title: Sigle de l'unité légale
type: string
example: DINUM
nullable: true
description: Si la personne morale est en diffusion partielle,
le sigle n'est pas renvoyé, et la valeur est remplacée
par "[ND]".
required:
- raison_sociale
- sigle
personne_physique_attributs:
type: object
additionalProperties: false
title: Attributs de la personne physique
description: Attributs associés à la personne physique. Les
valeurs sont à 'null' pour les personnes morales. Pour les
personnes physiques, la raison sociale / dénomination /
nom de l'entreprise correspond toujours au nom de famille
et au prénom, précédés ou suivis de la mention "entrepreneur
individuel" ou "EI". Pour en savoir plus, consulter cette
page du site service-public.fr https://entreprendre.service-public.fr/vosdroits/F23283/personnalisation/resultat
properties:
pseudonyme:
title: Pseudonyme
type: string
example: DJ Falcon
nullable: true
description: "Le pseudonyme correspond au nom qu'une personne
utilise pour se désigner dans l'exercice de son activité,
généralement littéraire ou artistique. \n Si la personne
physique est en diffusion partielle, le pseudonyme n'est
pas renvoyé et la valeur est remplacée par \"[ND]\"."
prenom_usuel:
title: Prénom usuel
type: string
example: Jean
nullable: true
description: "Le prénom usuel est le prénom par lequel
une personne choisit de se faire appeler dans la vie
courante. Ce prénom fait partie de ceux qui lui ont
été donnés à sa naissance et qui sont inscrits à l'état
civil. \n Si la personne physique est en diffusion partielle,
le prénom usuel n'est pas renvoyé et la valeur est remplacée
par \"[ND]\"."
prenom_1:
title: Prénom numéro 1 déclaré
type: string
example: Jean
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_2:
title: Prénom numéro 2 déclaré
type: string
example: Jacques
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_3:
title: Prénom numéro 3 déclaré
type: string
example: Pierre
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
prenom_4:
title: Prénom numéro 4 déclaré
type: string
example: Paul
nullable: true
description: Si la personne physique est en diffusion
partielle, le prénom n'est pas renvoyé et la valeur
est remplacée par "[ND]".
nom_usage:
title: Nom d'usage
type: string
example: Dupont
nullable: true
description: "Nom que la personne physique a choisi d'utiliser.
\n Si la personne physique est en diffusion partielle,
le nom d'usage n'est pas renvoyé et la valeur est remplacée
par \"[ND]\"."
nom_naissance:
title: Nom de naissance
type: string
example: Martin
nullable: true
description: Si la personne physique est en diffusion
partielle, le nom de naissance n'est pas renvoyé et
la valeur est remplacée par "[ND]".
sexe:
title: Genre
type: string
example: M
enum:
- M
- F
nullable: true
description: "Caractère féminin ou masculin de la personne
physique. Cette valeur peut ne pas être renseignée pour
une personne physique. \n Si la personne physique est
en diffusion partielle, la valeur est remplacée par
\"[ND]\"."
required:
- pseudonyme
- prenom_usuel
- prenom_1
- prenom_2
- prenom_3
- prenom_4
- nom_usage
- nom_naissance
- sexe
categorie_entreprise:
title: Catégorie de l'unité légale
type: string
example: GE
nullable: true
enum:
- GE
- ETI
- PME
description: "Il s'agit d'une variable statistique calculée
par l'Insee. Elle ne peut prendre que 3 valeurs : \n \n
- GE : Grande Entreprise \n - ETI : Entreprise de Taille
Intermédiaire \n - PME : Petite ou Moyenne Entreprise \n
\n Celle-ci peut-être 'null' dans certains cas : quand il
s’agit d’une unité légale nouvellement créée, ou bien d’une
unité légale cessée, ou encore d’une unité légale hors champ
du calcul de la catégorie (unité légale agricole ou ne faisant
pas partie du système productif). \n \n Définition de 'catégorie
d'entreprise' par l'Insee : https://www.insee.fr/fr/metadonnees/definition/c1057"
status_diffusion:
title: Statut de la diffusion
type: string
enum:
- diffusible
- partiellement_diffusible
- non_diffusible
description: "Indique le statut de diffusion de l'unité légale
: \n \n - Diffusible : Toutes les données de l'unité légale
sont diffusibles, donc publiques. \n - Partiellement diffusible
: Seule une partie des données est diffusible, suite à une
demande de l'entité qui a exercé sont droit d'opposition
à la diffusion de données personnelles. \n - Non-diffusible
(obsolète) : Ce statut correspond à l'ancien statut, toutes
les entités ayant exercé leur droit d'opposition sont normalement
désormais en statut \"partiellement diffusible\"."
diffusable_commercialement:
title: Indique si les données renvoyées sont entièrement publiques
et donc diffusables
type: boolean
example: true
description: "Ce champ est a priori toujours à 'true' car
cette API ne renvoie que de l'open data. Pour une unité
légale : \n \n - diffusible : 'true', car toutes les données
sont publiques ; \n - partiellement-diffusible : 'true'.
Dans ce cas, les informations protégées suite au droit d'opposition
sont masquées par la chaîne de caractère '[ND]' ; \n Plus
d'informations sur les conditions de diffusion : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=8279ad8c-c12d-4a2c-b9ad-8cc12dea2c39"
forme_juridique:
type: object
additionalProperties: false
title: Attributs de la forme juridique
properties:
code:
title: Code de la forme juridique de l'unité légale.
type: string
example: '7120'
description: "Il existe plus de 300 catégories juridiques,
identifiables par un code spécifique à quatre chiffres.
Leur nomenclature comporte 3 niveaux. Le premier niveau
de classement contient 9 grandes catégories identifiables
avec le premier chiffre du code : \n \n - 0 : Organisme
de placement collectif en valeurs mobilières sans personnalité
morale \n - 1 : Entrepreneur individuel. La catégorie
juridique des personnes physiques est '1000'. \n - 2
: Groupement de droit privé non doté de la personnalité
morale \n - 3 : Personne morale de droit étranger \n
- 4 : Personne morale de droit public soumise au droit
commercial \n - 5 : Société commerciale \n - 6 : Autre
personne morale immatriculée au RCS \n - 7 : Personne
morale et organisme soumis au droit administratif \n
- 8 : Organisme privé spécialisé \n - 9 : Groupement
de droit privé \n \n Nomenclature exhaustive des codes
fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
libelle:
title: Libellé associé au code de la forme juridique de
l'unité légale.
type: string
example: Service central d'un ministère
description: "indique le libellé correspondant au code
juridique. Si le code ne correspond à aucun libellé
la valeur 'non référencé' est utilisée. \n \n Nomenclature
exhaustive fournie par l'Insee : https://www.insee.fr/fr/information/2028129"
required:
- code
- libelle
activite_principale:
title: Attributs de l'activité principale
type: object
additionalProperties: false
properties:
code:
title: Code de l'activité principale (APE) de l'unité
légale
type: string
example: 8411Z
nullable: true
description: "Le code APE (activité principale exercée)
permet d'identifier la branche d'activité principale.
Il est attribué par l'Insee lors de l'immatriculation
ou la déclaration d'activité de l'entreprise. Ce code
de 4 chiffres + 1 lettre est extrait de la nomenclature
d'activité française (NAF) de l'Insee. Si le code n'est
pas renseigné dans la nomenclature 'Naf Rév2' (nomenclature
en vigueur), le code est null ici. \n \n À noter qu'une
entreprise n'ayant pas encore de code APE peut se voir
affecter la valeur '00.00Z' de manière provisoire. \n
\n Plus d'informations métier : https://entreprendre.service-public.fr/vosdroits/F33050
Nomemclature d'activité française - NAF rév.2 de l'Insee
: https://www.insee.fr/fr/information/2120875. \n \n
⚠️ À partir de janvier 2026, le code APE utilisera la
nouvelle nomenclature NAF 2025, tel qu'explicité dans
ce document : https://www.cnis.fr/evenements/la-revision-de-la-nomenclature-dactivites-francaise-naf-quels-effets-pour-les-utilisateurs/?category=1067.
Des tables de correspondance seront fournies par l'Insee."
libelle:
title: Libellé associé au code APE
type: string
nullable: false
example: Administration publique générale
description: "Libellé associé au code APE. Si le code
ne correspond à aucun libellé au sein de la nomenclature
'Naf Rév2', la valeur 'non référencé' est utilisée.
\n \n Nomemclature d'activité française - NAF rév.2
de l'Insee : https://www.insee.fr/fr/information/2406147"
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
description: Ce champ indique le nom de la nomenclature
associée au code APE. Si le code n'est pas renseigné
dans la nomenclature 'Naf Rév2' (nomenclature en vigueur),
la nomenclature null ici.
required:
- code
- libelle
- nomenclature
tranche_effectif_salarie:
type: object
additionalProperties: false
title: Tranche d'effectif salarié de l'unité légale
description: Pour environ la moitié des établissements, la
tranche d'effectif salarié n'est pas renseignée. Il s'agit
principalement d'établissements récents (créés il y a moins
de trois ans). Les délais de récolte et traitement font
que les valeurs indiquées datent de l’année N-2 ou N-3.
properties:
code:
type: string
nullable: true
example: '51'
description: "Le code effectif indique la tranche d'effectif
salarié de l'unité légale. Le nombre de salarié est
déterminé en fonction de l'effectif de chacun des établissements
de l'unité légale : \n \n - NN : Unités non employeuses
(pas de salarié au cours de l'année de référence et
pas d'effectif au 31/12). Cette tranche peut contenir
quelques effectifs inconnus \n - 00 : 0 salarié (n'ayant
pas d'effectif au 31/12 mais ayant employé des salariés
au cours de l'année de référence) \n - 01 : 1 ou 2 salariés
\n - 02 : 3 à 5 salariés \n - 03 : 6 à 9 salariés \n
- 11 : 10 à 19 salariés \n - 12 : 20 à 49 salariés \n
- 21 : 50 à 99 salariés \n - 22 : 100 à 199 salariés
\n - 31 : 200 à 249 salariés \n - 32 : 250 à 499 salariés
\n - 41 : 500 à 999 salariés \n - 42 : 1 000 à 1 999
salariés \n - 51 : 2 000 à 4 999 salariés \n - 52 :
5 000 à 9 999 salariés \n - 53 : 10 000 salariés et
plus \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#trancheeffectifsunitelegale.
\n \n L'effectif exact de l'entreprise, mensuel et annuel,
est disponible au travers de l'API Effectifs - URSSAF
Caisse nationale. Si votre jeton contient ce droit d'accès,
nous vous recommandons d'utiliser cette API. Ces données
étant protégées, leur cadre d'utilisation est différent
de la tranche effectif fournie par l'Insee, qui elle
est une donnée publique."
enum:
- NN
- '00'
- '01'
- '02'
- '03'
- '11'
- '12'
- '21'
- '22'
- '31'
- '32'
- '41'
- '42'
- '51'
- '52'
- '53'
intitule:
title: Intitulé associé au code effectif
type: string
nullable: true
example: 2 000 à 4 999 salariés
date_reference:
title: Date de référence de l'effectif
type: string
nullable: true
example: '2016'
de:
title: Seuil inférieur de la tranche effectif
type: integer
example: 2000
nullable: true
a:
title: Seuil supérieur de la tranche effectif
type: integer
example: 4999
nullable: true
required:
- code
- intitule
- date_reference
- de
- a
etat_administratif:
title: État administratif de l'unité légale
type: string
example: A
enum:
- A
- C
description: "Cette valeur décrit l'état administratif de
l'unité légale qui peut être « active » ou « cessée » \n
\n **Pour les personnes morales**, l'unité légale est considérée
comme juridiquement « cessée » si : \n - il y a eu dépôt
de la déclaration de disparition de la personne morale
; \n - 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”) ; \n - elle n'a plus d'établissement en activité.
\n \n **Pour les personnes physiques**, l'unité légale est
considérée comme juridiquement « cessée » si : \n - l'exploitant
de l'unité légale décède ; \n - l'exploitant dépose une
cessation d'activité. \n \n En dehors de ces cas, l'état
administratif de l'unité légale est toujours « actif ».
\n \n Plus d'informations dans la documentation Insee de
l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#etatadministratifunitelegale"
economie_sociale_et_solidaire:
title: Unité légale de l'économie sociale et solidaire (ESS)
description: "Indique si l'unité légale est une ESS : \n \n
- true : l'entreprise est une ESS \n - false : l'entreprise
n'est pas une ESS \n - null : le statut ESS est inconnu.
Cette information est connue pour environ 1 million d'unités
légales, autrement, elle est à null. \n \n Les unités légales
de l'ESS adhèrent aux mêmes principes : \n * poursuivre
un but social autre que le seul partage des bénéfices ;
\n * une lucrativité encadrée (notamment des bénéfices majoritairement
consacrés au maintien et au développement de l’activité)
; \n * une gouvernance démocratique et participative. \n
Ces conditions cumulatives sont explicitées à l'[Article
1 de la loi n° 2014-856 du 31 juillet 2014](https://www.legifrance.gouv.fr/loda/article_lc/LEGIARTI000029314926){:target='_blank'}.
\n \n Plus d'informations dans la documentation INSEE de
l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#economiesocialesolidaireunitelegale"
type: boolean
example: true
nullable: true
enum:
- true
- false
date_creation:
title: Date de création de l'unité légale
type: integer
example: 1634103818
nullable: true
description: "La date de création correspond à la date qui
figure dans les statuts de l'entreprise qui sont déposés
au centre de formalité des entreprises (CFE) compétent.
Cette valeur est renvoyée sous format timestamp. \n \n Pour
certains établissements très anciens, tous fermés et dont
l’unité légale est cessée la date de création peut être
nulle. \n Pour les unités purgées, la date de création n'est
jamais à 'null'. Si elle est non renseignée, elle sera au
01/01/1900. \n \n Plus d'informations dans la documentation
Insee de l'API Sirene : https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc?page=2ed989b6-001c-4b22-9989-b6001c6b224e#datecreationunitelegale"
activite_principale_naf_rev2:
title: Attributs de l'activité principale en nomenclature
NAFRev2
type: object
additionalProperties: false
description: Ce champ permet de retrouver le code APE dans
l'ancienne nomenclature NAFRev2 pour assurer la rétro-compatibilité.
properties:
code:
title: Code de l'activité principale (APE) en NAFRev2
type: string
example: 8411Z
nullable: true
libelle:
title: Libellé associé au code APE NAFRev2
type: string
nullable: false
example: Administration publique générale
nomenclature:
title: Nomenclature associée au code
type: string
nullable: true
example: NAFRev2
required:
- code
- libelle
- nomenclature
date_cessation:
title: Date de cessation de l'unité légale
type: integer
nullable: true
example: 1634133818
description: Cette valeur est renvoyée sous format timestamp.
Si l'entreprise est juridique active, cette valeur est à
'null'.
required:
- siren
- rna
- siret_siege_social
- type
- personne_morale_attributs
- personne_physique_attributs
- categorie_entreprise
- status_diffusion
- diffusable_commercialement
- forme_juridique
- activite_principale
- tranche_effectif_salarie
- etat_administratif
- economie_sociale_et_solidaire
- date_creation
- activite_principale_naf_rev2
- date_cessation
additionalProperties: false
links:
type: object
properties:
siege_social:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/etablissements/30613890001294
description: Lien vers la ressource 'Données de référence
d'un établissement' correspondant au siège social de cette
unité légale.
siege_social_adresse:
type: string
example: https://entreprise.api.gouv.fr/api/v3/insee/etablissements/30613890001294/adresse
description: Lien vers la ressource 'Adresse d'un établissement'
correspondant au siège social de cette unité légale.
required:
- siege_social
- siege_social_adresse
additionalProperties: false
meta:
type: object
properties:
date_derniere_mise_a_jour:
type: integer
example: 1618396818
description: Date de la dernière mise à jour à l'Insee.
redirect_from_siren:
type: string
title: Siren d'origine de la requête
description: "Si la requête a été effectuée sur un siren qui
a été redirigé vers un autre siren, cette variable contient
le siren d'origine de la requête. Cela arrive parfois lorsque
la base Sirene possède des unités légales en doublons. Ces
doublons sont généralement temporaires. \n Si cette variable
est renseignée, le paramètre data->siren est différent du
paramètre d'appel, et cette variable est le siren d'entrée."
example: '306138900'
nullable: true
required:
- date_derniere_mise_a_jour
- redirect_from_siren
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvee
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles#erreurs.
content:
application/json:
examples:
entite_non_trouvee_01003:
value:
errors:
- code: '01003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: INSEE
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_01999:
value:
errors:
- code: '01999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: INSEE
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '01002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: INSEE
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'451':
description: |-
Indisponible pour des raisons legales
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles#erreurs.
content:
application/json:
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '01020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: INSEE
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_insee_unites_legales_diffusables, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/insee/unites_legales_diffusibles#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/insee/sirene/unites_legales/diffusibles/130025265?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/token/introspect":
get:
summary: Introspection du jeton
tags:
- Jeton
description: |-
Décrit le jeton utilisé pour appeler cet endpoint : périmètres de données accordés, demande d'habilitation associée, dates d'émission et d'expiration.
Cet endpoint ne consomme aucun périmètre particulier : tout jeton valide peut l'appeler.
Il remplace `/privileges`, qui ne renvoie que la liste des périmètres et reste disponible pour compatibilité.
security:
- jwt_bearer_token: []
parameters:
- name: recipient
in: query
description: SIRET de l'organisation pour laquelle un jeton éditeur souhaite
décrire sa délégation. Sans effet pour les autres types de jetons.
example: '13002526500013'
required: false
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
responses:
'200':
description: Description du jeton
x-operationId: api_entreprise_v3_introspect
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
id:
type: string
title: Identifiant du jeton
description: Identifiant unique du jeton (claim `jti`). C'est
cet identifiant qu'il faut communiquer au support.
example: f5d5cb02-185a-426f-b3f4-99a25ce6cdf4
type:
type: string
enum:
- standard
- editeur
title: Type de jeton
description: "`standard` : jeton délivré pour une demande
d'habilitation. `editeur` : jeton d'éditeur, agissant par
délégation."
example: standard
scopes:
type: array
items:
type: string
title: Périmètres de données accessibles
description: Liste des périmètres (scopes) accordés au jeton.
Les données hors de ces périmètres sont masquées des réponses.
example:
- attestations_fiscales
- attestations_sociales
datapass_id:
type: string
nullable: true
title: Identifiant DataPass de la demande d'habilitation
description: Identifiant DataPass de la demande d'habilitation
à l'origine du jeton. Pour un jeton éditeur, identifiant
de la demande d'habilitation déléguée, une fois le paramètre
`recipient` renseigné.
example: '12345'
siret_souscripteur:
type: string
nullable: true
title: SIRET du souscripteur
description: SIRET de l'organisation à laquelle le jeton a
été délivré. Pour un jeton éditeur, SIRET de l'organisation
ayant délégué son habilitation, une fois le paramètre `recipient`
renseigné.
example: '13002526500013'
date_emission:
type: string
format: date-time
nullable: true
title: Date d'émission du jeton
description: Date à laquelle le jeton a été émis (claim `iat`).
example: '2024-01-15T09:00:00+01:00'
date_expiration:
type: string
format: date-time
nullable: true
title: Date d'expiration du jeton
description: Date à laquelle le jeton cesse de fonctionner
(claim `exp`). Pensez à demander son renouvellement avant
cette date.
example: '2025-07-15T09:00:00+02:00'
rate_limit_par_minute:
type: integer
nullable: true
title: Limite de débit par minute
description: Nombre maximum d'appels par minute accordé au
jeton. `null` lorsque aucune limite spécifique n'est configurée.
example: 2000
delegation:
type: object
nullable: true
title: Délégation utilisée
description: Délégation résolue pour un jeton éditeur, lorsque
le paramètre `recipient` est renseigné. `null` dans tous
les autres cas.
properties:
id:
type: string
title: Identifiant de la délégation
example: a31c6e1b-0a2f-4e8b-9a31-9b3d1f9a51c2
siret_delegant:
type: string
title: SIRET du délégant
description: SIRET de l'organisation ayant délégué son
habilitation à l'éditeur.
example: '13002526500013'
required:
- id
- siret_delegant
additionalProperties: false
required:
- id
- type
- scopes
- datapass_id
- siret_souscripteur
- date_emission
- date_expiration
- rate_limit_par_minute
- delegation
additionalProperties: false
links:
type: object
properties:
datapass:
type: string
format: uri
nullable: true
title: Lien vers la demande d'habilitation
description: Lien vers la demande d'habilitation sur DataPass,
accessible aux seuls membres de l'organisation habilitée.
Pour un jeton éditeur, lien vers la demande d'habilitation
déléguée, une fois le paramètre `recipient` renseigné.
example: https://datapass.api.gouv.fr/demandes/12345
required:
- datapass
additionalProperties: false
meta:
type: object
required:
- data
- links
- meta
'401':
description: Non autorisé
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: Accès interdit
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'409':
description: Conflit
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'422':
description: Paramètre(s) invalide(s)
content:
application/json:
examples:
missing_mandatory_param_error:
value:
errors:
- code: '00203'
title: Entité non traitable
detail: Le paramètre recipient est obligatoire
source:
parameter: recipient
meta: {}
summary: Entité non traitable
description: Le paramètre recipient est obligatoire
schema:
"$ref": "#/components/schemas/Error"
'429':
description: Trop de requêtes
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/token/introspect"
"/v3/ministere_interieur/rna/associations/{siret_or_rna}/documents":
get:
summary: Divers documents d'une association
deprecated: true
tags:
- Informations générales
parameters:
- name: siret_or_rna
in: path
description: Siret de l'association ou le numéro RNA
examples:
openstreetmap_france:
value: W751212517
summary: ID RNA Openstreetmap France
croix_rouge:
value: '77567227221138'
summary: SIRET de la Croix-Rouge France
required: true
schema:
type: string
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Divers documents administratifs en PDF tels que les statuts, le
récépissé de déclaration de création, la liste des dirigeants...
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_documents_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/documents_associations#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_documents_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/documents_associations#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_documents_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/documents_associations#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Document Association found
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). La durée du cache est de 1 heure.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_mi_documents_associations
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
data:
type: object
properties:
timestamp:
example: '1631182730'
description: Date du dépot du document au format timestamp
UNIX
type: string
type:
example: Statuts
description: 'Ce sont les différents types de documents,
et de fait, pour chaque URL, celui-ci est indiqué.
Voici une liste non-exhaustive des options possibles
: ''Liste des dirigeants'', ''Statuts'', ''Procès
verbal'', ''Récépissé de dissolution'', ''Récépissé
de modification''...'
type: string
url:
example: https://storage.entreprise.api.gouv.fr/siade/1635505765-5cd08405e4163c9f7713447829aeef7284c3283d-document_asso.pdf
description: L'URL du fichier
type: string
nullable: true
expires_in:
title: Nombre de secondes avant expiration du lien URL
type: integer
nullable: true
errors:
title: Détail de l'erreur survenue au traitement du
fichier (URL fourni par le fournisseur de données
invalide, fichier corrompu, ...)
type: array
items:
type: string
required:
- timestamp
- type
- url
- expires_in
- errors
links:
type: object
meta:
type: object
meta:
type: object
properties:
nombre_documents:
example: 1
description: Le nombre total de documents disponibles
type: integer
nombre_documents_deficients:
example: 0
description: Le nombre de documents ignorés car déficients
(indisponibles, PDF invalide etc...)
type: integer
required:
- nombre_documents
- nombre_documents_deficients
additionalProperties: false
links:
type: object
required:
- data
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_documents_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/documents_associations#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00303'
title: Entité non traitable
detail: Le numéro de siret ou le numéro d'association indiqué
n'est pas correctement formatté
source:
parameter: id
meta: {}
summary: Entité non traitable
description: Le numéro de siret ou le numéro d'association indiqué
n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_documents_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/documents_associations#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_21999:
value:
errors:
- code: '21999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: MI
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Association not found
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_documents_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/documents_associations#erreurs.
content:
application/json:
examples:
entite_non_trouvee_21003:
value:
errors:
- code: '21003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: MI
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_documents_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/documents_associations#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '21002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: MI
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_documents_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/documents_associations#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_documents_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/documents_associations#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '21020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: MI
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_documents_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/documents_associations#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/ministere_interieur/rna/associations/13002526500013/documents?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/ministere_interieur/rna/associations/{siret_or_rna}":
get:
summary: Données du RNA d'une association
deprecated: true
tags:
- Informations générales
parameters:
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: siret_or_rna
in: path
description: Siret de l'association ou le numéro RNA
examples:
openstreetmap_france:
value: W751212517
summary: ID RNA Openstreetmap France
croix_rouge:
value: '77567227221138'
summary: SIRET de la Croix-Rouge France
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Informations issues du répertoire national des associations (RNA),
telles que la date de création, l’adresse du siège et les dirigeants.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/rna#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/rna#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/rna#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Association found
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). La durée du cache est de 1 heure.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_mi_associations
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
rna_id:
type: string
title: Identifiant RNA
titre:
type: string
example: LA PRÉVENTION ROUTIERE
objet:
type: string
example: Accroitre la sécurité des usagers en encourageant
toutes mesures ou initiatives propres à réduire les accidents
description: Il s'agit d'une description courte mais exhaustive
des activités de l'organisme.
siret:
type: string
nullable: true
example:
siret_siege_social:
type: string
example: '77571979202650'
nullable: true
date_creation:
type: string
example: '1955-01-01'
description: Il s'agit du jour de dépôt du dossier de création
de l'association à la Préfecture.
date_declaration:
type: string
example: '1955-01-01'
description: Jour de la dernière déclaration faîte par l'association.
date_publication:
type: string
nullable: true
example:
description: Jour de la publication au journal officiel de
l'avis de création de l'association. Toutes les assoiations
ne sont pas forcément 'déclarées'. La publication au Journal
Officiel permet à l'association de devenir une personne
morale, a contrario des 'associations de fait', non déclarées
au JO.
date_dissolution:
type: string
nullable: true
example:
description: Si l'association est dissolue, ce champ indique
la date de dissolution, autrement, il est indiqué 'null'.
adresse_siege:
type: object
additionalProperties: false
title: Adresse du siège social de l'association
properties:
complement:
title: Complément d'adresse
type: string
example: ''
nullable: true
numero_voie:
title: Numéro de voie
type: string
example: '33'
nullable: true
type_voie:
title: Type de voie
type: string
example: rue
nullable: true
libelle_voie:
title: Libellé de la voie
type: string
example: de Modagor
nullable: true
distribution:
title: Distribution
type: string
nullable: true
code_insee:
title: Code INSEE de la commune
type: string
example: '75108'
nullable: true
code_postal:
title: Code postal de la commune
type: string
example: '75009'
nullable: true
commune:
title: Nom de la commune
type: string
example: Paris
nullable: true
required:
- complement
- numero_voie
- type_voie
- libelle_voie
- distribution
- code_insee
- code_postal
- commune
etat:
type: boolean
example: true
groupement:
type: string
nullable: true
example:
description: 'Trois modalités possibles : si l''association
n''est pas un groupement, il est indiqué ''Simple'' ; si
l''association est un groupement, la valeur est ''Union''
ou ''Fédération''. La valeur peut aussi être manquante (null)'
mise_a_jour:
type: string
example: '1955-01-01'
required:
- rna_id
- titre
- objet
- siret
- siret_siege_social
- date_creation
- date_declaration
- date_publication
- date_dissolution
- adresse_siege
- etat
- groupement
- mise_a_jour
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/rna#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00303'
title: Entité non traitable
detail: Le numéro de siret ou le numéro d'association indiqué
n'est pas correctement formatté
source:
parameter: id
meta: {}
summary: Entité non traitable
description: Le numéro de siret ou le numéro d'association indiqué
n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Association not found
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/rna#erreurs.
content:
application/json:
examples:
entite_non_trouvee_21003:
value:
errors:
- code: '21003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: MI
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/rna#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '21002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: MI
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/rna#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_21999:
value:
errors:
- code: '21999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: MI
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/rna#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/rna#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '21020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: MI
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/ministere_interieur/rna#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/ministere_interieur/rna/associations/13002526500013?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/ministere_interieur/siaf/associations/{siren_or_siret_or_rna}":
get:
summary: Données associations
tags:
- Informations générales
- Prochainement
parameters:
- name: siren_or_siret_or_rna
in: path
description: 'SIREN ou SIRET de l''association, ou son identifiant au Répertoire
National des Associations (RNA). Toutes les associations ne sont pas immatriculées
au répertoire Sirene : elles ne sont alors accessibles que par leur identifiant
RNA.'
examples:
randonnee_pedestre_rna:
value: W442001747
summary: Identifiant RNA du comité départemental de la randonnée pédestre
de Loire-Atlantique
randonnee_pedestre_siren:
value: '388916678'
summary: SIREN du comité départemental de la randonnée pédestre de Loire-Atlantique
randonnee_pedestre_siret:
value: '38891667800039'
summary: SIRET du comité départemental de la randonnée pédestre de Loire-Atlantique
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: 'Données de référence d''une association issues du Répertoire National
des Associations (RNA), opéré par le Ministère de l''Intérieur via le SIAF
: identité, reconnaissance d''utilité publique, activités, dirigeants, filiation,
groupement constitué (union, fédération), établissements, conformité comptable
et pièces justificatives.'
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Association trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_mi_siaf_associations
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
identifiants:
title: Identifiants de l'association
type: object
properties:
rna:
title: Identifiant au Répertoire National des Associations
description: Identifiant officiel de l'association, au
format W suivi de 9 caractères dont les 3 premiers encodent
le département de déclaration.
type: string
example: W123456789
siren:
title: SIREN de l'association
description: 'Déduit du SIRET présent dans le référentiel.
Toutes les associations ne sont pas immatriculées au
répertoire Sirene : l''immatriculation n''est obligatoire
que lorsque l''association emploie, perçoit des subventions
ou exerce une activité économique. La valeur est alors
null.'
type: string
nullable: true
example: '123456789'
siret_siege:
title: SIRET du siège de l'association
type: string
nullable: true
example: '12345678900012'
required:
- rna
- siren
- siret_siege
identite:
title: Identité de l'association
type: object
properties:
nom:
title: Nom de l'association
type: string
example: ASSOCIATION EXEMPLE
etat:
title: État de l'association
description: 'Valeurs servies à ce jour : Active et Dissoute.
Le référentiel métier en prévoit d''autres (suspendue,
transformée, fusionnée, scindée), jamais observées ;
le vocabulaire n''est donc pas figé en enum.'
type: string
example: Active
service_instructeur:
title: Service instructeur
description: Département du service instructeur, préfecture
ou sous-préfecture ayant instruit la déclaration.
type: object
nullable: true
properties:
code:
title: Code du département
type: string
nullable: true
example: '21'
libelle:
title: Libellé du département
type: string
nullable: true
example: Côte-d'Or
required:
- code
- libelle
date_creation:
title: Date de création de l'association
type: string
format: date
nullable: true
example: '2010-05-12'
date_dissolution:
title: Date de dissolution de l'association
description: Renseignée uniquement lorsque l'association
est dissoute.
type: string
format: date
nullable: true
example:
duree_determinee:
title: Durée déterminée
description: Vrai lorsque les statuts fixent un terme
à l'organisme, faux lorsque sa durée est indéterminée.
type: boolean
nullable: true
example: false
date_terme:
title: Date du terme
description: Échéance fixée par les statuts, notamment
pour les fondations d'entreprise créées pour une durée
déterminée. Null lorsque la durée est indéterminée.
type: string
format: date
nullable: true
example:
cloture_exercice:
title: Clôture de l'exercice comptable
description: Jour et mois de clôture de l'exercice comptable,
sans année.
type: object
nullable: true
properties:
mois:
title: Mois de clôture
type: integer
example: 12
jour:
title: Jour de clôture
type: integer
example: 31
required:
- mois
- jour
adresse_siege:
title: Adresse du siège de l'association
type: object
properties:
adresse_complete:
title: Adresse complète sur une ligne
type: string
nullable: true
example: 10 RUE DE LA REPUBLIQUE 21000 DIJON
complement:
title: Complément d'adresse
type: string
nullable: true
example:
numero_voie:
title: Numéro de voie
type: string
nullable: true
example: '10'
type_voie:
title: Type de voie
description: Type de voie tel que saisi dans le référentiel,
non normalisé (RUE, AV, BD, CHEM…).
type: string
nullable: true
example: RUE
libelle_voie:
title: Libellé de la voie
type: string
nullable: true
example: DE LA REPUBLIQUE
distribution:
title: Mention de distribution spéciale
type: string
nullable: true
example:
code_insee:
title: Code INSEE de la commune
type: string
nullable: true
example: '21231'
code_postal:
title: Code postal
type: string
nullable: true
example: '21000'
commune:
title: Commune
type: string
nullable: true
example: DIJON
pays:
title: Pays
type: string
nullable: true
example: France
required:
- adresse_complete
- complement
- numero_voie
- type_voie
- libelle_voie
- distribution
- code_insee
- code_postal
- commune
- pays
courriel:
title: Courriel de l'association
type: string
nullable: true
example: contact@association.fr
telephone:
title: Numéro de téléphone de l'association
type: string
nullable: true
example: "+33102030405"
required:
- nom
- etat
- service_instructeur
- date_creation
- date_dissolution
- duree_determinee
- date_terme
- cloture_exercice
- adresse_siege
- courriel
- telephone
utilite_publique:
title: Reconnaissance d'utilité publique
type: object
properties:
reconnue:
title: Association reconnue d'utilité publique
type: boolean
nullable: true
example: true
date_publication:
title: Date de publication de la reconnaissance d'utilité
publique
type: string
format: date
nullable: true
example: '2018-04-10'
date_fin:
title: Date de fin de la reconnaissance d'utilité publique
type: string
format: date
nullable: true
example:
required:
- reconnue
- date_publication
- date_fin
activites:
title: Activités de l'association
type: object
properties:
objet:
title: Objet de l'association
description: Objet de l'association tel que rédigé dans
ses statuts.
type: string
nullable: true
example: Promouvoir les activités culturelles...
objet_social1:
title: Objet social principal
description: L'objet social suit la nomenclature nationale
Waldec et rattache l'objet de l'association à une catégorie.
La liste exhaustive est disponible sur https://www.data.gouv.fr/fr/datasets/repertoire-national-des-associations-nomenclature-waldec
(environ 300 entrées). La clé garde le nom qu'elle porte
sur l'API Données association de la DJEPVA ; le référentiel
SIAF ne sert qu'un objet social, objet_social2 sera
ajouté s'il vient à l'alimenter.
type: object
properties:
code:
title: Code de l'objet social
type: string
nullable: true
example: '006000'
libelle:
title: Libellé de l'objet social
type: string
nullable: true
example: Culture et pratiques artistiques
required:
- code
- libelle
activite_internationale_prevue_par_statuts:
title: Activité internationale prévue par les statuts
type: boolean
nullable: true
example: false
required:
- objet
- objet_social1
- activite_internationale_prevue_par_statuts
dirigeants:
title: Dirigeants et membres des organes de gouvernance
description: Personnes physiques exerçant des fonctions de
direction ou siégeant dans les organes de gouvernance. Un
dirigeant peut représenter une personne morale, détaillée
dans personne_morale.
type: array
items:
type: object
properties:
nom:
title: Nom du dirigeant
type: string
nullable: true
example: DUPONT
prenom:
title: Prénom du dirigeant
type: string
nullable: true
example: Marie
fonction:
title: Fonction exercée
type: string
nullable: true
example: Présidente
qualite:
title: Qualité au titre de laquelle la personne siège
type: string
nullable: true
example: Membre du conseil d'administration
date_naissance:
title: Date de naissance
type: string
format: date
nullable: true
example: '1980-05-12'
nationalite:
title: Nationalité
type: string
nullable: true
example: Française
pays_residence:
title: Pays de résidence
type: string
nullable: true
example: France
profession:
title: Profession
type: string
nullable: true
example: Juriste
date_entree_fonction:
title: Date d'entrée dans les fonctions
type: string
format: date
nullable: true
example: '2023-06-01'
date_sortie_fonction:
title: Date de sortie des fonctions
type: string
format: date
nullable: true
example:
fondateur:
title: Statut de fondateur
type: boolean
nullable: true
example: false
adresse_domiciliation:
title: Adresse de domiciliation du dirigeant
type: object
properties:
adresse_complete:
title: Adresse complète sur une ligne
type: string
nullable: true
example: 10 RUE DE LA REPUBLIQUE 21000 DIJON
complement:
title: Complément d'adresse
type: string
nullable: true
example:
numero_voie:
title: Numéro de voie
type: string
nullable: true
example: '10'
type_voie:
title: Type de voie
description: Type de voie tel que saisi dans le
référentiel, non normalisé (RUE, AV, BD, CHEM…).
type: string
nullable: true
example: RUE
libelle_voie:
title: Libellé de la voie
type: string
nullable: true
example: DE LA REPUBLIQUE
distribution:
title: Mention de distribution spéciale
type: string
nullable: true
example:
code_insee:
title: Code INSEE de la commune
type: string
nullable: true
example: '21231'
code_postal:
title: Code postal
type: string
nullable: true
example: '21000'
commune:
title: Commune
type: string
nullable: true
example: DIJON
pays:
title: Pays
type: string
nullable: true
example: France
personne_morale:
title: Personne morale représentée
description: Renseigné lorsque le dirigeant siège en
tant que représentant d'une personne morale. Null
pour une personne physique siégeant en son nom propre.
type: object
nullable: true
properties:
type:
title: Type de personne morale
type: string
nullable: true
example: Entreprise
identifiant:
title: Identifiant de la personne morale
type: string
nullable: true
example: '98765432100012'
nom:
title: Nom de la personne morale
type: string
nullable: true
example: ENTREPRISE EXEMPLE
pays:
title: Pays de la personne morale
type: string
nullable: true
example: France
filiation:
title: Filiation de l'organisme
description: Organismes liés par une opération de transformation,
de fusion ou de scission. Chaque entrée porte le type de
l'opération et l'identifiant de l'organisme qui en est issu.
La liste est vide lorsque l'organisme n'est concerné par
aucune opération.
type: array
items:
type: object
properties:
type_operation:
title: Type d'opération
type: string
enum:
- Transformation
- Fusion
- Scission
example: Fusion
identifiant:
title: Identifiant de l'organisme issu de l'opération
description: Identifiant RNA ou RNF selon la nature
de l'organisme lié.
type: string
nullable: true
example: W987654321
groupement:
title: Groupement constitué par l'association
description: Renseigné lorsque l'association est elle-même
une union ou une fédération d'associations. Null pour une
association simple. L'appartenance de l'association à un
groupement n'est pas servie par le référentiel à ce jour.
type: object
nullable: true
properties:
type:
title: Type de groupement
description: Union ou fédération. Seule la valeur Union
a été observée à ce jour ; le vocabulaire exact reste
à figer avec le fournisseur.
type: string
nullable: true
example: Union
associations_membres:
title: Associations membres du groupement
type: array
items:
type: object
properties:
rna:
title: Identifiant RNA de l'association membre
type: string
nullable: true
example: W987654321
required:
- type
- associations_membres
etablissements:
title: Liste des établissements de l'association pour lesquels
des informations sont disponibles
type: array
items:
type: object
properties:
nom:
title: Nom de l'établissement
type: string
nullable: true
example: Antenne Dijon
adresse:
title: Adresse de l'établissement
type: object
properties:
adresse_complete:
title: Adresse complète sur une ligne
type: string
nullable: true
example: 10 RUE DE LA REPUBLIQUE 21000 DIJON
complement:
title: Complément d'adresse
type: string
nullable: true
example:
numero_voie:
title: Numéro de voie
type: string
nullable: true
example: '10'
type_voie:
title: Type de voie
description: Type de voie tel que saisi dans le
référentiel, non normalisé (RUE, AV, BD, CHEM…).
type: string
nullable: true
example: RUE
libelle_voie:
title: Libellé de la voie
type: string
nullable: true
example: DE LA REPUBLIQUE
distribution:
title: Mention de distribution spéciale
type: string
nullable: true
example:
code_insee:
title: Code INSEE de la commune
type: string
nullable: true
example: '21231'
code_postal:
title: Code postal
type: string
nullable: true
example: '21000'
commune:
title: Commune
type: string
nullable: true
example: DIJON
pays:
title: Pays
type: string
nullable: true
example: France
conformite_comptable:
title: Conformité comptable de l'association
type: object
properties:
etat_transmission_comptes:
title: État de transmission des comptes
description: En défaut lorsque l'organisme est en retard
dans le dépôt de ses comptes annuels.
type: string
enum:
- En règle
- En défaut
example: En règle
annees_exercices_comptables_transmis:
title: Années des exercices comptables transmis
description: Années au titre desquelles l'association
a déposé ses comptes annuels.
type: array
items:
type: integer
example: 2024
example:
- 2023
- 2024
- 2025
required:
- etat_transmission_comptes
- annees_exercices_comptables_transmis
documents:
title: Pièces justificatives déposées par l'association
description: Métadonnées des documents déposés par l'association
(statuts, listes de dirigeants, procès verbaux, comptes…).
Le type et le nombre de documents varient selon l'association.
type: array
items:
type: object
properties:
id:
title: Identifiant du document
type: string
example: df9ee99e-89c7-11f1-9645-27365eec5438
type:
title: Type de document
description: Typologie grossière du RNA en quatre valeurs,
dont Autre couvre la majorité des pièces ; elle diffère
du couple Pièce / Récépissé servi par la DJEPVA. Se
référer à sous_type pour une qualification fine.
type: string
example: Statuts
sous_type:
title: Sous-type de document
description: Code de pièce du RNA et son libellé. Les
codes sont ceux déjà servis par l'API Données association
de la DJEPVA (STC, LDC, PV, MD, ARR…).
type: object
properties:
code:
title: Code de la pièce
type: string
nullable: true
example: STC
libelle:
title: Libellé de la pièce
type: string
nullable: true
example: Statuts certifiés
date_depot:
title: Date de dépôt du document
type: string
format: date
nullable: true
example: '2018-03-26'
annee_depot:
title: Année de dépôt du document
description: Conservée à côté de date_depot par alignement
avec l'API Données association de la DJEPVA, où la
date complète est parfois absente.
type: integer
nullable: true
example: 2018
url:
title: URL de téléchargement du document
description: Lien de téléchargement servi par API Entreprise,
valable 24 heures. Sur l'environnement de test, l'API
est simulée et ces liens ne servent aucun fichier.
type: string
nullable: true
example: https://entreprise.api.gouv.fr/proxy/files/8f1c0a2e-6b34-4d95-9f77-2c5a1e0b7d43
required:
- identifiants
- identite
- utilite_publique
- activites
- dirigeants
- filiation
- groupement
- etablissements
- conformite_comptable
- documents
additionalProperties: false
links:
type: object
meta:
type: object
properties:
date_derniere_mise_a_jour:
title: Date de dernière mise à jour de l'association
type: string
format: date
nullable: true
example: '2024-05-15'
required:
- date_derniere_mise_a_jour
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00330'
title: Entité non traitable
detail: Le numéro de siren ou le numéro de siret ou le numéro
d'association indiqué n'est pas correctement formatté
source:
parameter: id
meta: {}
summary: Entité non traitable
description: Le numéro de siren ou le numéro de siret ou le numéro
d'association indiqué n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Association non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations#erreurs.
content:
application/json:
examples:
entite_non_trouvee_44003:
value:
errors:
- code: '44003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: SIAF
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_44999:
value:
errors:
- code: '44999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: SIAF
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '44002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: SIAF
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '44020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: SIAF
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://staging.entreprise.api.gouv.fr/v3/ministere_interieur/siaf/associations/13002526500013?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/ministere_interieur/siaf/associations/open_data/{siren_or_siret_or_rna}":
get:
summary: Données associations en open data
tags:
- Informations générales
- Prochainement
parameters:
- name: siren_or_siret_or_rna
in: path
description: 'SIREN ou SIRET de l''association, ou son identifiant au Répertoire
National des Associations (RNA). Toutes les associations ne sont pas immatriculées
au répertoire Sirene : elles ne sont alors accessibles que par leur identifiant
RNA.'
examples:
randonnee_pedestre_rna:
value: W442001747
summary: Identifiant RNA du comité départemental de la randonnée pédestre
de Loire-Atlantique
randonnee_pedestre_siren:
value: '388916678'
summary: SIREN du comité départemental de la randonnée pédestre de Loire-Atlantique
randonnee_pedestre_siret:
value: '38891667800039'
summary: SIRET du comité départemental de la randonnée pédestre de Loire-Atlantique
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: 'Données publiques de référence d''une association issues du Répertoire
National des Associations (RNA), opéré par le Ministère de l''Intérieur via
le SIAF : identité, reconnaissance d''utilité publique, activités, filiation,
groupement constitué (union, fédération), établissements et conformité comptable.'
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations_open_data#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations_open_data#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations_open_data#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Association trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_mi_siaf_associations_open_data
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
identifiants:
title: Identifiants de l'association
type: object
properties:
rna:
title: Identifiant au Répertoire National des Associations
description: Identifiant officiel de l'association, au
format W suivi de 9 caractères dont les 3 premiers encodent
le département de déclaration.
type: string
example: W123456789
siren:
title: SIREN de l'association
description: 'Déduit du SIRET présent dans le référentiel.
Toutes les associations ne sont pas immatriculées au
répertoire Sirene : l''immatriculation n''est obligatoire
que lorsque l''association emploie, perçoit des subventions
ou exerce une activité économique. La valeur est alors
null.'
type: string
nullable: true
example: '123456789'
siret_siege:
title: SIRET du siège de l'association
type: string
nullable: true
example: '12345678900012'
required:
- rna
- siren
- siret_siege
identite:
title: Identité de l'association
type: object
properties:
nom:
title: Nom de l'association
type: string
example: ASSOCIATION EXEMPLE
etat:
title: État de l'association
description: 'Valeurs servies à ce jour : Active et Dissoute.
Le référentiel métier en prévoit d''autres (suspendue,
transformée, fusionnée, scindée), jamais observées ;
le vocabulaire n''est donc pas figé en enum.'
type: string
example: Active
service_instructeur:
title: Service instructeur
description: Département du service instructeur, préfecture
ou sous-préfecture ayant instruit la déclaration.
type: object
nullable: true
properties:
code:
title: Code du département
type: string
nullable: true
example: '21'
libelle:
title: Libellé du département
type: string
nullable: true
example: Côte-d'Or
required:
- code
- libelle
date_creation:
title: Date de création de l'association
type: string
format: date
nullable: true
example: '2010-05-12'
date_dissolution:
title: Date de dissolution de l'association
description: Renseignée uniquement lorsque l'association
est dissoute.
type: string
format: date
nullable: true
example:
duree_determinee:
title: Durée déterminée
description: Vrai lorsque les statuts fixent un terme
à l'organisme, faux lorsque sa durée est indéterminée.
type: boolean
nullable: true
example: false
date_terme:
title: Date du terme
description: Échéance fixée par les statuts, notamment
pour les fondations d'entreprise créées pour une durée
déterminée. Null lorsque la durée est indéterminée.
type: string
format: date
nullable: true
example:
cloture_exercice:
title: Clôture de l'exercice comptable
description: Jour et mois de clôture de l'exercice comptable,
sans année.
type: object
nullable: true
properties:
mois:
title: Mois de clôture
type: integer
example: 12
jour:
title: Jour de clôture
type: integer
example: 31
required:
- mois
- jour
adresse_siege:
title: Adresse du siège de l'association
type: object
properties:
adresse_complete:
title: Adresse complète sur une ligne
type: string
nullable: true
example: 10 RUE DE LA REPUBLIQUE 21000 DIJON
complement:
title: Complément d'adresse
type: string
nullable: true
example:
numero_voie:
title: Numéro de voie
type: string
nullable: true
example: '10'
type_voie:
title: Type de voie
description: Type de voie tel que saisi dans le référentiel,
non normalisé (RUE, AV, BD, CHEM…).
type: string
nullable: true
example: RUE
libelle_voie:
title: Libellé de la voie
type: string
nullable: true
example: DE LA REPUBLIQUE
distribution:
title: Mention de distribution spéciale
type: string
nullable: true
example:
code_insee:
title: Code INSEE de la commune
type: string
nullable: true
example: '21231'
code_postal:
title: Code postal
type: string
nullable: true
example: '21000'
commune:
title: Commune
type: string
nullable: true
example: DIJON
pays:
title: Pays
type: string
nullable: true
example: France
required:
- adresse_complete
- complement
- numero_voie
- type_voie
- libelle_voie
- distribution
- code_insee
- code_postal
- commune
- pays
required:
- nom
- etat
- service_instructeur
- date_creation
- date_dissolution
- duree_determinee
- date_terme
- cloture_exercice
- adresse_siege
utilite_publique:
title: Reconnaissance d'utilité publique
type: object
properties:
reconnue:
title: Association reconnue d'utilité publique
type: boolean
nullable: true
example: true
date_publication:
title: Date de publication de la reconnaissance d'utilité
publique
type: string
format: date
nullable: true
example: '2018-04-10'
date_fin:
title: Date de fin de la reconnaissance d'utilité publique
type: string
format: date
nullable: true
example:
required:
- reconnue
- date_publication
- date_fin
activites:
title: Activités de l'association
type: object
properties:
objet:
title: Objet de l'association
description: Objet de l'association tel que rédigé dans
ses statuts.
type: string
nullable: true
example: Promouvoir les activités culturelles...
objet_social1:
title: Objet social principal
description: L'objet social suit la nomenclature nationale
Waldec et rattache l'objet de l'association à une catégorie.
La liste exhaustive est disponible sur https://www.data.gouv.fr/fr/datasets/repertoire-national-des-associations-nomenclature-waldec
(environ 300 entrées). La clé garde le nom qu'elle porte
sur l'API Données association de la DJEPVA ; le référentiel
SIAF ne sert qu'un objet social, objet_social2 sera
ajouté s'il vient à l'alimenter.
type: object
properties:
code:
title: Code de l'objet social
type: string
nullable: true
example: '006000'
libelle:
title: Libellé de l'objet social
type: string
nullable: true
example: Culture et pratiques artistiques
required:
- code
- libelle
required:
- objet
- objet_social1
filiation:
title: Filiation de l'organisme
description: Organismes liés par une opération de transformation,
de fusion ou de scission. Chaque entrée porte le type de
l'opération et l'identifiant de l'organisme qui en est issu.
La liste est vide lorsque l'organisme n'est concerné par
aucune opération.
type: array
items:
type: object
properties:
type_operation:
title: Type d'opération
type: string
enum:
- Transformation
- Fusion
- Scission
example: Fusion
identifiant:
title: Identifiant de l'organisme issu de l'opération
description: Identifiant RNA ou RNF selon la nature
de l'organisme lié.
type: string
nullable: true
example: W987654321
groupement:
title: Groupement constitué par l'association
description: Renseigné lorsque l'association est elle-même
une union ou une fédération d'associations. Null pour une
association simple. L'appartenance de l'association à un
groupement n'est pas servie par le référentiel à ce jour.
type: object
nullable: true
properties:
type:
title: Type de groupement
description: Union ou fédération. Seule la valeur Union
a été observée à ce jour ; le vocabulaire exact reste
à figer avec le fournisseur.
type: string
nullable: true
example: Union
associations_membres:
title: Associations membres du groupement
type: array
items:
type: object
properties:
rna:
title: Identifiant RNA de l'association membre
type: string
nullable: true
example: W987654321
required:
- type
- associations_membres
etablissements:
title: Liste des établissements de l'association pour lesquels
des informations sont disponibles
type: array
items:
type: object
properties:
nom:
title: Nom de l'établissement
type: string
nullable: true
example: Antenne Dijon
adresse:
title: Adresse de l'établissement
type: object
properties:
adresse_complete:
title: Adresse complète sur une ligne
type: string
nullable: true
example: 10 RUE DE LA REPUBLIQUE 21000 DIJON
complement:
title: Complément d'adresse
type: string
nullable: true
example:
numero_voie:
title: Numéro de voie
type: string
nullable: true
example: '10'
type_voie:
title: Type de voie
description: Type de voie tel que saisi dans le
référentiel, non normalisé (RUE, AV, BD, CHEM…).
type: string
nullable: true
example: RUE
libelle_voie:
title: Libellé de la voie
type: string
nullable: true
example: DE LA REPUBLIQUE
distribution:
title: Mention de distribution spéciale
type: string
nullable: true
example:
code_insee:
title: Code INSEE de la commune
type: string
nullable: true
example: '21231'
code_postal:
title: Code postal
type: string
nullable: true
example: '21000'
commune:
title: Commune
type: string
nullable: true
example: DIJON
pays:
title: Pays
type: string
nullable: true
example: France
conformite_comptable:
title: Conformité comptable de l'association
type: object
properties:
etat_transmission_comptes:
title: État de transmission des comptes
description: En défaut lorsque l'organisme est en retard
dans le dépôt de ses comptes annuels.
type: string
enum:
- En règle
- En défaut
example: En règle
annees_exercices_comptables_transmis:
title: Années des exercices comptables transmis
description: Années au titre desquelles l'association
a déposé ses comptes annuels.
type: array
items:
type: integer
example: 2024
example:
- 2023
- 2024
- 2025
required:
- etat_transmission_comptes
- annees_exercices_comptables_transmis
required:
- identifiants
- identite
- utilite_publique
- activites
- filiation
- groupement
- etablissements
- conformite_comptable
additionalProperties: false
links:
type: object
meta:
type: object
properties:
date_derniere_mise_a_jour:
title: Date de dernière mise à jour de l'association
type: string
format: date
nullable: true
example: '2024-05-15'
required:
- date_derniere_mise_a_jour
additionalProperties: false
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations_open_data#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00330'
title: Entité non traitable
detail: Le numéro de siren ou le numéro de siret ou le numéro
d'association indiqué n'est pas correctement formatté
source:
parameter: id
meta: {}
summary: Entité non traitable
description: Le numéro de siren ou le numéro de siret ou le numéro
d'association indiqué n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Association non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations_open_data#erreurs.
content:
application/json:
examples:
entite_non_trouvee_44003:
value:
errors:
- code: '44003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: SIAF
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations_open_data#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_44999:
value:
errors:
- code: '44999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: SIAF
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations_open_data#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '44002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: SIAF
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations_open_data#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations_open_data#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '44020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: SIAF
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_associations_open_data, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/associations_open_data#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://staging.entreprise.api.gouv.fr/v3/ministere_interieur/siaf/associations/open_data/13002526500013?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/ministere_interieur/siaf/fondations/{siren_or_siret_or_rnf}":
get:
summary: Données fondations
tags:
- Informations générales
- Prochainement
parameters:
- name: siren_or_siret_or_rnf
in: path
description: 'SIREN ou SIRET de la fondation, ou son identifiant au Répertoire
National des Fondations (RNF). Environ 22 % des fondations n''ont pas de
SIRET dans le référentiel : elles ne sont accessibles que par leur identifiant
RNF.'
examples:
maison_de_la_chimie_rnf:
value: 075-FRUP-00194-01
summary: Identifiant RNF de la fondation Maison de la Chimie
maison_de_la_chimie_siren:
value: '784308934'
summary: SIREN de la fondation Maison de la Chimie
maison_de_la_chimie_siret:
value: '78430893400016'
summary: SIRET de la fondation Maison de la Chimie
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: 'Données de référence d''une fondation (FRUP, fondation d''entreprise
ou fonds de dotation) issues du Répertoire National des Fondations (RNF),
opéré par le Ministère de l''Intérieur via le SIAF : identité, activités,
dirigeants, situation financière déclarative, conformité comptable et pièces
justificatives.'
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_fondations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/fondations#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_fondations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/fondations#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_fondations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/fondations#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Fondation trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_mi_siaf_fondations
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
identifiants:
title: Identifiants de la fondation
type: object
properties:
rnf:
title: Identifiant au Répertoire National des Fondations
description: Identifiant officiel de la fondation, au
format {département}-{type}-{numéro}-{suffixe}.
type: string
example: 075-FRUP-00194-01
siren:
title: SIREN de la fondation
description: 'Déduit du SIRET présent dans le référentiel.
Environ 22 % des fondations n''ont pas de SIRET : la
valeur est alors null.'
type: string
nullable: true
example: '784308934'
siret_siege:
title: SIRET du siège de la fondation
type: string
nullable: true
example: '78430893400016'
required:
- rnf
- siren
- siret_siege
identite:
title: Identité de la fondation
type: object
properties:
service_instructeur:
title: Service instructeur
description: Département du service instructeur, préfecture
ou sous-préfecture ayant instruit la déclaration.
type: object
nullable: true
properties:
code:
title: Code du département
type: string
nullable: true
example: '21'
libelle:
title: Libellé du département
type: string
nullable: true
example: Côte-d'Or
required:
- code
- libelle
type_fondation:
title: Type de fondation
description: 'FRUP : fondation reconnue d''utilité publique
; FE : fondation d''entreprise ; FDD : fonds de dotation.'
type: string
enum:
- FRUP
- FE
- FDD
example: FRUP
nom:
title: Nom de la fondation
type: string
example: MAISON DE LA CHIMIE
etat:
title: État de la fondation
description: 'Valeurs servies à ce jour : Active et Dissoute.
Le référentiel métier en prévoit d''autres (suspendue,
transformée, fusionnée, scindée), jamais observées ;
le vocabulaire n''est donc pas figé en enum.'
type: string
example: Active
date_effet_etat:
title: Date d'effet de l'état
type: string
format: date
nullable: true
example: '1928-08-12'
date_creation:
title: Date de création de la fondation
type: string
format: date
nullable: true
example: '1928-08-12'
duree_determinee:
title: Durée déterminée
description: Vrai lorsque les statuts fixent un terme
à l'organisme, faux lorsque sa durée est indéterminée.
type: boolean
nullable: true
example: false
date_terme:
title: Date du terme
description: Échéance fixée par les statuts, notamment
pour les fondations d'entreprise créées pour une durée
déterminée. Null lorsque la durée est indéterminée.
type: string
format: date
nullable: true
example:
cloture_exercice:
title: Clôture de l'exercice comptable
description: Jour et mois de clôture de l'exercice comptable,
sans année.
type: object
nullable: true
properties:
mois:
title: Mois de clôture
type: integer
example: 12
jour:
title: Jour de clôture
type: integer
example: 31
required:
- mois
- jour
adresse_siege:
title: Adresse du siège de la fondation
type: object
properties:
adresse_complete:
title: Adresse complète sur une ligne
type: string
nullable: true
example: 10 RUE DE LA REPUBLIQUE 21000 DIJON
complement:
title: Complément d'adresse
type: string
nullable: true
example:
numero_voie:
title: Numéro de voie
type: string
nullable: true
example: '10'
type_voie:
title: Type de voie
description: Type de voie tel que saisi dans le référentiel,
non normalisé (RUE, AV, BD, CHEM…).
type: string
nullable: true
example: RUE
libelle_voie:
title: Libellé de la voie
type: string
nullable: true
example: DE LA REPUBLIQUE
distribution:
title: Mention de distribution spéciale
type: string
nullable: true
example:
code_insee:
title: Code INSEE de la commune
type: string
nullable: true
example: '21231'
code_postal:
title: Code postal
type: string
nullable: true
example: '21000'
commune:
title: Commune
type: string
nullable: true
example: DIJON
pays:
title: Pays
type: string
nullable: true
example: France
required:
- adresse_complete
- complement
- numero_voie
- type_voie
- libelle_voie
- distribution
- code_insee
- code_postal
- commune
- pays
courriel:
title: Courriel de la fondation
type: string
nullable: true
example: contact@fondation-exemple.fr
telephone:
title: Numéro de téléphone de la fondation
type: string
nullable: true
example: "+33123456789"
required:
- service_instructeur
- type_fondation
- nom
- etat
- date_effet_etat
- date_creation
- duree_determinee
- date_terme
- cloture_exercice
- adresse_siege
- courriel
- telephone
activites:
title: Activités de la fondation
type: object
properties:
objet:
title: Objet de la fondation
description: Objet de la fondation tel que rédigé dans
ses statuts.
type: string
example: Contribuer à l'avancement de la science chimique
et au développement de ses applications.
domaines_interet_general:
title: Domaines d'intérêt général
type: array
items:
type: string
example: Scientifique
example:
- Social
- Scientifique
- Humanitaire
activite_internationale_prevue_par_statuts:
title: Activité internationale prévue par les statuts
type: boolean
nullable: true
example: false
required:
- objet
- domaines_interet_general
- activite_internationale_prevue_par_statuts
dirigeants:
title: Dirigeants et membres des organes de gouvernance
description: Personnes physiques exerçant des fonctions de
direction ou siégeant dans les organes de gouvernance. Un
dirigeant peut représenter une personne morale, détaillée
dans personne_morale.
type: array
items:
type: object
properties:
nom:
title: Nom du dirigeant
type: string
nullable: true
example: DUPONT
prenom:
title: Prénom du dirigeant
type: string
nullable: true
example: Marie
fonction:
title: Fonction exercée
type: string
nullable: true
example: Présidente
qualite:
title: Qualité au titre de laquelle la personne siège
type: string
nullable: true
example: Membre du conseil d'administration
date_naissance:
title: Date de naissance
type: string
format: date
nullable: true
example: '1980-05-12'
nationalite:
title: Nationalité
type: string
nullable: true
example: Française
pays_residence:
title: Pays de résidence
type: string
nullable: true
example: France
profession:
title: Profession
type: string
nullable: true
example: Juriste
date_entree_fonction:
title: Date d'entrée dans les fonctions
type: string
format: date
nullable: true
example: '2023-06-01'
date_sortie_fonction:
title: Date de sortie des fonctions
type: string
format: date
nullable: true
example:
fondateur:
title: Statut de fondateur
type: boolean
nullable: true
example: false
adresse_domiciliation:
title: Adresse de domiciliation du dirigeant
type: object
properties:
adresse_complete:
title: Adresse complète sur une ligne
type: string
nullable: true
example: 10 RUE DE LA REPUBLIQUE 21000 DIJON
complement:
title: Complément d'adresse
type: string
nullable: true
example:
numero_voie:
title: Numéro de voie
type: string
nullable: true
example: '10'
type_voie:
title: Type de voie
description: Type de voie tel que saisi dans le
référentiel, non normalisé (RUE, AV, BD, CHEM…).
type: string
nullable: true
example: RUE
libelle_voie:
title: Libellé de la voie
type: string
nullable: true
example: DE LA REPUBLIQUE
distribution:
title: Mention de distribution spéciale
type: string
nullable: true
example:
code_insee:
title: Code INSEE de la commune
type: string
nullable: true
example: '21231'
code_postal:
title: Code postal
type: string
nullable: true
example: '21000'
commune:
title: Commune
type: string
nullable: true
example: DIJON
pays:
title: Pays
type: string
nullable: true
example: France
personne_morale:
title: Personne morale représentée
description: Renseigné lorsque le dirigeant siège en
tant que représentant d'une personne morale. Null
pour une personne physique siégeant en son nom propre.
type: object
nullable: true
properties:
type:
title: Type de personne morale
type: string
nullable: true
example: Entreprise
identifiant:
title: Identifiant de la personne morale
type: string
nullable: true
example: '98765432100012'
nom:
title: Nom de la personne morale
type: string
nullable: true
example: ENTREPRISE EXEMPLE
pays:
title: Pays de la personne morale
type: string
nullable: true
example: France
filiation:
title: Filiation de l'organisme
description: Organismes liés par une opération de transformation,
de fusion ou de scission. Chaque entrée porte le type de
l'opération et l'identifiant de l'organisme qui en est issu.
La liste est vide lorsque l'organisme n'est concerné par
aucune opération.
type: array
items:
type: object
properties:
type_operation:
title: Type d'opération
type: string
enum:
- Transformation
- Fusion
- Scission
example: Fusion
identifiant:
title: Identifiant de l'organisme issu de l'opération
description: Identifiant RNA ou RNF selon la nature
de l'organisme lié.
type: string
nullable: true
example: W987654321
situation_financiere:
title: Situation financière déclarative
description: 'Données déclarées par la fondation via des démarches
dédiées : elles ne sont renseignées que lorsque la fondation
a effectué la démarche correspondante.'
type: object
properties:
annees_subventions_publiques:
title: Années pendant lesquelles la fondation a reçu des
subventions publiques
type: array
items:
type: integer
example:
- 2024
- 2025
annees_appel_generosite_publique:
title: Années pendant lesquelles la fondation a fait appel
à la générosité publique
type: array
items:
type: integer
example:
- 2025
annees_financements_etrangers:
title: Années pendant lesquelles la fondation a reçu un
financement étranger
type: array
items:
type: integer
example: []
required:
- annees_subventions_publiques
- annees_appel_generosite_publique
- annees_financements_etrangers
conformite_comptable:
title: Conformité comptable de la fondation
type: object
properties:
etat_transmission_comptes:
title: État de transmission des comptes
description: En défaut lorsque l'organisme est en retard
dans le dépôt de ses comptes annuels.
type: string
enum:
- En règle
- En défaut
example: En règle
annees_exercices_comptables_transmis:
title: Années des exercices comptables transmis
description: Années au titre desquelles la fondation a
déposé ses comptes annuels.
type: array
items:
type: integer
example: 2024
example:
- 2023
- 2024
- 2025
required:
- etat_transmission_comptes
- annees_exercices_comptables_transmis
documents:
title: Pièces justificatives déposées par la fondation
description: Métadonnées des documents déposés (statuts, comptes,
rapports d'activité, procès verbaux…). Le type et le nombre
de documents varient selon la fondation.
type: array
items:
type: object
properties:
id:
title: Identifiant du document
type: string
example: 7e7867b6-8fe0-11f1-a424-f28dce965a41
type:
title: Type de document
description: Nature de la pièce justificative déposée
par la fondation. Toutes les fondations ne déposent
pas tous les types de documents.
type: string
enum:
- Statuts
- Comptes
- Rapport d'activité
- Procès verbal
- Règlement intérieur
- Acte notarié lié à une libéralité
- Acte d'autorisation ou acte de non opposition
- Courrier adressé par l'administration
- Mise en demeure
- Suspension
- Décision de retrait / dissolution
- Jugement de dissolution judiciaire
example: Statuts
nom_original:
title: Nom original du fichier
type: string
nullable: true
example: Statuts 1957.pdf
type_mime:
title: Type MIME du fichier
type: string
nullable: true
example: application/pdf
date_depot:
title: Date de dépôt du document
type: string
format: date
nullable: true
example: '2026-06-24'
required:
- identifiants
- identite
- activites
- dirigeants
- filiation
- situation_financiere
- conformite_comptable
- documents
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_fondations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/fondations#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00331'
title: Entité non traitable
detail: Le numéro de siren, le numéro de siret ou l'identifiant
RNF indiqué n'est pas correctement formatté
source:
parameter: id
meta: {}
summary: Entité non traitable
description: Le numéro de siren, le numéro de siret ou l'identifiant
RNF indiqué n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Fondation non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_fondations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/fondations#erreurs.
content:
application/json:
examples:
entite_non_trouvee_44003:
value:
errors:
- code: '44003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: SIAF
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_fondations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/fondations#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_44999:
value:
errors:
- code: '44999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: SIAF
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_fondations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/fondations#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '44002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: SIAF
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_fondations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/fondations#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_fondations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/fondations#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '44020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: SIAF
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_mi_siaf_fondations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/siaf/fondations#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://staging.entreprise.api.gouv.fr/v3/ministere_interieur/siaf/fondations/13002526500013?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/msa/etablissements/{siret}/conformite_cotisations":
get:
summary: Conformité cotisations de sécurité sociale agricole
tags:
- Attestations sociales et fiscales
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Statut des cotisations sociales d'une entreprise indiquant si elle
est en règle auprès de la sécurité sociale agricole (MSA).
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_msa_conformites_cotisations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/msa/conformites_cotisations#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_msa_conformites_cotisations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/msa/conformites_cotisations#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_msa_conformites_cotisations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/msa/conformites_cotisations#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_msa_conformites_cotisations
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
status:
type: string
title: Status
description: "Détermine le statut des cotisations, les valeurs
possibles: \n \n * up_to_date : l'entreprise est à jour
de ses cotisations \n * outdated : l'entreprise n'est pas
à jour de ses cotisations \n * under_investigation : l'entreprise
est en cours d'analyse par un agent de la MSA"
enum:
- up_to_date
- outdated
- under_investigation
required:
- status
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_msa_conformites_cotisations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/msa/conformites_cotisations#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_msa_conformites_cotisations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/msa/conformites_cotisations#erreurs.
content:
application/json:
examples:
entite_non_trouvee_10003:
value:
errors:
- code: '10003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: MSA
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_msa_conformites_cotisations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/msa/conformites_cotisations#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_10999:
value:
errors:
- code: '10999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: MSA
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_msa_conformites_cotisations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/msa/conformites_cotisations#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '10002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: MSA
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_msa_conformites_cotisations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/msa/conformites_cotisations#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_msa_conformites_cotisations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/msa/conformites_cotisations#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '10020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: MSA
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_msa_conformites_cotisations, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/msa/conformites_cotisations#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-maintenances:
from_hour: '03:00'
to_hour: '03:30'
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/msa/etablissements/13002526500013/conformite_cotisations?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/opqibi/unites_legales/{siren}/certification_ingenierie":
get:
summary: Certification d'ingénierie OPQIBI
tags:
- Certifications professionnelles
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siren
in: path
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Certification délivrée par l'association OPQIBI, attestant des
différentes qualifications d'ingénierie d'une unité légale.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_opqibi_certifications_ingenierie, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/opqibi/qualifications_ingenierie#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_opqibi_certifications_ingenierie, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/opqibi/qualifications_ingenierie#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_opqibi_certifications_ingenierie, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/opqibi/qualifications_ingenierie#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_opqibi_certifications_ingenierie
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
numero_certificat:
title: Numéro de certificat
type: string
url:
title: URL Certificat
description: URL pour consulter ce certificat sur le site
de l'OPQIBI
type: string
example: https://www.opqibi.com/fiche/1777
date_delivrance_certificat:
title: Date de délivrance du certificat
description: Date à laquelle a été délivré le certificat
type: string
example: '2021-01-28'
duree_validite_certificat:
title: Durée de validité du certificat
description: Durée pendant laquelle le certificat est valide
type: string
example: valable un an
assurances:
title: Assurance(s)
description: Liste d'assurances reconnaissant le certificat
(i.e pour avantages tarifaires). Les noms sont séparés par
un tiret.
type: string
example: ALLIANZ - XL INSURANCE
qualifications:
title: Qualifications
description: |
Qualifications de l'entreprise. Un certificat de qualification atteste qu'une
structure possède l'aptitude à réaliser et a déjà réalisé les prestations
pour lesquelles elle est qualifiée.
type: array
items:
type: object
additionalProperties: false
properties:
nom:
title: Nom
description: Nom de la qualification
type: string
example: Etude thermique réglementaire "maison individuelle"
code_qualification:
title: Code
description: Code de la qualification
type: string
example: '1331'
definition:
title: Définition
description: Définition de la qualification
type: string
example: Cette qualification correspond à la réalisation
des calculs thermiques réglementaires pour les constructions
neuves.
rge:
title: RGE
description: Précise si la qualification porte la mention
RGE (Reconnu Garant de l'Environnement)
type: boolean
example: false
date_validite_qualifications:
title: Date de validité des qualifications
description: Date jusqu'à laquelle les qualifications sont
valables
type: string
example: '2025-02-21'
qualifications_probatoires:
description: |
Qualifications de l'entreprise. Un certificat de qualification probatoire atteste qu'une
structure possède l'aptitude à réaliser les prestations pour lesquelles elle est qualifiée,
mais qu'elle ne les a pas encore ou pas suffisamment réalisées.
type: array
items:
type: object
additionalProperties: false
properties:
nom:
title: Nom
description: Nom de la qualification
type: string
example: Etude thermique réglementaire "maison individuelle"
code_qualification:
title: Code
description: Code de la qualification
type: string
example: '1331'
definition:
title: Définition
description: Définition de la qualification
type: string
example: Cette qualification correspond à la réalisation
des calculs thermiques réglementaires pour les constructions
neuves.
rge:
title: RGE
description: Précise si la qualification porte la mention
RGE (Reconnu Garant de l'Environnement)
type: boolean
example: false
date_validite_qualifications_probatoires:
title: Date de validité des qualifications probatoires
description: Date jusqu'à laquelle les qualifications probatoires
sont valables
type: string
example: '2025-02-21'
nullable: true
required:
- numero_certificat
- url
- date_delivrance_certificat
- duree_validite_certificat
- assurances
- qualifications
- date_validite_qualifications
- qualifications_probatoires
- date_validite_qualifications_probatoires
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_opqibi_certifications_ingenierie, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/opqibi/qualifications_ingenierie#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_opqibi_certifications_ingenierie, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/opqibi/qualifications_ingenierie#erreurs.
content:
application/json:
examples:
entite_non_trouvee_11003:
value:
errors:
- code: '11003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: OPQIBI
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_opqibi_certifications_ingenierie, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/opqibi/qualifications_ingenierie#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_11999:
value:
errors:
- code: '11999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: OPQIBI
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_opqibi_certifications_ingenierie, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/opqibi/qualifications_ingenierie#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '11002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: OPQIBI
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_opqibi_certifications_ingenierie, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/opqibi/qualifications_ingenierie#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_opqibi_certifications_ingenierie, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/opqibi/qualifications_ingenierie#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '11020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: OPQIBI
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_opqibi_certifications_ingenierie, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/opqibi/qualifications_ingenierie#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/opqibi/unites_legales/130025265/certification_ingenierie?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/probtp/etablissements/{siret}/attestation_cotisations_retraite":
get:
summary: Conformité cotisations retraite bâtiment
tags:
- Attestations sociales et fiscales
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Attestation délivrée par la Protection sociale du bâtiment et des
travaux publics (PROBTP), indiquant que l'entreprise est à jour de ses cotisations.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_attestations_cotisation_retraite.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_attestations_cotisation_retraite.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_attestations_cotisation_retraite.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Attestation found
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_probtp_attestations_cotisation_retraite
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
document_url:
type: string
title: Lien vers l'attestation de cotisation retraite ProBTP
description: Ce document est automatiquement supprimé au bout
de 3 mois.
example: https://raw.githubusercontent.com/datagouv/apistration/refs/heads/develop/mocks/payloads/api_entreprise_v3_probtp_attestations_cotisation_retraite/test_probtp_attestation.pdf
expires_in:
type: integer
example: 7889238
description: 'Nombre de secondes avant l''expiration de l''url
associée à l''attribut document_url : cette durée correspond
généralement à 24h.'
required:
- document_url
- expires_in
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_attestations_cotisation_retraite.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_attestations_cotisation_retraite.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_09999:
value:
errors:
- code: '09999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: ProBTP
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Attestation non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_attestations_cotisation_retraite.
content:
application/json:
examples:
entite_non_trouvee_09003:
value:
errors:
- code: '09003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: ProBTP
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_attestations_cotisation_retraite.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '09002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: ProBTP
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_attestations_cotisation_retraite.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_attestations_cotisation_retraite.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '09020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: ProBTP
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_attestations_cotisation_retraite.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/probtp/etablissements/13002526500013/attestation_cotisations_retraite?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/probtp/etablissements/{siret}/conformite_cotisations_retraite":
get:
summary: Conformité cotisations retraite complémentaire
tags:
- Attestations sociales et fiscales
parameters:
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
- name: siret
in: path
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Régularité des cotisations de retraite complémentaire auprès de
la Protection Sociale du Bâtiment et des Travaux publics (ProBTP).
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_conformites_cotisations_retraite, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/probtp/conformites_cotisations_retraite#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_conformites_cotisations_retraite, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/probtp/conformites_cotisations_retraite#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_conformites_cotisations_retraite, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/probtp/conformites_cotisations_retraite#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_probtp_conformites_cotisations_retraite
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
eligible:
type: boolean
example: true
enum:
- true
- false
description: Détermine si une entreprise est éligible ou non
aux cotisations retraites de ProBTP.
required:
- eligible
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_conformites_cotisations_retraite, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/probtp/conformites_cotisations_retraite#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_conformites_cotisations_retraite, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/probtp/conformites_cotisations_retraite#erreurs.
content:
application/json:
examples:
entite_non_trouvee_09003:
value:
errors:
- code: '09003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: ProBTP
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_conformites_cotisations_retraite, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/probtp/conformites_cotisations_retraite#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_09999:
value:
errors:
- code: '09999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: ProBTP
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_conformites_cotisations_retraite, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/probtp/conformites_cotisations_retraite#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '09002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: ProBTP
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_conformites_cotisations_retraite, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/probtp/conformites_cotisations_retraite#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_conformites_cotisations_retraite, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/probtp/conformites_cotisations_retraite#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '09020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: ProBTP
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_probtp_conformites_cotisations_retraite, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/probtp/conformites_cotisations_retraite#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/probtp/etablissements/13002526500013/conformite_cotisations_retraite?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/qualibat/etablissements/{siret}/certification_batiment":
get:
summary: Certification Qualibat (PDF seulement)
tags:
- Certifications professionnelles
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
deprecated: true
security:
- jwt_bearer_token: []
description: Certification délivrée par l'association Qualibat, attestant de
la qualification d’une entreprise dans le bâtiment.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/v3/certifications_batiment#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/v3/certifications_batiment#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/v3/certifications_batiment#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Certification trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_qualibat_certifications_batiment
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
document_url:
type: string
title: Lien vers la certification batiment Qualibat
description: Cette URL permet de télécharger la certification
Qualibat au format PDF.
example: https://raw.githubusercontent.com/datagouv/apistration/refs/heads/develop/mocks/payloads/api_entreprise_v4_qualibat_certifications_batiment/exemple-qualibat.pdf
expires_in:
type: integer
example: 7889238
description: 'Nombre de secondes avant l''expiration de l''url
associée à l''attribut document_url : cette durée correspond
généralement à 24h.'
required:
- document_url
- expires_in
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/v3/certifications_batiment#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/v3/certifications_batiment#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_06999:
value:
errors:
- code: '06999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: Qualibat
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Certification non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/v3/certifications_batiment#erreurs.
content:
application/json:
examples:
entite_non_trouvee_06003:
value:
errors:
- code: '06003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: Qualibat
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/v3/certifications_batiment#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '06002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: Qualibat
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/v3/certifications_batiment#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/v3/certifications_batiment#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '06020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: Qualibat
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/v3/certifications_batiment#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/qualibat/etablissements/13002526500013/certification_batiment?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/qualibat/etablissements/{siret}/certification_batiment":
get:
summary: Certification Qualibat
tags:
- Certifications professionnelles
parameters:
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Certification délivrée par l'association Qualibat, attestant de
la qualification d’une entreprise dans le bâtiment.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/certifications_batiment#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/certifications_batiment#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/certifications_batiment#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Certification trouvée
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). Le cache est valide jusqu'à la
fin de la journée
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_qualibat_certifications_batiment
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
document_url:
title: Lien vers la certification batiment Qualibat
type: string
description: Cette URL permet de télécharger la certification
Qualibat au format PDF.
example: https://raw.githubusercontent.com/datagouv/apistration/refs/heads/develop/mocks/payloads/api_entreprise_v4_qualibat_certifications_batiment/exemple-qualibat.pdf
document_url_expires_in:
title: Nombre de secondes avant expiration du document référencé
dans 'document_url'
description: 'Il s''agit d''une expiration technique: cette
valeur n''a aucun lien avec les dates de fin de validité
ou d''émission.'
type: integer
example: 86400
date_emission:
title: Date d'émission du document
type: string
format: date
nullable: true
example: '2023-01-01'
date_fin_validite:
title: Date de fin de validité du document
type: string
format: date
nullable: true
example: '2024-02-02'
entity:
type: object
title: Informations sur l'entité référencée dans le document
properties:
assurance_responsabilite_travaux:
title: Informations relatives à l'assurance responsabilité
travaux
description: Les attributs peuvent être nuls si les informations
sont absentes du PDF ou si l'assurance est inconnue
de notre service.
type: object
properties:
nom:
title: Nom de l'assurance
example: GROUPAMA
type: string
nullable: true
identifiant:
title: Numéro d'identification de l'entité enregistrée
auprès de l'assurance
example: '1234567890'
type: string
nullable: true
required:
- nom
- identifiant
assurance_responsabilite_civile:
title: Informations relatives à l'assurance responsabilité
civile
type: object
description: Les attributs peuvent être nuls si les informations
sont absentes du PDF ou si l'assurance est inconnue
de notre service.
properties:
nom:
title: Nom de l'assurance
example: GROUPAMA
type: string
nullable: true
identifiant:
title: Numéro d'identification de l'entité enregistrée
auprès de l'assurance
example: '1234567890'
type: string
nullable: true
required:
- nom
- identifiant
certifications:
type: array
title: Tableau des certifications associées à l'entité
items:
type: object
title: Certification
nullable: true
properties:
code:
type: string
title: Code associé à la certification
example: '4322'
libelle:
title: Libellé de la certification
type: string
example: Fabrication et pose de menuiserie intérieure
en bois
rge:
title: Indique si la certification est RGE
description: Ce champ indique si la certification
est labellisée RGE (reconnu garant de l'environnement)
type: boolean
example: false
enum:
- true
- false
date_attribution:
title: Date d'attribution
type: string
format: date
example: '2022-03-03'
required:
- assurance_responsabilite_travaux
- assurance_responsabilite_civile
- certifications
required:
- document_url
- document_url_expires_in
- date_emission
- date_fin_validite
- entity
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/certifications_batiment#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/certifications_batiment#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_06999:
value:
errors:
- code: '06999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: Qualibat
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Certification non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/certifications_batiment#erreurs.
content:
application/json:
examples:
entite_non_trouvee_06003:
value:
errors:
- code: '06003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: Qualibat
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/certifications_batiment#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '06002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: Qualibat
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/certifications_batiment#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/certifications_batiment#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '06020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: Qualibat
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_qualibat_certifications_batiment, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualibat/certifications_batiment#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/qualibat/etablissements/13002526500013/certification_batiment?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/qualifelec/etablissements/{siret}/certificats":
get:
summary: Certification Qualifelec
tags:
- Certifications professionnelles
parameters:
- name: siret
in: path
description: Siret de l'établissement
examples:
siret_octo_technology:
value: '41816609600069'
summary: SIRET Octo Technology
siret_non_diffusible:
value: '00557246600026'
summary: SIRET établissement non diffusible
siret_msa:
value: '81104725700019'
summary: SIRET pour MSA
siret_probtp:
value: '43841606700017'
summary: SIRET pour ProBTP
siret_qualibat:
value: '78824266700020'
summary: SIRET pour Qualibat
siret_entrepreneur_individuel:
value: '38983993700015'
summary: SIRET d'un entrepreneur individuel (fermé)
siret_ademe:
value: '42878198300039'
summary: SIRET pour ADEME RGE
siret_qualifelec:
value: '42054064300376'
summary: SIRET pour Qualifelec
siret_qualiopi:
value: '81841109200013'
summary: SIRET pour Qualiopi
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Certification délivrée par Qualifelec, attestant des qualifications
d'une entreprise dans le génie électrique et énergétique.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualifelec_certificats, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualifelec/certificats#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualifelec_certificats, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualifelec/certificats#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise trouvée
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_qualifelec_certificats
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
data:
type: object
properties:
document_url:
title: URL de téléchargement du certificat Qualifelec
type: string
description: Ce lien délivre le certificat Qualifelec
de l'entreprise au format PDF tel qu'accessible depuis
le site https://www.qualifelec.fr/.
example: https://raw.githubusercontent.com/datagouv/apistration/refs/heads/develop/mocks/payloads/api_entreprise_v3_qualifelec_certificats/exemple-certificat-qualifelec-bac-a-sable.jpg
numero:
title: Numéro du certificat
type: number
description: Le numéro d'attribution du certificat
example: 5430
rge:
title: Label RGE de l'entreprise
type: boolean
description: Indique si l'entreprise est également labellisée
RGE, soit "Reconnu Garant de l'Environnement". Ce
label concerne les entreprises spécialisées dans les
travaux d'efficacité énergétique en rénovation et
l'installation d'équipements utilisant des énergies
renouvelables.
example: true
date_debut:
title: Date de début du certificat
type: string
format: date
description: Date de début de validité du certificat
example: '2019-01-01'
date_fin:
title: Date de fin du certificat
type: string
format: date
description: Date de fin de validité du certificat
example: '2021-12-31'
qualification:
title: Informations détaillées de la qualification
type: object
properties:
label:
title: Libellé de la qualification
type: string
description: Libellé de la qualification
example: Installations Électriques Logement Commerce
Petit Tertiaire - LCPT
date_debut:
title: Date de début de la qualification
type: string
format: date
description: Date de début de validité de la qualification
example: '2019-01-01'
date_fin:
title: Date de fin de la qualification
type: string
format: date
description: Date de fin de validité de la qualification.
La durée d'une qualification est de 4 ans. Cette
durée est réduite à 2 années pour les qualifications
probatoires.
example: '2024-12-31'
indices:
title: Indices
description: Ces indices précisent le type et le
volume du marché, la puissance ou le rendement
d'un équipement et une technicité spécifique.
Une qualification peut être accompagnée de plusieurs
indices.
type: array
minItems: 1
items:
title: Codes et libéllés des indices de la qualification
type: object
properties:
code:
title: Code de l'indice
type: string
description: Code de l'indice associé à la
qualification.
example: IRVE1
label:
title: Libellé de l'indice
type: string
description: Indice de la qualification.
example: IRVE – indice 1 (station de recharge
– puissance maximale appelable inférieure
ou égale à 36 kVA)
mentions:
title: mentions
description: La mention valorise un complément d’activité
associé à la qualification. Une qualification
peut être accompagnée d'une ou plusieurs mentions.
type: array
minItems: 1
items:
title: Codes et libéllés des mentions de la qualification
type: object
properties:
code:
title: Code de la mention
type: string
description: Code de la mention associé à
la qualification.
example: PRGE
label:
title: Libellé de la mention
type: string
description: Libellé de la mention de la qualification.
example: Probatoire Reconnu Garant de l’Environnement
domaines:
title: Domaines
description: Le domaine correspond à une activité
particulière au sein de l'activité principale
de la qualification. Une qualification peut être
accompagnée de plusieurs domaines.
type: array
items:
title: Codes et libéllés des domaines de la qualification
type: object
properties:
code:
title: Code du domaine
type: string
description: Code du domaine associé à la
qualification.
example: SU
label:
title: Libellé du domaine
type: string
description: Libellé du domaine de la qualification.
example: Sûreté
classification:
title: Classification de la qualification
description: La classification indique les moyens
humains possédés par l'entreprise pour réaliser
les travaux liées à la qualification. Elle précise
l'effectif du personnel d'exécution et d'encadrement
permanent de l'entreprise. Ce champ peut être
nul dans le cas où la qualification est une qualification
probatoire.
type: object
properties:
code:
title: Code de la classification
type: integer
description: Code de la classification associé
à la qualification.
example: '1'
nullable: true
label:
title: Libellé de la classification
type: string
description: Libellé de la classification de
la qualification.
example: Classe 1 - de 1 à 3 exécutants
nullable: true
required:
- code
- label
required:
- label
- date_debut
- date_fin
- indices
- mentions
- domaines
- classification
assurance_decennale:
title: Assurance décennale vérifiée au moment de l'édition
du certificat
type: object
properties:
nom:
title: Nom de l'assurance décennale
type: string
description: Avant de délivrer le certificat, Qualifelec
demande à l'entreprise son attestation d'assurance
décennale. Ce justificatif est redemandé chaque
année lors de la mise à jour du dossier annuel
qui permet la génération du certificat annuel.
Pour certaines activités, l'assurance décennale
n'est pas obligatoire.
example: AXA
date_debut:
title: Date de début de validité
type: string
format: date
description: Date de début de validité de l’attestation
d’assurance décennale
nullable: true
example: '2024-01-31'
date_fin:
title: Date de fin de validité
type: string
format: date
description: Date de fin de validité de l’attestation
d’assurance décennale
nullable: true
example: '2024-12-31'
required:
- nom
- date_debut
- date_fin
assurance_civile:
title: Assurance civile vérifiée au moment de l'édition
du certificat
description: Avant de délivrer le certificat, Qualifelec
demande à l'entreprise son attestation d'assurance
responsabilité civile. Ce justificatif est redemandé
chaque année lors de la mise à jour du dossier annuel
qui permet la génération du certificat annuel.
type: object
properties:
nom:
title: Assurance responsabilité civile
type: string
description: nom de l’assurance responsabilité civile
example: HISCOX
date_debut:
title: Date de début de validité
type: string
format: date
description: Date de début de validité de l’attestation
d’assurance responsabilité civile
nullable: true
example: '2024-01-31'
date_fin:
title: Date de fin de validité
type: string
format: date
description: Date de fin de validité de l’attestation
d’assurance responsabilité civile
nullable: true
example: '2024-12-31'
required:
- nom
- date_debut
- date_fin
required:
- document_url
- numero
- rge
- date_debut
- date_fin
- qualification
- assurance_decennale
- assurance_civile
links:
type: object
meta:
type: object
meta:
type: object
links:
type: object
required:
- data
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualifelec_certificats, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualifelec/certificats#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00302'
title: Entité non traitable
detail: Le numéro de siret n'est pas correctement formatté
source:
parameter: siret
meta: {}
summary: Entité non traitable
description: Le numéro de siret n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualifelec_certificats, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualifelec/certificats#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualifelec_certificats, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualifelec/certificats#erreurs.
content:
application/json:
examples:
entite_non_trouvee_32003:
value:
errors:
- code: '32003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: Qualifelec
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualifelec_certificats, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualifelec/certificats#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_32999:
value:
errors:
- code: '32999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: Qualifelec
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualifelec_certificats, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualifelec/certificats#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '32002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: Qualifelec
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualifelec_certificats, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualifelec/certificats#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualifelec_certificats, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualifelec/certificats#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '32020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: Qualifelec
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_qualifelec_certificats, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/qualifelec/certificats#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/qualifelec/etablissements/13002526500013/certificats?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v3/cma_france/rnm/unites_legales/{siren}":
get:
summary: Données du RNM d'une entreprise artisanale
tags:
- Informations générales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
deprecated: true
security:
- jwt_bearer_token: []
description: Informations de référence d'une entreprise artisanale enregistrée
au répertoire national des métiers (RNM).
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_rnm_entreprises_artisanales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cma_france/rnm#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_rnm_entreprises_artisanales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cma_france/rnm#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_rnm_entreprises_artisanales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cma_france/rnm#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise found
headers:
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v3_rnm_entreprises_artisanales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
modalite_exercice:
type: string
example: P
description: "Détermine si l'entreprise a une activité permanente
ou saisonnière. \n L'activité est dite saisonnière si chaque
année, l'entreprise cesse totalement ses activités pendant
plus de 3 mois consécutifs. \n \n Les valeurs possibles
sont: \n - P => Permanent \n - S => Saisonnière \n - NR
=> Non renseignée"
enum:
- P
- S
- NR
non_sedentaire:
type: string
example: '0'
description: "Indique si l'entreprise a une activité ambulante.
\n \n Les valeurs possibles sont: \n - 0 => sédentaire \n
- 1 => non-sédentaire"
enum:
- '0'
- '1'
required:
- modalite_exercice
- non_sedentaire
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_rnm_entreprises_artisanales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cma_france/rnm#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Entreprise non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_rnm_entreprises_artisanales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cma_france/rnm#erreurs.
content:
application/json:
examples:
entite_non_trouvee_22003:
value:
errors:
- code: '22003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: RNM
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_rnm_entreprises_artisanales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cma_france/rnm#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_15999:
value:
errors:
- code: '15999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: CMA France
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_rnm_entreprises_artisanales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cma_france/rnm#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '15002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: CMA France
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_rnm_entreprises_artisanales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cma_france/rnm#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_rnm_entreprises_artisanales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cma_france/rnm#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '15020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: CMA France
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v3_rnm_entreprises_artisanales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/cma_france/rnm#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/cma_france/rnm/unites_legales/130025265?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
"/v4/urssaf/unites_legales/{siren}/attestation_vigilance":
get:
summary: Attestation de vigilance
tags:
- Attestations sociales et fiscales
parameters:
- name: siren
in: path
description: Siren de l'entreprise
examples:
siren_octo_technology:
value: '418166096'
summary: SIREN Octo Technology
siren_non_diffusible:
value: '005572466'
summary: SIREN entreprise non diffusible
siren_artisant:
value: '301123626'
summary: SIREN entreprise artisanale
siren_fntp:
value: '339379984'
summary: SIREN pour FNTP
siren_cnetp:
value: '542036207'
summary: SIREN pour CNETP
siren_opqibi:
value: '515228211'
summary: SIREN pour OPQIBI
siren_entrepreneur_individuel:
value: '389839937'
summary: SIREN d'un entrepeneur individuel (cessé)
siren_marques_brevets_modeles:
value: '542065479'
summary: SIREN d'une entreprise ayant des marques, brevets et modèles
(INPI)
required: true
schema:
type: string
- name: Cache-Control
in: header
description: Si cette valeur est fixée à "no-cache", le système de cache est
alors ignoré et la donnée est directement récupérée depuis le fournisseur
de données.
schema:
type: string
- name: recipient
in: query
description: |-
"**Bénéficiaire de l’appel**
SIRET de l’administration destinatrice des données."
example: '13002526500013'
required: true
schema:
type: string
- name: delegation_id
in: query
description: |-
"**Identifiant de la délégation éditeur**
UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)."
example: 6f3c8d9a-1b2c-4d5e-8f90-abcdef012345
required: false
schema:
type: string
- name: context
in: query
description: |-
"**Cadre de la requête**
Par exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application."
example: Context de test
required: true
schema:
type: string
- name: object
in: query
description: |-
"**La raison de l’appel ou l’identifiant de la procédure.**
L’identifiant peut être interne à votre organisation ou bien un numéro de marché publique, un nom de procédure ; l’essentiel est que celui-ci vous permette de tracer et de retrouver les informations relatives à l’appel. En effet, vous devez pouvoir justifier de la raison d’un appel auprès du fournisseur de données. Description courte ( < 50 caractères )."
example: marché numéro 127
required: true
schema:
type: string
security:
- jwt_bearer_token: []
description: Attestation sociale délivrée à une entreprise acquittée de ses
obligations de cotisations et contributions sociales auprès de l'URSSAF Caisse
nationale.
responses:
'401':
description: |-
Non autorisé
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/attestation_vigilance#erreurs.
content:
application/json:
examples:
invalid_token_error:
value:
errors:
- code: '00101'
title: Interdit
detail: Votre token n'est pas valide
source:
parameter: token
meta: {}
summary: Interdit
description: Votre token n'est pas valide
schema:
"$ref": "#/components/schemas/Error"
'403':
description: |-
Accès interdit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/attestation_vigilance#erreurs.
content:
application/json:
examples:
insufficient_privileges_error:
value:
errors:
- code: '00100'
title: Privilèges insuffisants
detail: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
source:
parameter: token
meta: {}
summary: Privilèges insuffisants
description: Votre token est valide mais vos privilèges sont insuffisants.
Listez vos privilèges sur /v2/privileges
schema:
"$ref": "#/components/schemas/Error"
'429':
description: |-
Trop de requêtes
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/attestation_vigilance#erreurs.
content:
application/json:
examples:
too_many_requests_error:
value:
errors:
- code: '00429'
title: Trop de requêtes
detail: Vous avez effectué trop de requêtes
source:
meta: {}
summary: Trop de requêtes
description: Vous avez effectué trop de requêtes
schema:
"$ref": "#/components/schemas/Error"
'200':
description: Entreprise found
headers:
X-Response-Cached:
schema:
type: boolean
example: true
enum:
- true
- false
default: false
description: Indique si la réponse a été caché.
X-Cache-Expires-in:
schema:
type: number
nullable: true
example: 9001
description: Secondes avant que le cache n'expire. Si le cache est vide,
ce header est vide (mais présent). Le cache est valide jusqu'au lendemain
8h.
RateLimit-Limit:
schema:
type: integer
description: La limite concernant l’endpoint appelé, soit le nombre
de requête/minute.
example: 50
RateLimit-Remaining:
schema:
type: integer
description: Le nombre d’appels restants durant la période courante
d’une minute.
example: 47
RateLimit-Reset:
schema:
type: integer
description: La fin de la période courante (en format timestamp)
example: 1637223155
x-operationId: api_entreprise_v4_acoss_attestations_sociales
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
entity_status:
title: Status de l'entreprise vis-à-vis de ses obligations
sociales
type: object
additionalProperties: false
properties:
code:
type: string
title: Code du status
description: Cette valeur ne peut être actuellement que
'ok' ou 'refus_de_delivrance'. Pour ce dernier cas,
cela signifie que l'entité n'est pas à jour de ses cotisations.
enum:
- ok
- refus_de_delivrance
example: ok
libelle:
type: string
title: Libellé associé au code
example: Attestation délivrée par l'Urssaf
description:
type: string
title: Description associé au code
example: La délivrance de l'attestation de vigilance a
été refusée par l'Urssaf car l'entité n'est pas à jour
de ses cotisations sociales.
required:
- code
- libelle
- description
date_debut_validite:
title: Date de début de validité
type: string
format: date
nullable: true
description: "Cette date est présente en fin de document dans
le paragraphe « Attestation de l'union de recouvrement ».
\n \n Cette donnée est extraire du document PDF par API
Entreprise."
example: '2022-12-03'
date_fin_validite:
title: Date de fin de validité
type: string
format: date
nullable: true
description: "Cette date est obtenue à l'aide de la date de
début de validité. \n \n La règle de calcul est la suivante:
6 mois après la date de début de validité, à la fin du mois.
Par exemple si une date de début de validité est le 03/12/2022,
alors la date de fin de validité est le 30/06/2023. \n Cette
donnée est calculée par API Entreprise."
example: '2023-06-30'
code_securite:
title: Code de sécurité
type: string
nullable: true
description: "Ce code de sécurité permet de vérifier auprès
de l'URSSAF la véracité des informations du document. Vous
pouvez faire cette vérification sur le lien suivant: https://www.urssaf.fr/portail/home/utile-et-pratique/verification-attestation.html
\n \n Cette donnée est extraire du document PDF par API
Entreprise."
example: GB1QWERTYJJEX1O
document_url:
title: URL de téléchargement de l'attestation de vigilance
type: string
nullable: true
description: Ce lien délivre l'attestation de vigilance de
l'entreprise au format PDF.
example: https://raw.githubusercontent.com/datagouv/apistration/refs/heads/develop/mocks/payloads/api_entreprise_v4_acoss_attestations_sociales/attestation_vigilance_test.pdf
document_url_expires_in:
title: Nombre de secondes avant expiration du document référencé
dans 'document_url'
description: 'Il s''agit d''une expiration technique: cette
valeur n''a aucun lien avec les dates de debut ou de fin
de validité.'
type: integer
nullable: true
example: 86400
required:
- entity_status
- date_debut_validite
- date_fin_validite
- code_securite
- document_url
- document_url_expires_in
additionalProperties: false
links:
type: object
meta:
type: object
required:
- data
- links
- meta
'422':
description: |-
Paramètre(s) invalide(s)
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/attestation_vigilance#erreurs.
content:
application/json:
examples:
unprocessable_content_error:
value:
errors:
- code: '00301'
title: Entité non traitable
detail: Le numéro de siren n'est pas correctement formatté
source:
parameter: siren
meta: {}
summary: Entité non traitable
description: Le numéro de siren n'est pas correctement formatté
schema:
"$ref": "#/components/schemas/Error"
'502':
description: |-
Erreur du fournisseur
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/attestation_vigilance#erreurs.
content:
application/json:
examples:
erreur_inconnue_du_fournisseur_de_donnees_04999:
value:
errors:
- code: '04999'
title: Erreur inconnue du fournisseur de données
detail: La réponse retournée par le fournisseur de données est
invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
source:
meta:
provider: ACOSS
summary: Erreur inconnue du fournisseur de données
description: La réponse retournée par le fournisseur de données
est invalide et inconnue de notre service. L'équipe technique
a été notifiée de cette erreur pour investigation.
schema:
"$ref": "#/components/schemas/Error"
'404':
description: |-
Entreprise non trouvée
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/attestation_vigilance#erreurs.
content:
application/json:
examples:
entite_non_trouvee_04003:
value:
errors:
- code: '04003'
title: Entité non trouvée
detail: Le ou les paramètre(s) d'entrée n'existent pas, ne sont
pas connus, ou ne comportent aucune information pour cet appel.
Veuillez vérifier que votre recherche est couverte par le
périmètre de l'API.
source:
meta:
provider: ACOSS
summary: Entité non trouvée
description: Le ou les paramètre(s) d'entrée n'existent pas, ne
sont pas connus, ou ne comportent aucune information pour cet
appel. Veuillez vérifier que votre recherche est couverte par
le périmètre de l'API.
schema:
"$ref": "#/components/schemas/Error"
'504':
description: |-
Erreur d'intermédiaire
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/attestation_vigilance#erreurs.
content:
application/json:
examples:
timeout_error:
value:
errors:
- code: '04002'
title: Intermédiaire hors-délai
detail: Temps d’attente d’une réponse du fournisseur de données
écoulé.
source:
meta:
provider: ACOSS
summary: Intermédiaire hors-délai
description: Temps d’attente d’une réponse du fournisseur de données
écoulé.
schema:
"$ref": "#/components/schemas/Error"
'409':
description: |-
Conflit
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/attestation_vigilance#erreurs.
content:
application/json:
examples:
conflict_error:
value:
errors:
- code: '00015'
title: Conflit
detail: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin
du traitement avant d'effectuer une nouvelle requête.
source:
meta: {}
summary: Conflit
description: Une requête associé à votre jeton est déjà en cours
de traitement pour ces paramètres. Veuillez attendre la fin du
traitement avant d'effectuer une nouvelle requête.
schema:
"$ref": "#/components/schemas/Error"
'503':
description: |-
Fournisseur de données en maintenance
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/attestation_vigilance#erreurs.
content:
application/json:
examples:
maintenance_error:
value:
errors:
- code: '04020'
title: Maintenance du fournisseur de données
detail: Le fournisseur de données semble être en maintenance
source:
meta:
provider: ACOSS
summary: Maintenance du fournisseur de données
description: Le fournisseur de données semble être en maintenance
schema:
"$ref": "#/components/schemas/Error"
'400':
description: |-
Mauvaise requête
L'exemple ci-dessous n'en est qu'un parmi d'autres : la liste complète des codes erreurs de cet endpoint est disponible sur https://entreprise.api.gouv.fr/v3/errors?operation_id=api_entreprise_v4_acoss_attestations_sociales, et commentée dans la section « Erreurs » de https://entreprise.api.gouv.fr/catalogue/urssaf/attestation_vigilance#erreurs.
content:
application/json:
examples:
error_00401:
value:
errors:
- code: '00401'
title: Mauvaise requête
detail: Votre requête est invalide
source:
meta: {}
summary: Mauvaise requête
description: Votre requête est invalide
schema:
"$ref": "#/components/schemas/Error"
x-codeSamples:
- lang: cURL
label: Ligne de commande
source: |-
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v4/urssaf/unites_legales/130025265/attestation_vigilance?context=Test+de+l%27API&object=Test+de+l%27API&recipient=10000001700010"
servers:
- url: https://entreprise.api.gouv.fr
description: Environnement de production
- url: https://staging.entreprise.api.gouv.fr
description: Environnement de staging
components:
schemas:
Error:
type: object
properties:
errors:
type: array
items:
type: object
properties:
title:
type: string
detail:
type: string
code:
type: string
required:
- title
- detail
- code
required:
- errors
securitySchemes:
jwt_bearer_token:
type: http
description: |-
Votre jeton d'authentification doit être placé dans le header 'Authorization: Bearer VOTRE_JWT', sa validité est de 18 mois.
Exemple cURL :
curl -X GET \
-H "Authorization: Bearer $token" \
--url "https://entreprise.api.gouv.fr/v3/..."
name: Authorization
in: header
scheme: bearer
bearerFormat: JWT