Participation familiale EAJE prochainement

Participation familiale EAJE.

Cette API est bientôt disponible, testez-là !

Cette API est en cours de conception et va bientôt rejoindre le catalogue d'API Particulier.

En plus de cette documentation, un environnement technique de test est déjà disponible :  Consulter le swagger

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

CNAF & MSA


Périmètre

Particuliers concernés :

Cette API délivre les informations permettant le calcul de la participation familiale pour la tarification des établissements d’accueil du jeune enfant (EAJE) des allocataires de la majorité des régimes :

  • ✅ le régime agricole (MSA) ;
  • ✅ le régime général ;
  • ✅ les titulaires de l’éducation nationale ;
  • ✅ les retraités de la fonction publique d’État et des collectivités locales ;
  • ✅ les régimes spéciaux suivants : artiste-auteur-compositeur, France Télécom, industries électriques et gazières, marin du commerce et pêche, mines (régime général), poste, RATP, SNCF, navigation intérieure en cas d’accord local et les pensions des autres régimes.

    Ne sont pas concernés par cette API, les bénéficiaires des régimes suivants :

  • ❌ le régime des titulaires de l’Assemblée nationale et du Sénat ;
  • ❌ le régime de la navigation intérieure sauf lorsqu’un accord local est passé, et que le régime est alors pris en compte par la CAF.

Périmètre géographique :

  • ✅ France métropolitaine
  • ✅ DROM COM
  • ✅ Allocataires de nationalité étrangère résidant en France

Actualisation de la donnée :

Les données sont actualisées :

  • une fois par an, au mois de janvier, pour la base ressource ;
  • lorsqu’il y a un changement de situation pour les enfants à charge et le conjoint ;
  • **tous les 2, 3 ou 5 ans pour le nombre d’ouverture de droit à l’allocatation d’éducation de l’enfant handicapé (selon le taux d’incapacité).

Cette API opérée par la Caisse nationale d’assurance vieillesse (CNAV) est reliée au système d’information de la Caisse nationale des allocations familiales (CNAF) et à celui de la mutualité sociale agricole (MSA).

⚠️ Les informations obtenues sont représentatives de la situation connue par la CNAF et la MSA au moment de l’appel, il est donc possible que les données appelées pour un mois donné à un instant T, soient différentes si elles sont redemandées à un instant T+. En savoir plus.

Spécifications de l'API

Format de l'information

Donnée structurée JSON

Modalités d'appel

  • Identité pivot
  • FranceConnect Pictogramme fournisseurs de données regroupés
Détails des modalités

Disponibilité

Page de statut des API
Disponible 24h/24 et 7j/7

Spécifications techniques :

Consulter le swagger Cas de tests

Modalités d'appel

L’API est uniquement appelable avec les informations de l’allocataire.
Il n’est pas possible d’interroger cette API avec les informations des ayants droit.


Deux modalités d’appel sont possibles :
<p class="fr-badge fr-badge--blue-ecume">Cette API est FranceConnectée FranceConnect</p>
Avec la modalité d’appel FranceConnect.

Identité pivot

  • Nom de naissance*, nom d'usage, prénoms1, sexe*, date de naissance de l'allocataire** ;
  • Lieu de naissance :
    • Si le lieu de naissance est en France, la commune de naissance est obligatoire, elle peut être saisie de deux façons différentes :
      • Option 1 : Code COG de la commune de naissance*. En savoir plus ;
      • Option 2 : Nom de la commune de naissance* et code du département de naissance*. Pour cette option, la date de naissance est obligatoire. En savoir plus.
      Pour chacune des deux options ci-dessus, le code COG de la France 99100* doit également être renseigné en paramètre d'appel. Vous n'avez pas besoin de le demander à l'usager, il peut être déduit de la commune de naissance.
    • Si le lieu de naissance est à l'étranger : code COG du pays de naissance*.

* Obligatoire | ** Obligatoire pour l’option 2 du lieu de naissance. 1 Fournir plusieurs prénoms permet de limiter les risques d’homonymie mais un seul prénom peut fonctionner. Attention, l’usager doit compléter chaque prénom dans un champ distinct.

Les données

Cette API délivre :

  • la composition familiale du particulier : identités de l’allocataire et de son conjoint, identités des enfants au sens des prestations familiales, en savoir plus ;
  • l’adresse du particulier au format de La Poste. ⚠️ Cette adresse est déclarative. Si l’usager a changé d’adresse et n’a pas actualisé son adresse auprès de la CAF ou de la MSA, l’information sera donc obsolète ;
  • les différents paramètres de calcul de la participation familiale : le nombre d’enfants à charge au sens des prestations familiales, le nombre d’ouverture au droit à l’allocation d’éducation de l’enfant handicapé (AEEH), la base ressource prestation de service unique (PSU) : montant et la date de calcul.

Le montant de la base ressource ainsi que l’année de calcul sont remontés seulement pour les allocataires dont les ressources sont déclarées. En effet, la CNAF et la MSA collectent auprès de la DGFIP les ressources de l’individu (revenus salariés et non-salariés, du capital, rentes …). Elles récupèrent le bilan en fin d’année pour mettre à jour ces informations en janvier. Sans la réception de ces ressources, l’API renverra une erreur car si il manque un paramètre de calcul de la PSU, l’API ne restitue pas les autres informations.

