Statut allocation d'éducation de l'enfant handicapé (AEEH)
Statut bénéficiaire de l'allocation d'éducation de l'enfant handicapé (AEEH).
CNAF & MSA
Périmètre
Particuliers concernés :
L’API couvre l’ensemble des foyers bénéficiaires de l’allocation d’éducation de l’enfant handicapé (AEEH) :
- ✅ le régime agricole (MSA) ;
- ✅ le régime général (CAF) ;
- ✅ 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
- ✅ Saint-Barthélémy
- ✅ Allocataires de nationalité étrangère résidant en France, dont ceux disposant d’un numéro d’immatriculation en attente (NIA)
Actualisation de la donnée :
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 données sont mises à jour :
- en temps réel pour les allocataires CAF et MSA : toute nouvelle décision AEEH enregistrée dans le système d’information est disponible immédiatement dans l’API.
Spécifications de l'API
Format de l'information
Modalités d'appel
- Identité pivot
-
FranceConnect
Disponibilité
Spécifications techniques :
Consulter le swagger Cas de testsModalités d'appel
Deux modalités d’appel, à partir des informations de l’allocataire ou de l’ouvrant-droit, sont possibles :
FranceConnect
Avec la modalité d’appel FranceConnect*.
*La modalité d’appel FranceConnect n’est utilisable qu’à partir de 16 ans pour un ouvrant-droit.
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.
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*.
-
Si le lieu de naissance est en France, la commune de naissance est obligatoire, elle peut être saisie de deux façons différentes :
* 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 à partir de l’identité d’un allocataire ou d’un ouvrant-droit :
- le statut AEEH du particulier, à savoir s’il est allocataire, ouvrant-droit ou non bénéficiaire ;
- le détail des prestations AEEH versées à l’assuré :
- la date d’ouverture du droit ;
- l’organisme de rattachement.
Informations renvoyées en JSON :
- Si le statut est 'allocataire', cela signifie que le particulier est l'allocataire de l'AEEH (qualité bénéficiaire 105). Cela concerne généralement le parent ou le tuteur légal de l'enfant handicapé.
- Si le statut est 'ouvrant_droit', cela signifie que le particulier est ouvrant droit de l'AEEH (qualité bénéficiaire 205). Cela concerne généralement l'enfant handicapé lui-même.
- Si le statut est 'non_beneficiaire', cela signifie que le particulier n'est pas concerné par l'AEEH.
Ce champs est null dans le cas où le particulier n'est pas bénéficiaire de l'AEEH.
Questions & réponses
Conditions d'utilisation des données
Ouverture de la donné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.
CGU API Particulier
Spécifications de l'API
Format de l'information
Modalités d'appel
- Identité pivot
-
FranceConnect