Annual workforce headcount of a legal unit - GIP MDS | Entreprise API bundleAPI Effectifs annuels d'une unité légale - GIP MDS | Bouquet API Entreprise
API Effectifs annuels d'une unité légale - GIP MDS | Bouquet API EntrepriseAnnual workforce headcount of a legal unit - GIP MDS | Entreprise API bundle
Part of the Entreprise API bundle coordinated by Etalab, this API provides access to the annual workforce headcount of a legal entity (unité légale) under both the general and agricultural social security schemes, sourced from GIP MDS. It is intended for administrations and authorized partners needing to verify or retrieve employer headcount data as part of dealings with businesses in France, requiring a key for access.> L'[API Effectifs annuels d'une unité légale - GIP MDS | Bouquet API Entreprise](https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale) permet d'accéder aux **effectifs annuels des régimes général et agricole d'une unité légale**. ➡️ **Cette API fait partie du bouquet […
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 | Identifier of the data provider, as returned by /pings.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 multiple active delegations."**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 of the request, e.g. public aid or public 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 of the establishment.Siret de l'établissement |
| limit | number | Maximum number of results returned, between 1 and 1000.Limite le nombre de résultats retournés. Valeur entre 1 et 1000 (Défault 1000) |
| sirenSIREN (company) | string | SIREN number identifying the legal unit.SIREN number identifying the legal unit. |
| siren_or_siret_or_rnaSiren or siret or rna | string | SIREN, SIRET or RNA number of the association concerned.Siren, Siret ou RNA de l'association dont vous souhaitez obtenir les subventions. |
| siret_or_eoriSiret or eori | string | SIRET or EORI number of the company.Siret ou numéro EORI de l'entreprise |
| year | integer | Reference year for the workforce data.Reference year for the workforce data. |
| siren_or_rnaSiren or rna | string | SIREN 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 of the workforce data, format 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 by the API call.List of errors returned by the API call. |
Schema captured from openapi 1 month 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.