Informations renvoyées en JSON :

Données d'identité de l'allocataire et du conjoint
Liste des données d'identité de l'allocataire appelé et de celles du conjoint le cas échéant. La provenance de ces données n'est pas sourcée précisément et diffère selon la CAF ou la MSA.
Cette propriété contient 1 ou plusieurs éléments ayant les spécifications suivantes :
Nom de naissance
ex: JACQUES
Nom de naissance de l'allocataire ou du conjoint.
Nom d'usage
ex: DUPONT
Nom d'usage de l'allocataire ou du conjoint.
Prénoms
ex: JEAN-PIERRE THOMAS
Prénoms de l'allocataire ou du conjoint.
Date de naissance
ex: 2000-01-20
Date de naissance de l'allocataire ou du conjoint au format AAAA-MM-JJ.
Sexe
ex: M
Sexe de l'allocataire ou du conjoint.
COG de la commune de naissance
ex: 75113
Code officiel géographique (COG) de la commune de naissance
Données d'identité des enfants
Liste des données d'identité des enfants composant la famille, le cas échéant. La provenance de ces données n'est pas sourcée précisément et diffère selon la CAF ou la MSA.
Cette propriété contient 1 ou plusieurs éléments ayant les spécifications suivantes :
Nom de naissance
ex: DUPONT
Nom de naissance de l'enfant.
Nom d'usage
Nom d'usage de l'enfant.
Prénoms
ex: JEAN-PIERRE THOMAS JUNIOR
Prénoms de l'enfant.
Date de naissance
ex: 2000-01-20
Date de naissance de l'enfant au format AAAA-MM-JJ.
Sexe
ex: M
Sexe de l'enfant.
COG de la commune de naissance
ex: 75113
Code officiel géographique (COG) de la commune de naissance
Adresse de la famille
Adresse de la famille au format de La Poste. Cette adresse est déclarative. Si l'usager a changé d'adresse et n'a pas actualisé son adresse auprès de la CAF ou de la MSA, l'information sera donc obsolète.
Destinataire
ex: Monsieur JEAN JACQUES
Civilité, titre ou qualité, nom et prénom du destinataire.
Complément d'information du destinataire ou point de remise
Complément d'information du point géographique
Voie
ex: 1 RUE DE LA GARE
Numéro et libellé de la voie.
Lieu-dit
Lieu-dit ou service particulier de distribution : poste restante, boîte postale.
Code postal
ex: 75002
Code postal et localité de destination.
Pays
ex: FRANCE
Paramètre pris en compte pour le calcul du tarif
Liste des paramètres pris en compte lors du calcul tarifaire de l'allocation
Nombre d'enfants à charge
ex: 2
Nombre d'enfants à charge des allocataires
Nombre d'enfants beneficiaire de l'AEEH
ex: 3
Nombre d'enfants beneficiaire de l'AEEH
Ressource annuelles
Ressource annuelles déclarée par les allocataires
Valeur
ex: 40923
Montant des ressources annuelles
Année du calcul des ressources
ex: 2023
Année lors de laquelle le calcul du quotient familial demandé a été effectué. Cette année peut différer de l'année effective du quotient familial.
Pour la CAF, le quotient familial est recalculé uniquement si de nouvelles informations sont venues rectifier la situation de l'allocataire.
Pour la MSA, le quotient familial est systématiquement recalculé ; l'année correspond donc toujours à l'année courante.

Questions & réponses

La prestation de service unique est une aide au fonctionnement versée par les Caf aux gestionnaires d’établissements visés par l’article R.2324-17 du code de la santé publique et bénéficiant d’une autorisation d’ouverture délivrée par l’autorité compétente soit :

  • les établissements d’accueil collectif (crèches, haltes-garderies, multi-accueils, micro-crèches (excepté les micro-crèches Cmg Paje) ;
  • les services d’accueils familiaux (crèches familiales) ;
  • les établissements à gestion parentale ;
  • les jardins d’enfants.

Elle correspond à la prise en charge de 66 % du prix de revient horaire d’un établissement d’accueil du jeune enfant (eaje), dans la limite du prix plafond fixé par la CNAF et la MSA, déduction faite des participations familiales.

Pour en savoir plus sur la PSU et les règles d’attribution de cette aide aux établissements d’accueil du jeune enfant

Conditions d'utilisation des données

Ouverture de la donnée :

Donnée protégée

Conditions générales :

Cette API et l’utilisation de ses données est soumise aux CGU générales d’API Particulier, 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 Particulier

Spécifications de l'API

Format de l'information

Donnée structurée JSON

Modalités d'appel

  • Identité pivot
  • FranceConnect Pictogramme fournisseurs de données regroupés
Détails des modalités

Disponibilité

Page de statut des API
Disponible 24h/24 et 7j/7

Spécifications techniques :

Consulter le swagger Cas de tests