Succession Links API - Insee | API Entreprise bundleAPI Liens de succession - Insee | Bouquet API Entreprise
API Liens de succession - Insee | Bouquet API EntrepriseSuccession Links API - Insee | API Entreprise bundle
Part of the API Entreprise bundle coordinated by Etalab, this API provides access to the list of predecessor and successor establishments of a given entity in the Sirene business register. It is used to trace business continuity when an establishment ceases activity and is succeeded by another, or when it results from the succession of a previous one. Access requires an API key. The service is aimed at organizations needing to verify or reconstruct the succession history of French registered businesses and establishments.> L'[API Liens de succession du bouquet API Entreprise](https://entreprise.api.gouv.fr/catalogue/insee/successions) permet d'accéder à la liste des prédécesseurs et successeurs d'un établissement du **répertoire Sirene**. ➡️ **Cette API font partie du bouquet** **[API Entreprise](https://entrepris…
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (16 fields)
| Field | Type | Description |
|---|---|---|
| provider | string | Provider identifier as returned by the /pings endpoint.Identifiant du fournisseur (tel que retourné par `/pings`) |
| recipient | string | SIRET of the administration receiving the data."**Bénéficiaire de l’appel** SIRET de l’administration destinatrice des données." |
| delegation_idDelegation id | string | UUID identifying a specific publisher delegation, used to disambiguate tokens."**Identifiant de la délégation éditeur** UUID d’une délégation précise, réservé aux jetons éditeur. Optionnel : requis uniquement lorsque plusieurs délégations actives existent pour le même `recipient`, afin de lever l’ambiguïté (cf. erreur 00212)." |
| context | string | Purpose or framework of the request, such as public aid or procurement."**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." |
| object | string | Reason for the call or identifier of the related procedure."**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 deve |
| siretSIRET (establishment) | string | SIRET number identifying the establishment.Siret de l'établissement |
| limit | number | Maximum number of results to return, between 1 and 1000 (default 1000).Limite le nombre de résultats retournés. Valeur entre 1 et 1000 (Défault 1000) |
| sirenSIREN (company) | string | SIREN number identifying the company.SIREN number identifying the company. |
| siren_or_siret_or_rnaSiren or siret or rna | string | SIREN, SIRET, or RNA number of the association whose subsidies are requested.Siren, Siret ou RNA de l'association dont vous souhaitez obtenir les subventions. |
| siret_or_eoriSiret or eori | string | SIRET or EORI number identifying the company.Siret ou numéro EORI de l'entreprise |
| year | integer | Reference year for the requested data.Reference year for the requested data. |
| siren_or_rnaSiren or rna | string | SIREN number of the association or its RNA number.Siren de l'association ou le numéro RNA |
| nature_effectifNature effectif | string | Type of workforce figure requested, e.g. average annual headcount.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 : - Effectif moyen annuel (EMA), c'est-à-dire le nombre de salariés en contrat 'actif' hors exclusions. Ces e |
| month | string | Reference month for the workforce data, formatted 01 to 12.Mois de référence des effectifs (format: 01 à 12). |
| profondeur | integer | Number of months of prior workforce data to return, up to 13.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évri |
| errorsError | array<object> | List of errors returned in the API response.List of errors returned in the API response. |
Schema captured from openapi 26 days ago.
Verification Status
Using the API
Configuration
- Base URL
- https://entreprise.api.gouv.fr
- Format
- openapi
Query examples
Stored only in this browser. Runs go directly from your browser to the API — the key is never sent through our servers.
curl -s 'https://entreprise.api.gouv.fr/open-api-without-deprecated-paths.yml' -H 'Accept: application/json'Machine-readable API description (use it to generate clients).
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.