Effectifs mensuels d'un établissement

Effectifs mensuels des régimes général et agricole d'un établissement, issus du répertoire commun des déclarants (RCD).

Logo du fournisseur de données
Fournisseur de la donnée

GIP-MDS


Périmètre

Entreprises ou associations concernées :

Cette API permet d’accéder aux effectifs mensuels de ✅ tous les établissements du régime général et du régime agricole ayant des salariés.

  • ✅ Les associations ayant un SIREN et des salariés sont concernées par cette API ;
  • ❌ Les régimes spéciaux ne sont pas couverts ;
  • ❌ Certaines catégories d’établissements n’ont tout simplement d’effectif, en savoir plus.

Périmètre géographique :

  • ✅ France métropolitaine
  • ✅ DROM-COM

Actualisation de la donnée :

L’effectif du mois M d’un établissement est mis à disposition à la fin du mois M+1 ; par exemple, l’effectif du mois de février est disponible fin mars. Il n’est donc pas possible d’obtenir l’effectif du mois courant.

L’effectif d’un même mois peut évoluer au cours du temps, car les régularisations a posteriori sont possibles.

Cas d'usage

Liste des cas d'usage où cette API est utile :
Liste des cas d'usage où cette API est peut être utile :

Détails de l'API

Format de l'information

Donnée structurée JSON

Identifiants d'appel

Numéro de SIRET de l'établissement
Année
Mois

Disponibilité

Temps réel :
Page de statut des API
Disponible 24h/24 et 7j/7

Spécifications techniques :

Consulter le swagger Cas de tests

Les données

Cette API délivre l’effectif moyen mensuel (EMM) de l’établissement pour le mois demandé. Les données transmises sont issues du répertoire commun des déclarants (RCD) qui récupère les effectifs du régime général auprès de l’URSSAF et les données du régime agricole auprès de la MSA.

L’effectif moyen mensuel est construit à partir des effectifs moyens mensuels des individus actifs sur le mois considéré. En savoir plus sur le calcul de l’EMM.

La profondeur de l’historique des effectifs mensuels disponibles est de 5 ans. En savoir plus sur les options d’appel de l’historique.

Besoin des effectifs OETH ?

Le GIP-MDS met à disposition de l’API Entreprise d’autres effectifs plus spécifiques (BOETH, ECAP et d’assujettissement) que nous n’avons pas encore intégré dans cette API. Si vous en avez besoin, dîtes-le nous :

Informations renvoyées en JSON :

Siret de l'établissement
ex: 13002526500013
Effectif mensuels de l'établissement
Cette propriété contient 1 ou plusieurs éléments ayant les spécifications suivantes :
Type de régime
ex: regime_general
Valeur
ex: 12.34
Cette valeur est à null si il n'y a pas d'effectif dans le régime
Nature de l'effectif
Année
ex: 2021
Mois
ex: 01
Date de la dernière mise à jour de la donnée
ex: 2018-01-01

Questions & réponses

L’effectif moyen mensuel est construit à partir des effectifs moyens mensuels des individus actifs sur le mois considéré.

L’ensemble des contrats sont pris en compte, à l’exception :

  • ❌ des contrats d’apprentissage ;
  • ❌ des contrats d’initiative l’emploi ;
  • ❌ des contrats d’accompagnement dans l’emploi ;
  • ❌ des contrats de professionnalisation ;
  • ❌ des conventions industrielles de formation par la recherche en entreprise ;
  • ❌ des CDD en remplacement d’un salarié absent ;
  • ❌ des conventions de stage ;
  • ❌ des contrats de volontariat de service civique ;
  • ❌ des contrats de soutien et d’aide par le travail ;
  • ❌ des contrats de type ligne de service ;

  • ❌ des périodes de mise en situation en milieu professionnel ;
  • ❌ des compagnons d’Emmaüs ;
  • ❌ Patrons-pêcheurs ;
  • ❌ des vendeurs à domicile indépendants (VDI) ;
  • ❌ des mandats sociaux ;
  • ❌ des contrats d’appui au projet d’entreprise ;
  • ❌ des praticiens hospitaliers en détachement ;
  • ❌ des contrats d’engagement détenu ;
  • ❌ des colporteurs de presse ;
  • ❌ des statuts d’emploi “militaire de réserve” ;
  • ❌ des parcours d’accès aux carrières (Pacte) ;
  • ❌ des travailleurs expatriés à l’étranger au sens de la Sécurité Sociale ;
  • ❌ des mandats d’élus ;
  • ❌ des fonctionnaire en détachement sur un mandat électif (élu local) ;
  • ❌ des contrats de mission d’un collaborateur occasionnel du service public (COSP) ou assimilé
  • ❌ des fonctionnaires pour détachement.

Pour en savoir plus :

Le site de l’Urssaf est la source de référence des règles de gestion et de calcul des effectifs. Le document suivant les explique en détail :

Le bulletin officiel de la Sécurité sociale présente les formules de calcul illustrées par des exemples types.

L’API vous permet de consulter les historiques mensuels de l’établissement jusqu’à 5 années en arrière.

L’API délivre jusqu’à 13 effectifs mensuels sur un même appel. Pour obtenir la totalité d’un historique de plusieurs années, il faudra effectuer plusieurs appels.
Dans vos appels, vous devez renseigner le mois de l’effectif voulu le plus proche, et la profondeur de l’historique souhaitée.

Exemple :
Si vous notez en paramètre d’appel le mois 05 de l'année N et une profondeur de 3. Vous obtiendrez les effectifs suivants :

  • Effectif du mois de mai de l’année N ;
  • Effectif du mois de avril de l’année N ;
  • Effectif du mois de mars de l’année N.

  • Les établissements fermés n’ont pas d’effectifs ;
  • Les auto-entrepreneurs non plus ;
  • Les entreprises indiquées par l’Insee comme “unité non-employeuse” non plus, même si de rares erreurs sont parfois observées ;
  • Certaines administrations et collectivités territoriales n’ont pas de salariés, car elles n’ont que des fonctionnaires, qui ne sont pas au régime général (et donc ne sont pas couverts par cette API). Celles qui embauchent des contractuels (en CDD ou CDI) ont un effectif qui ne couvre que cette catégorie de personnel.

Conditions d'utilisation des données

Utilisation possible de la donnée :

Agent habilité ou usager authentifié

Conditions générales :

Cette API et l’utilisation de ses données est soumise aux CGU générales d’API Entreprise, dont voici les principaux éléments auxquels vous vous engagez :

  • ne demander que les données strictement nécessaires ;
  • ne pas utiliser votre jeton d’accès pour une démarche différente de celle indiquée lors de votre demande (le cas échéant le jeton sera révoqué) ;
  • présenter les données obtenues uniquement aux seuls agents habilités et à tracer l’accès de ces agents aux données ;
  • ne pas commercialiser les données reçues et à ne pas les communiquer à des tiers en dehors des cas prévus par la loi.
L’ensemble des conditions sont consultables et téléchargeables ci-dessous :

CGU API Entreprise

Cas d'usage

Liste des cas d'usage où cette API est utile :
Liste des cas d'usage où cette API est peut être utile :

Détails de l'API

Format de l'information

Donnée structurée JSON

Identifiants d'appel

Numéro de SIRET de l'établissement
Année
Mois

Disponibilité

Temps réel :
Page de statut des API
Disponible 24h/24 et 7j/7

Spécifications techniques :

Consulter le swagger Cas de tests