---
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
paths:
  "/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_vrivileges_
        '401':
          description: Non autorisé
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
        '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_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                unprocessable_content_error_limit_error:
                  value:
                    errors:
                    - code: '00313'
                      title: Entité non traitable
                      detail: Le paramètre limit n'est pas correctement formatté
                      source:
                        parameter: limit
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre limit n'est pas correctement formatté
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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
                unprocessable_content_error_siret_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
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_19000:
                  value:
                    errors:
                    - code: '19000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: ADEME
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_19008:
                  value:
                    errors:
                    - code: '19008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: ADEME
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_19011:
                  value:
                    errors:
                    - code: '19011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: ADEME
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_19009:
                  value:
                    errors:
                    - code: '19009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: ADEME
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '19001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: ADEME
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '19004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: ADEME
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_17000:
                  value:
                    errors:
                    - code: '17000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: Banque de France
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_17008:
                  value:
                    errors:
                    - code: '17008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: Banque de France
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_17011:
                  value:
                    errors:
                    - code: '17011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: Banque de France
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_17009:
                  value:
                    errors:
                    - code: '17009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: Banque de France
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '17001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: Banque de France
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '17004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: Banque de France
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_33000:
                  value:
                    errors:
                    - code: '33000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: CARIF-OREF
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_33008:
                  value:
                    errors:
                    - code: '33008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: CARIF-OREF
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_33011:
                  value:
                    errors:
                    - code: '33011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: CARIF-OREF
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_33009:
                  value:
                    errors:
                    - code: '33009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: CARIF-OREF
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '33001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: CARIF-OREF
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '33004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: CARIF-OREF
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_38000:
                  value:
                    errors:
                    - code: '38000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: CIBTP
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_38008:
                  value:
                    errors:
                    - code: '38008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: CIBTP
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_38011:
                  value:
                    errors:
                    - code: '38011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: CIBTP
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_38009:
                  value:
                    errors:
                    - code: '38009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: CIBTP
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_38055:
                  value:
                    errors:
                    - code: '38055'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier n'est pas au format attendu
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier n'est pas au format attendu
                erreur_reseau_du_service_d_hebergement_de_donnees_00502:
                  value:
                    errors:
                    - code: '00502'
                      title: Erreur réseau du service d'hébergement de données
                      detail: Problème de connexion au serveur d'hébergement de données.
                        L'erreur peut venir soit du fournisseur, soit de API Entreprise
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau du service d'hébergement de données
                  description: Problème de connexion au serveur d'hébergement de données.
                    L'erreur peut venir soit du fournisseur, soit de API Entreprise
        '404':
          description: Non trouvée
          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
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '38001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: CIBTP
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '38004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: CIBTP
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_08000:
                  value:
                    errors:
                    - code: '08000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: CNETP
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_08008:
                  value:
                    errors:
                    - code: '08008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: CNETP
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_08011:
                  value:
                    errors:
                    - code: '08011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: CNETP
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_08009:
                  value:
                    errors:
                    - code: '08009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: CNETP
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_08051:
                  value:
                    errors:
                    - code: '08051'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: 'Erreur lors du décodage : la chaîne de caractères en
                        base64 est invalide'
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: 'Erreur lors du décodage : la chaîne de caractères
                    en base64 est invalide'
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_08052:
                  value:
                    errors:
                    - code: '08052'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Temps d'attente de téléchargement du document écoulé
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Temps d'attente de téléchargement du document écoulé
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_08053:
                  value:
                    errors:
                    - code: '08053'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Erreur de connexion sur le server distant
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Erreur de connexion sur le server distant
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_08054:
                  value:
                    errors:
                    - code: '08054'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: L'URL vers le document renvoyée par le fournisseur de
                        données est invalide
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: L'URL vers le document renvoyée par le fournisseur
                    de données est invalide
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_08055:
                  value:
                    errors:
                    - code: '08055'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier n'est pas au format attendu
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier n'est pas au format attendu
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_08056:
                  value:
                    errors:
                    - code: '08056'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier renvoyé par le fournisseur de données est
                        vide
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier renvoyé par le fournisseur de données est
                    vide
                erreur_reseau_du_service_d_hebergement_de_donnees_00502:
                  value:
                    errors:
                    - code: '00502'
                      title: Erreur réseau du service d'hébergement de données
                      detail: Problème de connexion au serveur d'hébergement de données.
                        L'erreur peut venir soit du fournisseur, soit de API Entreprise
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau du service d'hébergement de données
                  description: Problème de connexion au serveur d'hébergement de données.
                    L'erreur peut venir soit du fournisseur, soit de API Entreprise
              schema:
                "$ref": "#/components/schemas/Error"
        '404':
          description: Non trouvé
          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
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '08001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: CNETP
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '08004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: CNETP
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_or_siret_or_rna_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_52000:
                  value:
                    errors:
                    - code: '52000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: DataSubvention
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_52008:
                  value:
                    errors:
                    - code: '52008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: DataSubvention
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_52011:
                  value:
                    errors:
                    - code: '52011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: DataSubvention
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_52009:
                  value:
                    errors:
                    - code: '52009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: DataSubvention
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '52001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: DataSubvention
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '52004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: DataSubvention
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_or_eori_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_16000:
                  value:
                    errors:
                    - code: '16000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: DGDDI
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_16008:
                  value:
                    errors:
                    - code: '16008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: DGDDI
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_16011:
                  value:
                    errors:
                    - code: '16011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: DGDDI
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_16009:
                  value:
                    errors:
                    - code: '16009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: DGDDI
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '16001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: DGDDI
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '16004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: DGDDI
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
        '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/douanes/etablissements/13002526500013/immatriculations_eori?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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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
          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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_03000:
                  value:
                    errors:
                    - code: '03000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_03008:
                  value:
                    errors:
                    - code: '03008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_03011:
                  value:
                    errors:
                    - code: '03011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_03009:
                  value:
                    errors:
                    - code: '03009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_03051:
                  value:
                    errors:
                    - code: '03051'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: 'Erreur lors du décodage : la chaîne de caractères en
                        base64 est invalide'
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: 'Erreur lors du décodage : la chaîne de caractères
                    en base64 est invalide'
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_03052:
                  value:
                    errors:
                    - code: '03052'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Temps d'attente de téléchargement du document écoulé
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Temps d'attente de téléchargement du document écoulé
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_03053:
                  value:
                    errors:
                    - code: '03053'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Erreur de connexion sur le server distant
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Erreur de connexion sur le server distant
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_03054:
                  value:
                    errors:
                    - code: '03054'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: L'URL vers le document renvoyée par le fournisseur de
                        données est invalide
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: L'URL vers le document renvoyée par le fournisseur
                    de données est invalide
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_03055:
                  value:
                    errors:
                    - code: '03055'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier n'est pas au format attendu
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier n'est pas au format attendu
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_03056:
                  value:
                    errors:
                    - code: '03056'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier renvoyé par le fournisseur de données est
                        vide
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier renvoyé par le fournisseur de données est
                    vide
                erreur_reseau_du_service_d_hebergement_de_donnees_00502:
                  value:
                    errors:
                    - code: '00502'
                      title: Erreur réseau du service d'hébergement de données
                      detail: Problème de connexion au serveur d'hébergement de données.
                        L'erreur peut venir soit du fournisseur, soit de API Entreprise
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau du service d'hébergement de données
                  description: Problème de connexion au serveur d'hébergement de données.
                    L'erreur peut venir soit du fournisseur, soit de API Entreprise
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '03001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '03004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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
          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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_03000:
                  value:
                    errors:
                    - code: '03000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_03008:
                  value:
                    errors:
                    - code: '03008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_03011:
                  value:
                    errors:
                    - code: '03011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_03009:
                  value:
                    errors:
                    - code: '03009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '03001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '03004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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"
  "/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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
          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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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
                unprocessable_content_error_year_error:
                  value:
                    errors:
                    - code: '00307'
                      title: Entité non traitable
                      detail: L'année n'est pas correctement formatée
                      source:
                      meta: {}
                  summary: Entité non traitable
                  description: L'année n'est pas correctement formatée
              schema:
                "$ref": "#/components/schemas/Error"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_03000:
                  value:
                    errors:
                    - code: '03000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_03008:
                  value:
                    errors:
                    - code: '03008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_03011:
                  value:
                    errors:
                    - code: '03011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_03009:
                  value:
                    errors:
                    - code: '03009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
                potentielle_ressource_non_trouvee_03501:
                  value:
                    errors:
                    - code: '03501'
                      title: Potentielle ressource non trouvée
                      detail: Le serveur a renvoyé une erreur interne, mais cela peut
                        aussi indiquer que le siret ou siren renseigné n'existe pas,
                        n'est pas connu, n'est pas en règle de ses obligations fiscales
                        ou ne comporte aucune information pour cet appel.
                      source:
                      meta:
                        provider: DGFIP
                  summary: Potentielle ressource non trouvée
                  description: Le serveur a renvoyé une erreur interne, mais cela
                    peut aussi indiquer que le siret ou siren renseigné n'existe pas,
                    n'est pas connu, n'est pas en règle de ses obligations fiscales
                    ou ne comporte aucune information pour cet appel.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '03001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '03004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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é
          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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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
                unprocessable_content_error_year_error:
                  value:
                    errors:
                    - code: '00307'
                      title: Entité non traitable
                      detail: L'année n'est pas correctement formatée
                      source:
                      meta: {}
                  summary: Entité non traitable
                  description: L'année n'est pas correctement formatée
              schema:
                "$ref": "#/components/schemas/Error"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_03000:
                  value:
                    errors:
                    - code: '03000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_03008:
                  value:
                    errors:
                    - code: '03008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_03011:
                  value:
                    errors:
                    - code: '03011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_03009:
                  value:
                    errors:
                    - code: '03009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '03001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '03004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: DGFIP - Adélie
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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éro de TVA
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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 puis du SIREN sur
                          9 chiffres.
                        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
        '422':
          description: Paramètre(s) invalide(s)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_43000:
                  value:
                    errors:
                    - code: '43000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: DGFIP - TVA
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_43008:
                  value:
                    errors:
                    - code: '43008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: DGFIP - TVA
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_43011:
                  value:
                    errors:
                    - code: '43011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: DGFIP - TVA
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_43009:
                  value:
                    errors:
                    - code: '43009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: DGFIP - TVA
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '43001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: DGFIP - TVA
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '43004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: DGFIP - TVA
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_or_rna_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Association non trouvée
          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
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '29001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: DJEPVA
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '29004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: DJEPVA
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              schema:
                "$ref": "#/components/schemas/Error"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_29000:
                  value:
                    errors:
                    - code: '29000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: DJEPVA
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_29008:
                  value:
                    errors:
                    - code: '29008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: DJEPVA
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_29011:
                  value:
                    errors:
                    - code: '29011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: DJEPVA
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_29009:
                  value:
                    errors:
                    - code: '29009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: DJEPVA
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_or_rna_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Association non trouvée
          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
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '29001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: DJEPVA
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '29004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: DJEPVA
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              schema:
                "$ref": "#/components/schemas/Error"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_29000:
                  value:
                    errors:
                    - code: '29000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: DJEPVA
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_29008:
                  value:
                    errors:
                    - code: '29008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: DJEPVA
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_29011:
                  value:
                    errors:
                    - code: '29011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: DJEPVA
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_29009:
                  value:
                    errors:
                    - code: '29009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: DJEPVA
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              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"
      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/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_12000:
                  value:
                    errors:
                    - code: '12000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: FNTP
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_12008:
                  value:
                    errors:
                    - code: '12008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: FNTP
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_12011:
                  value:
                    errors:
                    - code: '12011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: FNTP
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_12009:
                  value:
                    errors:
                    - code: '12009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: FNTP
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_12051:
                  value:
                    errors:
                    - code: '12051'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: 'Erreur lors du décodage : la chaîne de caractères en
                        base64 est invalide'
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: 'Erreur lors du décodage : la chaîne de caractères
                    en base64 est invalide'
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_12052:
                  value:
                    errors:
                    - code: '12052'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Temps d'attente de téléchargement du document écoulé
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Temps d'attente de téléchargement du document écoulé
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_12053:
                  value:
                    errors:
                    - code: '12053'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Erreur de connexion sur le server distant
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Erreur de connexion sur le server distant
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_12054:
                  value:
                    errors:
                    - code: '12054'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: L'URL vers le document renvoyée par le fournisseur de
                        données est invalide
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: L'URL vers le document renvoyée par le fournisseur
                    de données est invalide
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_12055:
                  value:
                    errors:
                    - code: '12055'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier n'est pas au format attendu
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier n'est pas au format attendu
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_12056:
                  value:
                    errors:
                    - code: '12056'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier renvoyé par le fournisseur de données est
                        vide
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier renvoyé par le fournisseur de données est
                    vide
                erreur_reseau_du_service_d_hebergement_de_donnees_00502:
                  value:
                    errors:
                    - code: '00502'
                      title: Erreur réseau du service d'hébergement de données
                      detail: Problème de connexion au serveur d'hébergement de données.
                        L'erreur peut venir soit du fournisseur, soit de API Entreprise
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau du service d'hébergement de données
                  description: Problème de connexion au serveur d'hébergement de données.
                    L'erreur peut venir soit du fournisseur, soit de API Entreprise
              schema:
                "$ref": "#/components/schemas/Error"
        '404':
          description: Non trouvée
          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
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '12001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: FNTP
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '12004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: FNTP
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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
                unprocessable_content_error_year_error:
                  value:
                    errors:
                    - code: '00307'
                      title: Entité non traitable
                      detail: L'année n'est pas correctement formatée
                      source:
                      meta: {}
                  summary: Entité non traitable
                  description: L'année n'est pas correctement formatée
              schema:
                "$ref": "#/components/schemas/Error"
        '404':
          description: Effectifs non trouvés
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_31000:
                  value:
                    errors:
                    - code: '31000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_31008:
                  value:
                    errors:
                    - code: '31008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_31011:
                  value:
                    errors:
                    - code: '31011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_31009:
                  value:
                    errors:
                    - code: '31009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '31001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '31004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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
                unprocessable_content_error_month_error:
                  value:
                    errors:
                    - code: '00305'
                      title: Entité non traitable
                      detail: Le format du mois n'est pas valide
                      source:
                        parameter: month
                      meta: {}
                  summary: Entité non traitable
                  description: Le format du mois n'est pas valide
                unprocessable_content_error_year_error:
                  value:
                    errors:
                    - code: '00307'
                      title: Entité non traitable
                      detail: L'année n'est pas correctement formatée
                      source:
                      meta: {}
                  summary: Entité non traitable
                  description: L'année n'est pas correctement formatée
              schema:
                "$ref": "#/components/schemas/Error"
        '404':
          description: Effectifs non trouvés
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_31000:
                  value:
                    errors:
                    - code: '31000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_31008:
                  value:
                    errors:
                    - code: '31008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_31011:
                  value:
                    errors:
                    - code: '31011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_31009:
                  value:
                    errors:
                    - code: '31009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '31001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '31004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: GIP-MDS
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_02000:
                  value:
                    errors:
                    - code: '02000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: Infogreffe
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_02008:
                  value:
                    errors:
                    - code: '02008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: Infogreffe
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_02011:
                  value:
                    errors:
                    - code: '02011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: Infogreffe
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_02009:
                  value:
                    errors:
                    - code: '02009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: Infogreffe
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '02001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: Infogreffe
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '02004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: Infogreffe
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Entreprise non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_02000:
                  value:
                    errors:
                    - code: '02000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: Infogreffe
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_02008:
                  value:
                    errors:
                    - code: '02008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: Infogreffe
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_02011:
                  value:
                    errors:
                    - code: '02011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: Infogreffe
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_02009:
                  value:
                    errors:
                    - code: '02009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: Infogreffe
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '02001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: Infogreffe
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '02004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: Infogreffe
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_34000:
                  value:
                    errors:
                    - code: '34000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_34008:
                  value:
                    errors:
                    - code: '34008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_34011:
                  value:
                    errors:
                    - code: '34011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_34009:
                  value:
                    errors:
                    - code: '34009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '34001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '34004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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é.<br/>Plus
                                            d''infos sur les différents des droits
                                            sur un bien sur le lien suivant: <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                            nue-propriété, pleine propriété : quelles
                                            différences ?</a>'
                                          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é.<br/>Plus d''infos
                                            sur les différents des droits sur un bien
                                            sur le lien suivant: <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                            nue-propriété, pleine propriété : quelles
                                            différences ?</a>'
                                          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: <a
                                            href="https://www.economie.gouv.fr/particuliers/heritage-succession-indivision">Succession
                                            : qu''est-ce que l''indivision ?</a>'
                                          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é.<br/>Plus
                                                d''infos sur les différents des droits
                                                sur un bien sur le lien suivant: <a
                                                href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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é.<br/>Plus
                                                d''infos sur les différents des droits
                                                sur un bien sur le lien suivant: <a
                                                href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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 <a href="https://entreprise.api.gouv.fr//catalogue/inpi/rne/beneficiaires_effectifs#faq_entry_answer_0_api_entreprise_endpoint_inpi_rne_beneficiaires_effectifs">cette
                                            FAQ</a>.
                                          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é.<br/>Plus d''infos
                                                sur les différents des droits sur
                                                un bien sur le lien suivant: <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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é.<br/>Plus d''infos sur
                                                les différents des droits sur un bien
                                                sur le lien suivant: <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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é.<br/>Plus d''infos sur les différents
                                            des droits sur un bien sur le lien suivant:
                                            <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                            nue-propriété, pleine propriété : quelles
                                            différences ?</a>'
                                          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é.<br/>Plus
                                            d''infos sur les différents des droits
                                            sur un bien sur le lien suivant: <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                            nue-propriété, pleine propriété : quelles
                                            différences ?</a>'
                                          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: <a
                                            href="https://www.economie.gouv.fr/particuliers/heritage-succession-indivision">Succession
                                            : qu''est-ce que l''indivision ?</a>'
                                          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é.<br/>Plus
                                                d''infos sur les différents des droits
                                                sur un bien sur le lien suivant: <a
                                                href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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é.<br/>Plus
                                                d''infos sur les différents des droits
                                                sur un bien sur le lien suivant: <a
                                                href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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 <a href="https://entreprise.api.gouv.fr//catalogue/inpi/rne/beneficiaires_effectifs#faq_entry_answer_0_api_entreprise_endpoint_inpi_rne_beneficiaires_effectifs">cette
                                            FAQ</a>.
                                          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é.<br/>Plus
                                                d''infos sur les différents des droits
                                                sur un bien sur le lien suivant: <a
                                                href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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é.<br/>Plus
                                                d''infos sur les différents des droits
                                                sur un bien sur le lien suivant: <a
                                                href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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é.<br/>Plus
                                            d''infos sur les différents des droits
                                            sur un bien sur le lien suivant: <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                            nue-propriété, pleine propriété : quelles
                                            différences ?</a>'
                                          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é.<br/>Plus
                                            d''infos sur les différents des droits
                                            sur un bien sur le lien suivant: <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                            nue-propriété, pleine propriété : quelles
                                            différences ?</a>'
                                          type: number
                                          example: 0.0
                                        usufruit:
                                          title: Proportion détenue en usufruit
                                          description: 'Pourcentage de droits de vote
                                            directs détenus en usufruit.<br/>Plus
                                            d''infos sur les différents des droits
                                            sur un bien sur le lien suivant: <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                            nue-propriété, pleine propriété : quelles
                                            différences ?</a>'
                                          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: <a href="https://www.economie.gouv.fr/particuliers/heritage-succession-indivision">Succession
                                            : qu''est-ce que l''indivision ?</a>'
                                          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é.<br/>Plus d''infos
                                                sur les différents des droits sur
                                                un bien sur le lien suivant: <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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é.<br/>Plus d''infos
                                                sur les différents des droits sur
                                                un bien sur le lien suivant: <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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.<br/>Plus d''infos sur
                                                les différents des droits sur un bien
                                                sur le lien suivant: <a href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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 <a
                                            href="https://entreprise.api.gouv.fr//catalogue/inpi/rne/beneficiaires_effectifs#faq_entry_answer_0_api_entreprise_endpoint_inpi_rne_beneficiaires_effectifs">cette
                                            FAQ</a>.
                                          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é.<br/>Plus
                                                d''infos sur les différents des droits
                                                sur un bien sur le lien suivant: <a
                                                href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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é.<br/>Plus
                                                d''infos sur les différents des droits
                                                sur un bien sur le lien suivant: <a
                                                href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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.<br/>Plus
                                                d''infos sur les différents des droits
                                                sur un bien sur le lien suivant: <a
                                                href="https://www.service-public.fr/particuliers/vosdroits/F33076">Usufruit,
                                                nue-propriété, pleine propriété :
                                                quelles différences ?</a>'
                                              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
          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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_34000:
                  value:
                    errors:
                    - code: '34000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_34008:
                  value:
                    errors:
                    - code: '34008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_34011:
                  value:
                    errors:
                    - code: '34011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_34009:
                  value:
                    errors:
                    - code: '34009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '34001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '34004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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
          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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_34000:
                  value:
                    errors:
                    - code: '34000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_34008:
                  value:
                    errors:
                    - code: '34008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_34011:
                  value:
                    errors:
                    - code: '34011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_34009:
                  value:
                    errors:
                    - code: '34009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '34001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '34004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INPI - RNE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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=10aae456-565f-4961-aae4-56565fa9617a#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=10aae456-565f-4961-aae4-56565fa9617a#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 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=10aae456-565f-4961-aae4-56565fa9617a#distributionspecialeetablissement"
                      code_cedex:
                        title: Code cedex
                        type: string
                        nullable: true
                        description: 'Plus d''informations : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle'
                        example: '75590'
                      libelle_cedex:
                        title: Libellé du code cedex
                        type: string
                        nullable: true
                        example: PARIS CEDEX 12
                        description: Ce champ indique le libellé correspondant au
                          code cedex de l'établissement. Si le code cedex est à 'null',
                          ce champ est également à 'null'.
                      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`
                            nullable: true
                            example: CS 72809
                          l6:
                            title: Ligne 6
                            type: string
                            description: 'Si le code cedex est existant : code cedex
                              accompagné de son libellé ; sinon, si le pays est en
                              France : code postal accompagné de son libellé, sinon
                              : libellé de la commune de l''établissement situé à
                              l''étranger'
                            nullable: true
                            example: 75256 PARIX CEDEX 12
                          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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvé
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_01000:
                  value:
                    errors:
                    - code: '01000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_01008:
                  value:
                    errors:
                    - code: '01008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INSEE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_01011:
                  value:
                    errors:
                    - code: '01011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_01009:
                  value:
                    errors:
                    - code: '01009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '01001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INSEE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '01004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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=10aae456-565f-4961-aae4-56565fa9617a#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=10aae456-565f-4961-aae4-56565fa9617a#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 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=10aae456-565f-4961-aae4-56565fa9617a#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: "Plus d'informations : 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]\"."
                        example: '75590'
                      libelle_cedex:
                        title: Libellé du code cedex
                        type: string
                        nullable: true
                        example: PARIS CEDEX 12
                        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 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` \n Si la personne morale
                              est en diffusion partielle, la valeur est remplacée
                              par \"[ND]\"."
                            nullable: true
                            example: CS 72809
                          l6:
                            title: Ligne 6
                            type: string
                            description: "Si le code cedex est existant : code cedex
                              accompagné de son libellé ; sinon, si le pays est en
                              France : code postal accompagné de son libellé, sinon
                              : libellé de la commune de l'établissement situé à l'étranger
                              \n Si la personne morale est en diffusion partielle,
                              la valeur est remplacée par \"[ND]\"."
                            nullable: true
                            example: 75256 PARIX CEDEX 12
                          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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvé
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_01000:
                  value:
                    errors:
                    - code: '01000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_01008:
                  value:
                    errors:
                    - code: '01008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INSEE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_01011:
                  value:
                    errors:
                    - code: '01011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_01009:
                  value:
                    errors:
                    - code: '01009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '01001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INSEE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '01004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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"
  "/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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=10aae456-565f-4961-aae4-56565fa9617a#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=10aae456-565f-4961-aae4-56565fa9617a#trancheeffectifsetablissement.
                              \n \n L'effectif mensuel exact de l'établissement est
                              disponible au travers de l'[API Effectifs - URSSAF Caisse
                              nationale](TODO). 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://sirene.fr/static-resources/htm/v_sommaire.htm#26"
                      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=10aae456-565f-4961-aae4-56565fa9617a#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://sirene.fr/static-resources/htm/v_sommaire.htm#26"
                          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=e5ad6542-3cac-4840-ad65-423cacf8408d#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 dépôt de la dé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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=10aae456-565f-4961-aae4-56565fa9617a#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=10aae456-565f-4961-aae4-56565fa9617a#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 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=10aae456-565f-4961-aae4-56565fa9617a#distributionspecialeetablissement"
                          code_cedex:
                            title: Code cedex
                            type: string
                            nullable: true
                            description: 'Plus d''informations : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle'
                            example: '75590'
                          libelle_cedex:
                            title: Libellé du code cedex
                            type: string
                            nullable: true
                            example: PARIS CEDEX 12
                            description: Ce champ indique le libellé correspondant
                              au code cedex de l'établissement. Si le code cedex est
                              à 'null', ce champ est également à 'null'.
                          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`
                                nullable: true
                                example: CS 72809
                              l6:
                                title: Ligne 6
                                type: string
                                description: 'Si le code cedex est existant : code
                                  cedex accompagné de son libellé ; sinon, si le pays
                                  est en France : code postal accompagné de son libellé,
                                  sinon : libellé de la commune de l''établissement
                                  situé à l''étranger'
                                nullable: true
                                example: 75256 PARIX CEDEX 12
                              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=e5ad6542-3cac-4840-ad65-423cacf8408d#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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvé
          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
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/Error"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_01000:
                  value:
                    errors:
                    - code: '01000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_01008:
                  value:
                    errors:
                    - code: '01008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INSEE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_01011:
                  value:
                    errors:
                    - code: '01011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_01009:
                  value:
                    errors:
                    - code: '01009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '01001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INSEE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '01004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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"
  "/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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=10aae456-565f-4961-aae4-56565fa9617a#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=10aae456-565f-4961-aae4-56565fa9617a#trancheeffectifsetablissement.
                              \n \n L'effectif mensuel exact de l'établissement est
                              disponible au travers de l'[API Effectifs - URSSAF Caisse
                              nationale](TODO). 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://sirene.fr/static-resources/htm/v_sommaire.htm#26"
                      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=10aae456-565f-4961-aae4-56565fa9617a#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://sirene.fr/static-resources/htm/v_sommaire.htm#26"
                          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=e5ad6542-3cac-4840-ad65-423cacf8408d#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 dépôt de la dé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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=10aae456-565f-4961-aae4-56565fa9617a#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=10aae456-565f-4961-aae4-56565fa9617a#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 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=10aae456-565f-4961-aae4-56565fa9617a#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: "Plus d'informations : 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]\"."
                            example: '75590'
                          libelle_cedex:
                            title: Libellé du code cedex
                            type: string
                            nullable: true
                            example: PARIS CEDEX 12
                            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 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` \n Si la personne
                                  morale est en diffusion partielle, la valeur est
                                  remplacée par \"[ND]\"."
                                nullable: true
                                example: CS 72809
                              l6:
                                title: Ligne 6
                                type: string
                                description: "Si le code cedex est existant : code
                                  cedex accompagné de son libellé ; sinon, si le pays
                                  est en France : code postal accompagné de son libellé,
                                  sinon : libellé de la commune de l'établissement
                                  situé à l'étranger \n Si la personne morale est
                                  en diffusion partielle, la valeur est remplacée
                                  par \"[ND]\"."
                                nullable: true
                                example: 75256 PARIX CEDEX 12
                              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=e5ad6542-3cac-4840-ad65-423cacf8408d#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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouve
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_01000:
                  value:
                    errors:
                    - code: '01000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_01008:
                  value:
                    errors:
                    - code: '01008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INSEE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_01011:
                  value:
                    errors:
                    - code: '01011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_01009:
                  value:
                    errors:
                    - code: '01009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '01001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INSEE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '01004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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"
  "/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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=10aae456-565f-4961-aae4-56565fa9617a#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=10aae456-565f-4961-aae4-56565fa9617a#trancheeffectifsetablissement.
                              \n \n L'effectif mensuel exact de l'établissement est
                              disponible au travers de l'[API Effectifs - URSSAF Caisse
                              nationale](TODO). 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://sirene.fr/static-resources/htm/v_sommaire.htm#26"
                      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=10aae456-565f-4961-aae4-56565fa9617a#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://sirene.fr/static-resources/htm/v_sommaire.htm#26"
                          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=e5ad6542-3cac-4840-ad65-423cacf8408d#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 dépôt de la dé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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=10aae456-565f-4961-aae4-56565fa9617a#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=10aae456-565f-4961-aae4-56565fa9617a#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 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=10aae456-565f-4961-aae4-56565fa9617a#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: "Plus d'informations : 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]\"."
                            example: '75590'
                          libelle_cedex:
                            title: Libellé du code cedex
                            type: string
                            nullable: true
                            example: PARIS CEDEX 12
                            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 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` \n Si la personne
                                  morale est en diffusion partielle, la valeur est
                                  remplacée par \"[ND]\"."
                                nullable: true
                                example: CS 72809
                              l6:
                                title: Ligne 6
                                type: string
                                description: "Si le code cedex est existant : code
                                  cedex accompagné de son libellé ; sinon, si le pays
                                  est en France : code postal accompagné de son libellé,
                                  sinon : libellé de la commune de l'établissement
                                  situé à l'étranger \n Si la personne morale est
                                  en diffusion partielle, la valeur est remplacée
                                  par \"[ND]\"."
                                nullable: true
                                example: 75256 PARIX CEDEX 12
                              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=e5ad6542-3cac-4840-ad65-423cacf8408d#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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouve
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_01000:
                  value:
                    errors:
                    - code: '01000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_01008:
                  value:
                    errors:
                    - code: '01008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INSEE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_01011:
                  value:
                    errors:
                    - code: '01011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_01009:
                  value:
                    errors:
                    - code: '01009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '01001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INSEE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '01004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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"
  "/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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=10aae456-565f-4961-aae4-56565fa9617a#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=10aae456-565f-4961-aae4-56565fa9617a#trancheeffectifsetablissement.
                              \n \n L'effectif mensuel exact de l'établissement est
                              disponible au travers de l'[API Effectifs - URSSAF Caisse
                              nationale](TODO). 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://sirene.fr/static-resources/htm/v_sommaire.htm#26"
                      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=10aae456-565f-4961-aae4-56565fa9617a#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://sirene.fr/static-resources/htm/v_sommaire.htm#26"
                          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=e5ad6542-3cac-4840-ad65-423cacf8408d#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 dépôt de la dé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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=10aae456-565f-4961-aae4-56565fa9617a#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=10aae456-565f-4961-aae4-56565fa9617a#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 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=10aae456-565f-4961-aae4-56565fa9617a#distributionspecialeetablissement"
                          code_cedex:
                            title: Code cedex
                            type: string
                            nullable: true
                            description: 'Plus d''informations : https://fr.wikipedia.org/wiki/Courrier_d%27entreprise_%C3%A0_distribution_exceptionnelle'
                            example: '75590'
                          libelle_cedex:
                            title: Libellé du code cedex
                            type: string
                            nullable: true
                            example: PARIS CEDEX 12
                            description: Ce champ indique le libellé correspondant
                              au code cedex de l'établissement. Si le code cedex est
                              à 'null', ce champ est également à 'null'.
                          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`
                                nullable: true
                                example: CS 72809
                              l6:
                                title: Ligne 6
                                type: string
                                description: 'Si le code cedex est existant : code
                                  cedex accompagné de son libellé ; sinon, si le pays
                                  est en France : code postal accompagné de son libellé,
                                  sinon : libellé de la commune de l''établissement
                                  situé à l''étranger'
                                nullable: true
                                example: 75256 PARIX CEDEX 12
                              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=e5ad6542-3cac-4840-ad65-423cacf8408d#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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouve
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_01000:
                  value:
                    errors:
                    - code: '01000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_01008:
                  value:
                    errors:
                    - code: '01008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INSEE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_01011:
                  value:
                    errors:
                    - code: '01011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_01009:
                  value:
                    errors:
                    - code: '01009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '01001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INSEE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '01004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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
          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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_01000:
                  value:
                    errors:
                    - code: '01000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_01008:
                  value:
                    errors:
                    - code: '01008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INSEE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_01011:
                  value:
                    errors:
                    - code: '01011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_01009:
                  value:
                    errors:
                    - code: '01009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '01001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INSEE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '01004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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"
  "/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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://sirene.fr/static-resources/htm/v_sommaire.htm#26"
                      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=e5ad6542-3cac-4840-ad65-423cacf8408d#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 dépôt
                          de la dé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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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://entreprises.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://entreprises.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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_01000:
                  value:
                    errors:
                    - code: '01000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_01008:
                  value:
                    errors:
                    - code: '01008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INSEE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_01011:
                  value:
                    errors:
                    - code: '01011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_01009:
                  value:
                    errors:
                    - code: '01009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '01001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INSEE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '01004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              schema:
                "$ref": "#/components/schemas/Error"
        '451':
          description: Indisponible pour des raisons légales
          content:
            application/json:
              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"
      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"
  "/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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://sirene.fr/static-resources/htm/v_sommaire.htm#26"
                      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=e5ad6542-3cac-4840-ad65-423cacf8408d#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 dépôt
                          de la dé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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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=e5ad6542-3cac-4840-ad65-423cacf8408d#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://entreprises.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://entreprises.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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvee
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_01000:
                  value:
                    errors:
                    - code: '01000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_01008:
                  value:
                    errors:
                    - code: '01008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: INSEE
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_01011:
                  value:
                    errors:
                    - code: '01011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_01009:
                  value:
                    errors:
                    - code: '01009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '01001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: INSEE
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '01004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: INSEE
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              schema:
                "$ref": "#/components/schemas/Error"
        '451':
          description: Indisponible pour des raisons legales
          content:
            application/json:
              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"
      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/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_10000:
                  value:
                    errors:
                    - code: '10000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: MSA
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_10008:
                  value:
                    errors:
                    - code: '10008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: MSA
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_10011:
                  value:
                    errors:
                    - code: '10011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: MSA
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_10009:
                  value:
                    errors:
                    - code: '10009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: MSA
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '10001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: MSA
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '10004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: MSA
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_11000:
                  value:
                    errors:
                    - code: '11000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: OPQIBI
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_11008:
                  value:
                    errors:
                    - code: '11008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: OPQIBI
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_11011:
                  value:
                    errors:
                    - code: '11011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: OPQIBI
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_11009:
                  value:
                    errors:
                    - code: '11009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: OPQIBI
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '11001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: OPQIBI
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '11004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: OPQIBI
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_09000:
                  value:
                    errors:
                    - code: '09000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: ProBTP
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_09008:
                  value:
                    errors:
                    - code: '09008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: ProBTP
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_09011:
                  value:
                    errors:
                    - code: '09011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: ProBTP
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_09009:
                  value:
                    errors:
                    - code: '09009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: ProBTP
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_09051:
                  value:
                    errors:
                    - code: '09051'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: 'Erreur lors du décodage : la chaîne de caractères en
                        base64 est invalide'
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: 'Erreur lors du décodage : la chaîne de caractères
                    en base64 est invalide'
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_09052:
                  value:
                    errors:
                    - code: '09052'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Temps d'attente de téléchargement du document écoulé
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Temps d'attente de téléchargement du document écoulé
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_09053:
                  value:
                    errors:
                    - code: '09053'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Erreur de connexion sur le server distant
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Erreur de connexion sur le server distant
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_09054:
                  value:
                    errors:
                    - code: '09054'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: L'URL vers le document renvoyée par le fournisseur de
                        données est invalide
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: L'URL vers le document renvoyée par le fournisseur
                    de données est invalide
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_09055:
                  value:
                    errors:
                    - code: '09055'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier n'est pas au format attendu
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier n'est pas au format attendu
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_09056:
                  value:
                    errors:
                    - code: '09056'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier renvoyé par le fournisseur de données est
                        vide
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier renvoyé par le fournisseur de données est
                    vide
                erreur_reseau_du_service_d_hebergement_de_donnees_00502:
                  value:
                    errors:
                    - code: '00502'
                      title: Erreur réseau du service d'hébergement de données
                      detail: Problème de connexion au serveur d'hébergement de données.
                        L'erreur peut venir soit du fournisseur, soit de API Entreprise
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau du service d'hébergement de données
                  description: Problème de connexion au serveur d'hébergement de données.
                    L'erreur peut venir soit du fournisseur, soit de API Entreprise
              schema:
                "$ref": "#/components/schemas/Error"
        '404':
          description: Attestation non trouvée
          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
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '09001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: ProBTP
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '09004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: ProBTP
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_09000:
                  value:
                    errors:
                    - code: '09000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: ProBTP
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_09008:
                  value:
                    errors:
                    - code: '09008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: ProBTP
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_09011:
                  value:
                    errors:
                    - code: '09011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: ProBTP
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_09009:
                  value:
                    errors:
                    - code: '09009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: ProBTP
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '09001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: ProBTP
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '09004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: ProBTP
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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"
  "/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_06000:
                  value:
                    errors:
                    - code: '06000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: Qualibat
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_06008:
                  value:
                    errors:
                    - code: '06008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: Qualibat
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_06011:
                  value:
                    errors:
                    - code: '06011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: Qualibat
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_06009:
                  value:
                    errors:
                    - code: '06009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: Qualibat
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_06051:
                  value:
                    errors:
                    - code: '06051'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: 'Erreur lors du décodage : la chaîne de caractères en
                        base64 est invalide'
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: 'Erreur lors du décodage : la chaîne de caractères
                    en base64 est invalide'
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_06052:
                  value:
                    errors:
                    - code: '06052'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Temps d'attente de téléchargement du document écoulé
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Temps d'attente de téléchargement du document écoulé
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_06053:
                  value:
                    errors:
                    - code: '06053'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Erreur de connexion sur le server distant
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Erreur de connexion sur le server distant
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_06054:
                  value:
                    errors:
                    - code: '06054'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: L'URL vers le document renvoyée par le fournisseur de
                        données est invalide
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: L'URL vers le document renvoyée par le fournisseur
                    de données est invalide
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_06055:
                  value:
                    errors:
                    - code: '06055'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier n'est pas au format attendu
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier n'est pas au format attendu
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_06056:
                  value:
                    errors:
                    - code: '06056'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier renvoyé par le fournisseur de données est
                        vide
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier renvoyé par le fournisseur de données est
                    vide
                erreur_reseau_du_service_d_hebergement_de_donnees_00502:
                  value:
                    errors:
                    - code: '00502'
                      title: Erreur réseau du service d'hébergement de données
                      detail: Problème de connexion au serveur d'hébergement de données.
                        L'erreur peut venir soit du fournisseur, soit de API Entreprise
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau du service d'hébergement de données
                  description: Problème de connexion au serveur d'hébergement de données.
                    L'erreur peut venir soit du fournisseur, soit de API Entreprise
              schema:
                "$ref": "#/components/schemas/Error"
        '404':
          description: Certification non trouvée
          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
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '06001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: Qualibat
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '06004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: Qualibat
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siret_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '404':
          description: Non trouvée
          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
          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.
                erreur_interne_du_fournisseur_de_donnees_32000:
                  value:
                    errors:
                    - code: '32000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: Qualifelec
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_32008:
                  value:
                    errors:
                    - code: '32008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: Qualifelec
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_32011:
                  value:
                    errors:
                    - code: '32011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: Qualifelec
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_32009:
                  value:
                    errors:
                    - code: '32009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: Qualifelec
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
              schema:
                "$ref": "#/components/schemas/Error"
        '504':
          description: Erreur d'intermédiaire
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '32001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: Qualifelec
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '32004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: Qualifelec
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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"
  "/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: 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é
          content:
            application/json:
              examples:
                invalid_token_error:
                  value:
                    errors:
                    - code: '00101'
                      title: Interdit
                      detail: Votre token n'est pas valide ou n'est pas renseigné
                      source:
                        parameter: token
                      meta: {}
                  summary: Interdit
                  description: Votre token n'est pas valide ou n'est pas renseigné
                expired_token_error:
                  value:
                    errors:
                    - code: '00103'
                      title: Jeton expiré
                      detail: Votre token est expiré. Vous devez refaire une demande
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton expiré
                  description: Votre token est expiré. Vous devez refaire une demande
                blacklisted_token_error:
                  value:
                    errors:
                    - code: '00105'
                      title: Jeton sur liste noire
                      detail: 'Votre jeton est sur liste noire, celui-ci a certainement
                        été divulgué sur un canal non-sécurisé. Vous pouvez trouver
                        un jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
                      source:
                        parameter: token
                      meta: {}
                  summary: Jeton sur liste noire
                  description: 'Votre jeton est sur liste noire, celui-ci a certainement
                    été divulgué sur un canal non-sécurisé. Vous pouvez trouver un
                    jeton valide sur votre espace personnel: https://entreprise.api.gouv.fr/compte'
              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"
        '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"
        '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)
          content:
            application/json:
              examples:
                unprocessable_content_error_siren_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é
                missing_mandatory_params_context_error:
                  value:
                    errors:
                    - code: '00201'
                      title: Entité non traitable
                      detail: Le paramètre context est obligatoire
                      source:
                        parameter: context
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre context est obligatoire
                missing_mandatory_params_object_error:
                  value:
                    errors:
                    - code: '00202'
                      title: Entité non traitable
                      detail: Le paramètre object est obligatoire
                      source:
                        parameter: object
                      meta: {}
                  summary: Entité non traitable
                  description: Le paramètre object est obligatoire
                missing_mandatory_params_recipient_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"
        '502':
          description: Erreur du fournisseur
          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.
                erreur_interne_du_fournisseur_de_donnees_04000:
                  value:
                    errors:
                    - code: '04000'
                      title: Erreur interne du fournisseur de données
                      detail: La réponse retournée par le fournisseur de données est
                        invalide et a été identifié comme étant une erreur interne.
                        Si le problème persiste, consultez la page de status ou contactez
                        nous sur le support.
                      source:
                      meta:
                        provider: ACOSS
                  summary: Erreur interne du fournisseur de données
                  description: La réponse retournée par le fournisseur de données
                    est invalide et a été identifié comme étant une erreur interne.
                    Si le problème persiste, consultez la page de status ou contactez
                    nous sur le support.
                erreur_aupres_du_fournisseur_de_donnees_trop_de_requetes_04008:
                  value:
                    errors:
                    - code: '04008'
                      title: 'Erreur auprès du fournisseur de données : trop de requêtes'
                      detail: 'Erreur de fournisseur de donnée : Trop de requêtes
                        effectuées, veuillez réessayer plus tard.'
                      source:
                      meta:
                        provider: ACOSS
                  summary: 'Erreur auprès du fournisseur de données : trop de requêtes'
                  description: 'Erreur de fournisseur de donnée : Trop de requêtes
                    effectuées, veuillez réessayer plus tard.'
                erreur_temporaire_du_fournisseur_de_donnees_04011:
                  value:
                    errors:
                    - code: '04011'
                      title: Erreur temporaire du fournisseur de données
                      detail: Merci de réessayer dans quelques instants
                      source:
                      meta:
                        provider: ACOSS
                  summary: Erreur temporaire du fournisseur de données
                  description: Merci de réessayer dans quelques instants
                erreur_de_certificat_ssl_du_fournisseur_de_donnees_04009:
                  value:
                    errors:
                    - code: '04009'
                      title: Erreur de certificat SSL du fournisseur de données
                      detail: Le certificat SSL du fournisseur de données est invalide
                        ou expiré.
                      source:
                      meta:
                        provider: ACOSS
                  summary: Erreur de certificat SSL du fournisseur de données
                  description: Le certificat SSL du fournisseur de données est invalide
                    ou expiré.
                analyse_manuelle_de_la_situation_du_compte_en_cours_04501:
                  value:
                    errors:
                    - code: '04501'
                      title: Analyse manuelle de la situation du compte en cours
                      detail: Une analyse humaine par un agent des URSSAF est requise.
                        Le temps de traitement est très variable selon de la complexité
                        de situation, la demande de pièces justificatives complémentaires
                        ou la charge de travail des agents.
                      source:
                      meta:
                        provider: ACOSS
                        retry_in: 172800
                  summary: Analyse manuelle de la situation du compte en cours
                  description: Une analyse humaine par un agent des URSSAF est requise.
                    Le temps de traitement est très variable selon de la complexité
                    de situation, la demande de pièces justificatives complémentaires
                    ou la charge de travail des agents.
                demande_de_traitement_logiciel_en_cours_04502:
                  value:
                    errors:
                    - code: '04502'
                      title: Demande de traitement logiciel en cours
                      detail: Une erreur informatique a eu lieu, une demande de traitement
                        par le logiciel est en cours.
                      source:
                      meta:
                        provider: ACOSS
                  summary: Demande de traitement logiciel en cours
                  description: Une erreur informatique a eu lieu, une demande de traitement
                    par le logiciel est en cours.
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_04051:
                  value:
                    errors:
                    - code: '04051'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: 'Erreur lors du décodage : la chaîne de caractères en
                        base64 est invalide'
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: 'Erreur lors du décodage : la chaîne de caractères
                    en base64 est invalide'
                fichier_renvoye_par_le_fournisseur_de_donnees_non_valide_04055:
                  value:
                    errors:
                    - code: '04055'
                      title: Fichier renvoyé par le fournisseur de données non valide
                      detail: Le fichier n'est pas au format attendu
                      source:
                      meta: {}
                  summary: Fichier renvoyé par le fournisseur de données non valide
                  description: Le fichier n'est pas au format attendu
                erreur_reseau_du_service_d_hebergement_de_donnees_00502:
                  value:
                    errors:
                    - code: '00502'
                      title: Erreur réseau du service d'hébergement de données
                      detail: Problème de connexion au serveur d'hébergement de données.
                        L'erreur peut venir soit du fournisseur, soit de API Entreprise
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau du service d'hébergement de données
                  description: Problème de connexion au serveur d'hébergement de données.
                    L'erreur peut venir soit du fournisseur, soit de API Entreprise
              schema:
                "$ref": "#/components/schemas/Error"
        '404':
          description: Entreprise non trouvée
          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
          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é.
                provider_unavailable_error:
                  value:
                    errors:
                    - code: '04001'
                      title: Service non disponible
                      detail: Service du fournisseur de données temporairement indisponible
                        ou en maintenance.
                      source:
                      meta:
                        provider: ACOSS
                  summary: Service non disponible
                  description: Service du fournisseur de données temporairement indisponible
                    ou en maintenance.
                network_error:
                  value:
                    errors:
                    - code: '00501'
                      title: Erreur réseau
                      detail: Problème de connexion au serveur distant. L'erreur peut
                        venir soit du fournisseur, soit de API Entreprise. Il s'agit
                        souvent d'une erreur temporaire.
                      source:
                      meta:
                        retry_in: 10
                  summary: Erreur réseau
                  description: Problème de connexion au serveur distant. L'erreur
                    peut venir soit du fournisseur, soit de API Entreprise. Il s'agit
                    souvent d'une erreur temporaire.
                dns_resolution_error:
                  value:
                    errors:
                    - code: '04004'
                      title: Erreur de résolution DNS
                      detail: Problème de résolution DNS de l'adresse du serveur
                      source:
                      meta:
                        provider: ACOSS
                  summary: Erreur de résolution DNS
                  description: Problème de résolution DNS de l'adresse du serveur
              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"
      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
