Participation familiale EAJE Version beta
Participation familiale EAJE.
Cette API est en bêta test
Elle est en production et fonctionnelle, mais susceptible de changer en fonction des retours des utilisateurs et du fournisseur de données.
Vous serez bien entendu informé des changements en amont le cas échéant. N'hésitez pas à contacter le support si vous avez des questions.
CNAF & MSA
Allocataires MSA : donnée incohérente pour l'année du calcul des ressources
Pour les allocataires MSA, l’année indiquée par l’API pour les ressources est actuellement incorrecte. L’API retourne l’année en cours au lieu de l’année N-2.
- ✅ Le montant des ressources est correct : il correspond bien aux ressources de l’année N-2.
- ➡️ Il s’agit donc d’un problème d’affichage de l’année, sans impact sur le montant
- 🧑🦰 Cette anomalie ne concerne que les allocataires MSA.
Elle est en cours de correction par la 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.
Cas d'usages
Fiches pratiques et cas d'usages pour lesquels l'API est utile :
Spécifications de l'API
Format de l'information
Modalités d'appel
- Identité pivot
-
FranceConnect
Disponibilité
Limite d'appels
(partagé entre API du groupe)
Spécifications techniques :
Consulter le swagger Cas de tests (nouvelle fenêtre)Modalités d'appel
L’API est appelable avec l’identité de l’allocataire principal ou avec celle d’une personne composant son foyer (conjoint, enfants et autres ayants droit).
⚠️ Les enfants en garde partagée (résidence alternée) ne sont pas couverts : l’API ne peut pas être appelée avec leur identité.
Deux modalités d’appel sont possibles :
FranceConnect
Avec la modalité d’appel FranceConnect.
Identité pivot
- Nom de famille (nom de naissance)1, nom d'usage, prénoms3, sexe4, date de naissance de l'allocataire2, code COG du pays de naissance1 ;
- Commune de naissance (fortement recommandé) : peut être renseignée 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.
1 Obligatoire
2 Obligatoire pour l’option 2 du lieu de naissance.
3 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.
4 Fortement recommandé pour optimiser l’identification du particulier.
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 :
Pour la MSA, le quotient familial est systématiquement recalculé ; l'année correspond donc toujours à l'année courante.
Les scopes
Les champs de la réponse signalés par une étiquette violette ne sont retournés que si votre jeton porte le scope correspondant. En savoir plus sur le mécanisme des scopes.
-
Identités allocataires
(cnav_participation_familiale_eaje_allocataires) -
Identités enfants
(cnav_participation_familiale_eaje_enfants) -
Adresse du foyer
(cnav_participation_familiale_eaje_adresse) -
Paramètres de calcul
(cnav_participation_familiale_eaje_parametres_calcul)
Erreurs
Lorsque cette API ne peut pas retourner les informations demandées, elle renvoie un code erreur. Les erreurs communes à toutes les API (jeton, paramètres obligatoires, quotas) sont décrites dans la nomenclature des codes erreurs ; celles qui suivent sont celles que cet endpoint peut renvoyer, y compris les erreurs génériques de son fournisseur de données.
Cette liste est aussi servie au format JSON, sans jeton, sur https://particulier.api.gouv.fr/api/errors?operation_id=api_particulier_v3_cnav_participation_familiale_eaje_with_civility.
| Code | Signification |
|---|---|
00363 |
Entité non traitable
La date de naissance n'est pas correctement formatté |
00365 |
Entité non traitable
Le lieu de naissance n'est pas correctement formaté |
00367 |
Entité non traitable
Le ou les prénoms sont manquants. |
00400 |
Entité non traitable
Le code pays INSEE n'est pas correctement formaté |
00405 |
Entité non traitable
Le request_id n'est pas correctement formaté : l'en-tête X-Request-Id, s'il est fourni, doit être un UUID v4 |
00420 |
Entité non traitable
Le nom de naissance est manquant |
00422 |
Entité non traitable
L'annee de naissance est manquante |
00427 |
Entité non traitable
Le sexe de l'état civil est manquant |
00428 |
Entité non traitable
Le code cog du département de naissance est manquant ou invalide |
36560 |
Identité non reconnue par le fournisseur de données
Les paramètres d'identité fournis ne correspondent à aucune personne connue du fournisseur de données. |
36561 |
Paramètres de civilité refusés par le fournisseur de données
Un ou plusieurs paramètres de civilité ont été refusés par le fournisseur de données. |
| Code | Signification |
|---|---|
10003 |
Dossier allocataire absent MSA
Le dossier allocataire n'a pas été trouvé auprès de la MSA. |
23003 |
Dossier allocataire absent CNAF
Le dossier allocataire n'a pas été trouvé auprès de la CNAF. |
35003 |
Allocataire non référencé
L'allocataire n'est pas référencé auprès des caisses éligibles |
37003 |
Allocataire non éligible
Le dossier allocataire a été trouvé mais n'est pas éligible à la participation familiale EAJE |
40003 |
Dossier allocataire absent RNCPS
Le dossier allocataire n'a pas été trouvé auprès du RNCPS. |
| Code | Signification |
|---|---|
36000 |
Erreur interne du fournisseur de données
La réponse retournée par le fournisseur de données est invalide et a été identifié comme étant une erreur interne. Si le problème persiste, consultez la page de status ou contactez nous sur le support. |
36001 |
Service non disponible
Service du fournisseur de données temporairement indisponible ou en maintenance. |
36004 |
Erreur de résolution DNS
Problème de résolution DNS de l'adresse du serveur |
36008 |
Erreur auprès du fournisseur de données : trop de requêtes
Erreur de fournisseur de donnée : Trop de requêtes effectuées, veuillez réessayer plus tard. |
36009 |
Erreur de connexion sécurisée (TLS) avec le fournisseur de données
La connexion sécurisée avec le fournisseur de données n'a pas pu être établie : certificat invalide ou expiré, ou échec de la négociation TLS. L'équipe technique a été notifiée de cette erreur pour investigation. |
36011 |
Erreur temporaire du fournisseur de données
Merci de réessayer dans quelques instants |
36999 |
Erreur inconnue du fournisseur de données
La réponse retournée par le fournisseur de données est invalide et inconnue de notre service. L'équipe technique a été notifiée de cette erreur pour investigation. |
| Code | Signification |
|---|---|
36020 |
Maintenance du fournisseur de données
Le fournisseur de données semble être en maintenance |
| Code | Signification |
|---|---|
36002 |
Intermédiaire hors-délai
Temps d’attente d’une réponse du fournisseur de données écoulé. |
Modalité FranceConnect
En appelant cet endpoint avec un jeton FranceConnect, les erreurs suivantes s'ajoutent aux précédentes.
| Code | Signification |
|---|---|
51564 |
Identité inexploitable renvoyée par le fournisseur de données
L'identité renvoyée par le fournisseur de données est incomplète ou invalide. |
| Code | Signification |
|---|---|
51000 |
Erreur interne du fournisseur de données
La réponse retournée par le fournisseur de données est invalide et a été identifié comme étant une erreur interne. Si le problème persiste, consultez la page de status ou contactez nous sur le support. |
51001 |
Service non disponible
Service du fournisseur de données temporairement indisponible ou en maintenance. |
51004 |
Erreur de résolution DNS
Problème de résolution DNS de l'adresse du serveur |
51008 |
Erreur auprès du fournisseur de données : trop de requêtes
Erreur de fournisseur de donnée : Trop de requêtes effectuées, veuillez réessayer plus tard. |
51009 |
Erreur de connexion sécurisée (TLS) avec le fournisseur de données
La connexion sécurisée avec le fournisseur de données n'a pas pu être établie : certificat invalide ou expiré, ou échec de la négociation TLS. L'équipe technique a été notifiée de cette erreur pour investigation. |
51011 |
Erreur temporaire du fournisseur de données
Merci de réessayer dans quelques instants |
51999 |
Erreur inconnue du fournisseur de données
La réponse retournée par le fournisseur de données est invalide et inconnue de notre service. L'équipe technique a été notifiée de cette erreur pour investigation. |
| Code | Signification |
|---|---|
51501 |
Accès non autorisé
Le jeton d'accès est mal formaté. |
51502 |
Accès non autorisé
Le jeton d'accès n'a pas été trouvé ou est expiré. |
51504 |
Accès non autorisé
Le jeton d'accès FranceConnect est manquant. Cet endpoint requiert un jeton d'accès FranceConnect transmis via l'en-tête Authorization: Bearer. |
| Code | Signification |
|---|---|
51020 |
Maintenance du fournisseur de données
Le fournisseur de données semble être en maintenance |
| Code | Signification |
|---|---|
51002 |
Intermédiaire hors-délai
Temps d’attente d’une réponse du fournisseur de données écoulé. |
Questions & réponses
Historique
29/07/2026 — Preuve d’attestation vérifiable
Ajout de l’en-tête X-Generate-Proof sur /v3/dss/participation_familiale_eaje/identite : lien et code de vérification dans meta, lien de téléchargement de l’attestation PDF dans links. En savoir plus.
Conditions d'utilisation des données
Ouverture de la donnée :
Conditions générales :
Cette API et l'utilisation de ses données sont soumises 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 ParticulierCas d'usages
Fiches pratiques et cas d'usages pour lesquels l'API est utile :
Spécifications de l'API
Format de l'information
Modalités d'appel
- Identité pivot
-
FranceConnect
Disponibilité
Limite d'appels
(partagé entre API du groupe)