{"id":"3401a9dc-cacb-47c6-a50d-bccc9327670b","type":"API","name":"API Effectifs mensuels d'un établissement - GIP MDS | Bouquet API Entreprise","slug":"api-effectifs-mensuels-dun-etablissement-gip-mds-bouquet-api-entreprise","description":"> 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…","free_access_class":"FREE_KEY_REQUIRED","auth_type":"NONE","homepage_url":"https://www.data.gouv.fr/dataservices/api-effectifs-mensuels-dun-etablissement-gip-mds-bouquet-api-entreprise","docs_url":"https://entreprise.api.gouv.fr/developpeurs/openapi#tag/Informations-generales/paths/~1v3~1gip_mds~1etablissements~1%7Bsiret%7D~1effectifs_mensuels~1%7Bmonth%7D~1annee~1%7Byear%7D/get","repo_url":null,"status":"ACTIVE","verification_state":"STALE","tags":["agriculture","business"],"logo_url":"https://udata-avatars.s3.rbx.io.cloud.ovh.net/a0/16eb04d7754b989b7dcd21d77699bd-100.png","primary_source_url":"https://www.data.gouv.fr/dataservices/api-effectifs-mensuels-dun-etablissement-gip-mds-bouquet-api-entreprise","extraction_confidence":"0.40","created_at":"2026-06-07T22:08:41.214Z","updated_at":"2026-08-21T07:28:43.544Z","last_verified_at":"2026-08-14T21:13:55.805Z","deprecated_at":null,"ranking_score":60,"last_ranked_at":"2026-08-08T11:02:51.553Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-08-21T07:28:43.544Z","search_vector":"'/catalogue/gip_mds/effectifs_mensuels_etablissement)':37B,184B 'a':215B,237B 'acceder':187B 'access':61B,117B,208B,264B 'accéder':40B 'administr':104B 'administrative':251B 'agricol':48B 'agricole':195B 'agricultur':76B,146C 'agricultural':223B 'allow':96B,243B 'alreadi':112B 'already':259B 'an':163A,266B 'and':222B,250B 'api':1A,10A,20A,24B,33B,53B,59B,87B,94B,120B,123B,148A,157A,167A,171B,180B,200B,206B,234B,267B,270B 'apis':241B 'applic':108B 'applicants':255B 'author':97B,116B 'authorities':263B 'authorized':244B 'aux':41B,188B 'both':219B 'bouqu':57B,204B 'bouquet':9A,32B,156A,179B 'bundl':22A,89B 'bundle':169A,236B 'busi':69B,102B,147C 'business':216B,249B 'by':261B,276B,282B 'cett':52B 'cette':199B 'coordin':128B 'coordinated':275B 'cover':71B 'covering':218B 'd':4A,27B,39B,49B,151A,174B,186B,196B 'data':105B,133B,144B,252B,280B,291B 'data.gouv.fr':127B,274B 'des':44B,191B 'document':111B 'documents':258B 'draw':131B 'drawing':278B 'du':56B,203B 'effectif':2A,25B,42B 'effectifs':149A,172B,189B 'entrepris':11A,21A,34B,88B 'entreprise':158A,168A,181B,235B 'entreprise.api.gouv.fr':36B,183B 'entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_mensuels_etablissement)':35B,182B 'establish':17A,70B 'establishment':164A,217B 'et':47B,194B 'etablissement':153A,176B,198B 'etalab':130B,277B 'fait':54B,201B 'for':289B 'franc':81B 'france':228B 'general':74B,193B,221B 'gip':7A,18A,30B,136B,154A,165A,177B,283B 'govern':93B 'government':240B 'group':141B,288B 'général':46B 'headcount':14A,66B,161A,213B 'held':113B,260B 'in':227B 'interest':140B,287B 'is':230B,271B 'it':229B 'joint':139B,286B 'key':121B,268B 'l':23B,170B 'manag':134B 'managed':281B 'mds':8A,19A,31B,137B,155A,166A,178B,284B 'mensuel':3A,26B,43B 'mensuels':150A,173B,190B 'modern':145B 'modernization':292B 'month':12A,64B 'monthly':159A,211B 'of':162A,214B,232B,239B 'offici':101B 'official':248B 'on':279B 'organ':98B 'organizations':245B 'part':84B,231B 'parti':55B 'partie':202B 'permet':38B,185B 'provid':60B 'provides':207B 'public':115B,262B 'publish':125B 'published':272B 'regimes':192B 'requir':107B,118B 'requires':265B 'requiring':254B 'resuppli':110B 'resupply':257B 'retriev':100B 'retrieve':247B 'régime':45B 'scheme':79B 'schemes':226B 'secur':78B 'security':225B 'set':91B,238B 'social':77B,143B,224B,290B 'that':242B 'the':210B,220B,233B,269B,285B 'this':205B 'to':209B,246B,256B 'un':5A,28B,50B,152A,175B,197B 'via':126B,273B 'without':106B,253B 'workforc':13A,65B 'workforce':160A,212B 'établiss':6A,29B,51B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"7abf1844-58f2-4b35-a86e-1e4a6b7652f7","institution_type":"AGENCY","country_code":"FR","official_confidence":40,"proof_summary":"official domain (data.gouv.fr) (catalog: api_gouv_fr)","source_seed_url":null,"is_public_sector":true,"published_at":"2026-06-07T22:08:41.214Z","geographic_scope":"NATIONAL","name_en":"Monthly workforce headcount of an establishment - GIP MDS | API Entreprise bundle","description_en":"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.”","native_lang":"fr","access_level":"documented","formats":[],"capability_tier":"sample","trust_score":63.25,"access":{"level":"documented","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://entreprise.api.gouv.fr","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://entreprise.api.gouv.fr","source":"probe","runnable":true},{"kind":"spec","label":"OpenAPI spec","method":"GET","url":"https://entreprise.api.gouv.fr/open-api-without-deprecated-paths.yml","source":"openapi","runnable":false},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://entreprise.api.gouv.fr/developpeurs/openapi#tag/Informations-generales/paths/~1v3~1gip_mds~1etablissements~1%7Bsiret%7D~1effectifs_mensuels~1%7Bmonth%7D~1annee~1%7Byear%7D/get","source":"docs","runnable":false},{"kind":"landing","label":"Visit homepage","method":"GET","url":"https://www.data.gouv.fr/dataservices/api-effectifs-mensuels-dun-etablissement-gip-mds-bouquet-api-entreprise","source":"homepage","runnable":false}],"formats":[]},"maturity":{"entry_id":"3401a9dc-cacb-47c6-a50d-bccc9327670b","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"discovered","level_index":1,"level_label":"Discovered","meaning":"Source and metadata recorded","counts_as_coverage":false,"blocked_by":"verified","rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":false,"reached":false,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":true,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":false,"reached":false,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":40,"proven_threshold":80,"institution_id":"7abf1844-58f2-4b35-a86e-1e4a6b7652f7","definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"www.data.gouv.fr","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-08-22T19:54:45.988Z"},"api_details":{"id":"a27ee08f-c2e9-47f5-a6b0-a70b0373c00b","entry_id":"3401a9dc-cacb-47c6-a50d-bccc9327670b","base_url":"https://entreprise.api.gouv.fr","openapi_url":"https://entreprise.api.gouv.fr/open-api-without-deprecated-paths.yml","graphql_url":null,"api_version":null,"spec_format":"openapi","endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":"https://entreprise.api.gouv.fr","created_at":"2026-06-07T22:08:41.233Z","updated_at":"2026-06-07T22:08:41.233Z"},"dataset_details":null,"license":null,"reuse":{"license_id":null,"license_name":null,"license_url":null,"commercial_use":{"status":"unknown","value":null},"redistribution":{"status":"unknown","value":null},"attribution_required":{"status":"unknown","value":null},"share_alike":{"status":"unknown","value":null},"personal_data_warning":{"status":"unknown","value":null},"cache_and_mirror":{"status":"unknown","value":null},"undetermined":["commercial_use","redistribution","attribution_required","share_alike","personal_data_warning","cache_and_mirror"],"basis":"unverified","confidence":0.1,"confidence_tier":"low","source_text":null,"source_url":null,"reviewed_at":null},"license_raw":null,"latest_check":{"id":"aa8f82dd-3148-466a-84e5-ae236922ef1d","entry_id":"3401a9dc-cacb-47c6-a50d-bccc9327670b","status":"VERIFIED","last_checked_at":"2026-08-14T21:13:55.548Z","p50_latency_ms":1631,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:09.238Z","updated_at":"2026-08-14T21:13:55.548Z","consecutive_successes":51,"probe_url":"https://entreprise.api.gouv.fr","probe_method":"GET","probe_http_status":200,"probe_content_type":"text/html; charset=utf-8","probe_succeeded_at":"2026-08-14T21:13:55.548Z"},"data_profile":{"id":"7fdf5aa2-6029-402f-8320-59d230858ee1","entry_id":"3401a9dc-cacb-47c6-a50d-bccc9327670b","profile_source":"openapi","profile_kind":"dataset","dataset_id":null,"fields":[{"name":"provider","role":"parameter","type":"string","label":null,"param_in":"path","required":true,"container":"/ping/{provider}","filterable":true,"description":"Identifiant du fournisseur (tel que retourné par `/pings`)","description_en":"Identifier of the data provider, as returned by /pings."},{"name":"recipient","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/v3/ademe/etablissements/{siret}/certification_rge","filterable":true,"description":"\"**Bénéficiaire de l’appel**\n\nSIRET de l’administration destinatrice des données.\"","description_en":"SIRET of the administration receiving the data."},{"name":"delegation_id","role":"parameter","type":"string","label":null,"param_in":"query","container":"/v3/ademe/etablissements/{siret}/certification_rge","filterable":true,"description":"\"**Identifiant de la délégation éditeur**\n\nUUID 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).\"","description_en":"UUID identifying a specific publisher delegation, used to disambiguate tokens."},{"name":"context","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/v3/ademe/etablissements/{siret}/certification_rge","filterable":true,"description":"\"**Cadre de la requête**\n\nPar exemple : aides publiques, marchés publics ou gestion d’un référentiel tiers utilisé pour tel type d’application.\"","description_en":"Purpose or framework of the request, e.g. public aid or procurement."},{"name":"object","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/v3/ademe/etablissements/{siret}/certification_rge","filterable":true,"description":"\"**La raison de l’appel ou l’identifiant de la procédure.**\n\nL’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","description_en":"Reason for the call or an identifier used to trace the request."},{"name":"siret","role":"parameter","type":"string","label":null,"param_in":"path","required":true,"container":"/v3/ademe/etablissements/{siret}/certification_rge","filterable":true,"description":"Siret de l'établissement","description_en":"SIRET identifier of the establishment."},{"name":"limit","role":"parameter","type":"number","label":null,"param_in":"query","container":"/v3/ademe/etablissements/{siret}/certification_rge","filterable":true,"description":"Limite le nombre de résultats retournés. Valeur entre 1 et 1000 (Défault 1000)","description_en":"Maximum number of results returned, between 1 and 1000 (default 1000)."},{"name":"siren","role":"parameter","type":"string","label":null,"param_in":"path","required":true,"container":"/v3/banque_de_france/unites_legales/{siren}/bilans","filterable":true,"description":null,"description_en":"SIREN identifier of the company."},{"name":"siren_or_siret_or_rna","role":"parameter","type":"string","label":null,"param_in":"path","required":true,"container":"/v3/data_subvention/associations/{siren_or_siret_or_rna}/subventions","filterable":true,"description":"Siren, Siret ou RNA de l'association dont vous souhaitez obtenir les subventions.","description_en":"SIREN, SIRET or RNA number of the association whose subsidies are requested."},{"name":"siret_or_eori","role":"parameter","type":"string","label":null,"param_in":"path","required":true,"container":"/v3/douanes/etablissements/{siret_or_eori}/immatriculations_eori","filterable":true,"description":"Siret ou numéro EORI de l'entreprise","description_en":"SIRET or EORI number of the company."},{"name":"year","role":"parameter","type":"integer","label":null,"param_in":"path","required":true,"container":"/v4/dgfip/unites_legales/{siren}/liasses_fiscales/{year}","filterable":true,"description":null,"description_en":"Reference year for the requested data."},{"name":"siren_or_rna","role":"parameter","type":"string","label":null,"param_in":"path","required":true,"container":"/v4/djepva/api-association/associations/{siren_or_rna}","filterable":true,"description":"Siren de l'association ou le numéro RNA","description_en":"SIREN of the association or its RNA number."},{"name":"nature_effectif","role":"parameter","type":"string","label":null,"param_in":"query","container":"/v3/gip_mds/unites_legales/{siren}/effectifs_annuels/{year}","filterable":true,"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 e","enum_values":["moyen","boeth","ecap","assujettissement_oeth"],"description_en":"Type of workforce figure requested, defaulting to annual average headcount (EMA)."},{"name":"month","role":"parameter","type":"string","label":null,"param_in":"path","required":true,"container":"/v3/gip_mds/etablissements/{siret}/effectifs_mensuels/{month}/annee/{year}","filterable":true,"description":"Mois de référence des effectifs (format: 01 à 12).","enum_values":["01","02","03","04","05","06","07","08","09","10","11","12"],"description_en":"Reference month of the workforce data, formatted 01 to 12."},{"name":"profondeur","role":"parameter","type":"integer","label":null,"param_in":"query","container":"/v3/gip_mds/etablissements/{siret}/effectifs_mensuels/{month}/annee/{year}","filterable":true,"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évri","description_en":"Number of months of prior data to return, up to 13 months."},{"name":"errors","type":"array<object>","label":"Error","required":true,"description":null,"description_en":"List of errors returned in the API response."}],"field_count":16,"sample_records":null,"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://entreprise.api.gouv.fr/open-api-without-deprecated-paths.yml","curl":"curl -s 'https://entreprise.api.gouv.fr/open-api-without-deprecated-paths.yml' -H 'Accept: application/json'","label":"OpenAPI spec","method":"GET","description":"Machine-readable API description (use it to generate clients)."}],"status":"partial","error_message":null,"profiled_at":"2026-07-21T23:59:17.024Z","run_id":"084c640e-ac6e-4e23-8346-f4c4483e4c54","created_at":"2026-06-12T19:05:30.449Z","updated_at":"2026-08-05T06:11:42.116Z","license_raw":null,"license_id":null,"consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":false},"datasets":[],"limits":[],"manifest":{"answer_sha256":"8b65fb119e09432e2bd8626fb0fec76e2cfeb85b76ef7222af4e423cec72cc9c","answer_sha256_rule":"sha256 (hex, UTF-8) of JSON.stringify(this body) after deleting the keys listed in manifest.stamped_keys from manifest, and deleting manifest itself if it is then empty. The hash was computed before the stamp existed, so no field of the stamp is inside it.","stamped_keys":["answer_sha256","answer_sha256_rule","stamped_keys","row_count","row_count_basis","live","live_basis","created_at","created_at_basis","durable_citation"],"row_count":28,"row_count_basis":"Objects that are elements of a JSON array anywhere in this body, excluding manifest. Not a claim about which collection is the answer. Largest single collection: data_profile.fields[] (16 rows).","live":true,"live_basis":"This body was produced by executing the request.","created_at":"2026-08-22T19:54:46.036Z","created_at_basis":"When this response body was assembled, deliberately OUTSIDE the hashed bytes so the same answer hashes identically on every request. Not the upstream read time — that is provenance[].retrieved_at. A zone-cached replay carries the assembly time, not your receipt time.","durable_citation":"This manifest is produced at response time and is NOT stored. A durable, replayable citation is persisted only on an explicit cite: GET /api/v1/entries/{id-or-slug}/evidence, or the MCP cite_query tool. Both are entry-scoped, because evidence_manifests is entry-shaped; a domain answer spanning several sources has no single entry and cannot be persisted through that path."}}