{"id":"5e96e53d-22d4-4f4c-ada9-1e03a3f145b9","type":"API","name":"API Effectifs annuels d'une unité légale - GIP MDS | Bouquet API Entreprise","slug":"api-effectifs-annuels-dune-unite-legale-gip-mds-bouquet-api-entreprise","description":"> 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 […","free_access_class":"FREE_KEY_REQUIRED","auth_type":"NONE","homepage_url":"https://www.data.gouv.fr/dataservices/api-effectifs-annuels-dune-unite-legale-gip-mds-bouquet-api-entreprise","docs_url":"https://entreprise.api.gouv.fr/developpeurs/openapi#tag/Informations-generales/paths/~1v3~1gip_mds~1unites_legales~1%7Bsiren%7D~1effectifs_annuels~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-annuels-dune-unite-legale-gip-mds-bouquet-api-entreprise","extraction_confidence":"0.40","created_at":"2026-06-07T22:08:41.146Z","updated_at":"2026-08-21T08:34:02.053Z","last_verified_at":"2026-08-16T00:01:48.475Z","deprecated_at":null,"ranking_score":60,"last_ranked_at":"2026-08-08T15:08:38.381Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-08-21T08:34:02.053Z","search_vector":"'/catalogue/gip_mds/effectifs_annuels_unite_legale)':40B,169B 'a':146A,210B,253B 'acceder':172B 'access':74B,127B,203B,256B 'accéder':43B 'administr':103B 'administrations':232B 'agricol':51B 'agricole':180B 'agricultur':91B,128C 'agricultural':220B 'and':219B,233B 'annual':13A,77B,142A,206B 'annuel':3A,28B,46B 'annuels':132A,157B,175B 'api':1A,11A,23A,26B,36B,57B,66B,72B,130A,140A,152A,155B,165B,186B,195B,201B 'as':244B 'author':105B 'authorized':234B 'aux':44B,173B 'both':216B 'bouquet':10A,35B,61B,139A,164B,190B 'bundl':24A,67B 'bundle':153A,196B 'busi':120B,129C 'businesses':249B 'by':198B 'cett':56B 'cette':185B 'coordin':68B 'coordinated':197B 'd':4A,29B,42B,52B,133A,158B,171B,181B 'data':114B,243B 'deal':118B 'dealings':247B 'des':47B,176B 'du':60B,189B 'effectif':2A,27B,45B 'effectifs':131A,156B,174B 'employ':112B 'employer':241B 'entiti':83B 'entity':212B 'entrepris':12A,22A,37B,65B 'entreprise':141A,151A,166B,194B 'entreprise.api.gouv.fr':39B,168B 'entreprise.api.gouv.fr/catalogue/gip_mds/effectifs_annuels_unite_legale)':38B,167B 'et':50B,179B 'etalab':70B,199B 'fait':58B,187B 'for':231B,255B 'franc':122B 'france':251B 'from':225B 'general':89B,178B,218B 'gip':8A,20A,33B,97B,137A,149A,162B,226B 'général':49B 'headcount':15A,79B,113B,144A,208B,242B 'in':250B 'intend':101B 'intended':230B 'is':229B 'it':228B 'key':125B,254B 'l':25B,154B 'legal':18A,82B,147A,211B 'legale':136A,161B,184B,214B 'légale':7A,32B,55B,85B 'mds':9A,21A,34B,98B,138A,150A,163B,227B 'need':107B 'needing':236B 'of':145A,192B,209B,246B 'or':239B 'part':62B,116B,191B,245B 'parti':59B 'partie':188B 'partner':106B 'partners':235B 'permet':41B,170B 'provid':73B 'provides':202B 'regimes':177B 'requir':123B 'requiring':252B 'retriev':111B 'retrieve':240B 'régime':48B 'scheme':94B 'schemes':223B 'secur':93B 'security':222B 'social':92B,221B 'sourc':95B 'sourced':224B 'the':193B,205B,217B 'this':200B 'to':204B,237B 'under':215B 'une':5A,30B,53B,134A,159B,182B 'unit':19A,148A 'unite':135A,160B,183B,213B 'unité':6A,31B,54B,84B 'verifi':109B 'verify':238B 'with':248B 'workforc':14A,78B 'workforce':143A,207B","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.146Z","geographic_scope":"NATIONAL","name_en":"Annual workforce headcount of a legal unit - GIP MDS | Entreprise API bundle","description_en":"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.","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~1unites_legales~1%7Bsiren%7D~1effectifs_annuels~1%7Byear%7D/get","source":"docs","runnable":false},{"kind":"landing","label":"Visit homepage","method":"GET","url":"https://www.data.gouv.fr/dataservices/api-effectifs-annuels-dune-unite-legale-gip-mds-bouquet-api-entreprise","source":"homepage","runnable":false}],"formats":[]},"maturity":{"entry_id":"5e96e53d-22d4-4f4c-ada9-1e03a3f145b9","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:19.536Z"},"api_details":{"id":"688087a4-52fa-4180-a82c-d7ebc23518a5","entry_id":"5e96e53d-22d4-4f4c-ada9-1e03a3f145b9","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.167Z","updated_at":"2026-06-07T22:08:41.167Z"},"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":"1c519a04-6966-4e70-90e9-2a43f4e9bfb7","entry_id":"5e96e53d-22d4-4f4c-ada9-1e03a3f145b9","status":"VERIFIED","last_checked_at":"2026-08-16T00:01:48.147Z","p50_latency_ms":2062,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:11.054Z","updated_at":"2026-08-16T00:01:48.147Z","consecutive_successes":13,"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-16T00:01:48.147Z"},"data_profile":{"id":"2562cd90-2c25-4b4c-aee2-cf9ecd4d7e5e","entry_id":"5e96e53d-22d4-4f4c-ada9-1e03a3f145b9","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 multiple active delegations."},{"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 of the request, e.g. public aid or public 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 identifier of the related procedure."},{"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 number 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."},{"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 number identifying the legal unit."},{"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 concerned."},{"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 workforce 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, e.g. average annual headcount."},{"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, format 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 workforce data to return, up to 13."},{"name":"errors","type":"array<object>","label":"Error","required":true,"description":null,"description_en":"List of errors returned by the API call."}],"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-22T00:12:31.898Z","run_id":"a90673b5-bf88-4417-87b5-19ded9529496","created_at":"2026-06-12T19:11:13.002Z","updated_at":"2026-08-05T06:19:01.072Z","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":"96da47487d42c6b2437ee5293184c24b86e0266981193b283ac695a7464f6b40","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:19.582Z","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."}}