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.

Logo de CNAF & MSA
Fournisseur de la donnée

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

Donnée structurée JSON

Modalités d'appel

  • Identité pivot
  • FranceConnect
Détails des modalités

Disponibilité

Loading...
Page de statut des API (nouvelle fenêtre)
Disponible 24h/24 et 7j/7

Limite d'appels

20 requêtes / seconde
(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 :

Cette API est FranceConnectée 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 :

Données d'identité de l'allocataire et du conjoint
cnav_participation_familiale_eaje_allocataires
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. Ce champ peut être null, notamment pour les co-allocataires (il n'est généralement renvoyé que pour l'allocataire principal demandé).
Données d'identité des enfants
cnav_participation_familiale_eaje_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
Code officiel géographique (COG) de la commune de naissance. Ce champ peut être null pour les enfants (il n'est généralement renvoyé que pour l'allocataire principal demandé).
Adresse de la famille
cnav_participation_familiale_eaje_adresse
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
cnav_participation_familiale_eaje_parametres_calcul
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.

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.

422 — Entité non traitable
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.
404 — Non trouvé
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.
502 — Erreur du fournisseur de données
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.
503 — Service non disponible
Code Signification
36020 Maintenance du fournisseur de données
Le fournisseur de données semble être en maintenance
504 — Intermédiaire hors délai
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.

422 — Entité non traitable
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.
502 — Erreur du fournisseur de données
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.
401 — Non autorisé
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.
503 — Service non disponible
Code Signification
51020 Maintenance du fournisseur de données
Le fournisseur de données semble être en maintenance
504 — Intermédiaire hors délai
Code Signification
51002 Intermédiaire hors-délai
Temps d’attente d’une réponse du fournisseur de données écoulé.

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

L’algorithme d’identification du fournisseur de données s’appuie sur l’ensemble des paramètres d’entrée, mais certains ont un poids plus important :

  • Nom de naissance ;
  • Année de naissance ;
  • Lieu de naissance.

Si ces trois informations sont correctement fournies, le particulier peut être identifié même si les autres paramètres comportent des erreurs. En revanche, si ces informations ne sont pas renseignées ou sont erronées, le risque de recevoir une réponse 404 (dossier allocataire absent) augmente significativement.

Il est donc fortement recommandé de renseigner le lieu de naissance afin de maximiser les chances d’identification du particulier.

Lorsque l’API est appelée avec l’identité pivot, le lieu de naissance est fortement recommandé pour identifier correctement le particulier.

  • Pour les particuliers nés en France: le code COG pays 99100 doit être renseigné. La commune de naissance peut être renseignée via deux options différentes :

  • Pour les particuliers nés à l’étranger: le code COG pays doit être renseigné.

Le code COG du pays de naissance est obligatoire pour tous les appels. Pour simplifier le parcours des usagers, évitez de demander aux particuliers nés en France de saisir leur pays de naissance, puisque vous pouvez le paramétrer directement -code COG pays France 99100-, dès qu’un particulier renseigne les informations de sa commune de naissance (forcément en France).

En ajoutant l’en-tête X-Generate-Proof à l’appel /v3/dss/participation_familiale_eaje/identite (mêmes paramètres et habilitations, le bloc data reste identique), la réponse s’enrichit d’une preuve d’attestation, destinée notamment aux contrôles CNAF des gestionnaires d’EAJE :

  • X-Generate-Proof: proof-only — meta contient le lien public de vérification (verification_url) et un code de vérification de 10 caractères (verification_code), propres à chaque émission. Archiver ce lien et ce code dans votre dossier métier suffit comme justificatif.
  • X-Generate-Proof: pdf — s’y ajoute dans links un lien de téléchargement de l’attestation PDF (attestation_pdf), accessible sans authentification et re-téléchargeable jusqu’à son expiration (environ 5 minutes, horodatage meta.attestation_pdf_url_expires_at). Passé ce délai, le lien renvoie 410 Gone : relancez simplement l’appel pour en obtenir un nouveau.

L’attestation PDF reprend l’ensemble des données délivrées et porte le code de vérification ainsi qu’un QR code (également cliquable) menant à la page publique de vérification hébergée par API Particulier. Cette page n’affiche que des données minimisées — identités tronquées, sans adresse, nombre d’enfants, paramètres de calcul complets. L’authenticité se vérifie en comparant le code et les données des deux documents.

Le lien de vérification reste valable 5 ans après l’émission. Aucune donnée n’est accessible sans le document : le lien chiffré est l’unique clé d’accès.

Le jeu de champs de l’attestation est figé pour une version d’API donnée. Ajouter, retirer ou renommer un champ du PDF passe systématiquement par une nouvelle route et une montée de version : le contenu d’une attestation déjà publiée n’évolue jamais en place. Vous pouvez donc traiter le jeu de champs comme un contrat stable pour toute la durée de vie de la version. En revanche, la disposition visuelle des champs peut évoluer sans montée de version.

C’est une exigence documentaire, pas technique : l’attestation est une pièce justificative, deux documents portant la même version d’API ne peuvent pas présenter des jeux de champs différents — ni pour vous, ni pour la CNAF, ni pour l’agent qui contrôle le document.

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 :

Donnée protégé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 Particulier

Cas d'usages

Fiches pratiques et cas d'usages pour lesquels l'API est utile :

Spécifications de l'API

Format de l'information

Donnée structurée JSON

Modalités d'appel

  • Identité pivot
  • FranceConnect
Détails des modalités

Disponibilité

Loading...
Page de statut des API (nouvelle fenêtre)
Disponible 24h/24 et 7j/7

Limite d'appels

20 requêtes / seconde
(partagé entre API du groupe)

Spécifications techniques :

Consulter le swagger Cas de tests (nouvelle fenêtre)