Monthly workforce headcount of an establishment - GIP MDS | API Entreprise bundleAPI Effectifs mensuels d'un établissement - GIP MDS | Bouquet API Entreprise
API Effectifs mensuels d'un établissement - GIP MDS | Bouquet API EntrepriseMonthly workforce headcount of an establishment - GIP MDS | API Entreprise bundle
This API provides access to the monthly workforce headcount of a business establishment, covering both the general and agricultural social security schemes in France. It is part of the API Entreprise bundle, a set of government APIs that allow authorized organizations to retrieve official business and administrative data without requiring applicants to resupply documents already held by public authorities. Access requires an API key. The API is published via data.gouv.fr, coordinated by Etalab, drawing on data managed by GIP MDS, the joint interest group for social data modernization.”> L'[API Effectifs mensuels d'un établissement - GIP MDS | Bouquet API Entreprise](https://entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement) permet d'accéder aux **effectifs mensuels des régimes général et agricole d'un établissement**. ➡️ **Cette API fait partie du bouqu…
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 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, e.g. 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 an identifier used to trace the request."**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 identifier of the establishment.Siret de l'établissement |
| limit | number | Maximum number of results returned, 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 identifier of the company.SIREN identifier of 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 of 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 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, defaulting to annual average headcount (EMA).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, formatted 01 to 12.Mois de référence des effectifs (format: 01 à 12). |
| profondeur | integer | Number of months of prior data to return, up to 13 months.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 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.