L’API ANEF est un canal technique du portail Administration Numérique pour les Étrangers en France. Quand un navigateur charge la page de suivi d’un dossier de naturalisation, il interroge en arrière-plan une interface de programmation (API) qui renvoie des données brutes au format JSON. Ces données sont plus détaillées que le résumé affiché à l’écran. Comprendre où se situe cette API dans le parcours global de naturalisation permet de mieux interpréter chaque statut et d’anticiper les étapes restantes.
Prérequis ANEF avant le dépôt de dossier de naturalisation
La plupart des guides en ligne se concentrent sur le décodage des statuts API une fois le dossier déposé. Le parcours commence bien avant cette étape. Depuis la structuration du portail ANEF, le dépôt en ligne n’est accessible qu’après avoir satisfait plusieurs conditions préalables, directement intégrées dans l’architecture de la plateforme.
Le parcours type imposé par ANEF suit un enchaînement précis :
- Constitution des pièces d’état civil et de séjour (acte de naissance, titre de séjour en cours de validité, justificatifs de domicile et de ressources).
- Passage de l’examen civique, qui porte sur les valeurs et principes de la République française.
- Justification du niveau B2 en français (oral et écrit), par un diplôme ou une attestation reconnue.
- Paiement du timbre fiscal dématérialisé, dont le montant est vérifié par le système avant validation du dépôt.
Tant que ces prérequis ne sont pas remplis, la plateforme ANEF bloque l’accès au formulaire de dépôt. Ce verrouillage en amont réduit le nombre de dossiers irrecevables et accélère le traitement pour les candidats dont le dossier est complet. La recevabilité est donc partiellement automatisée avant même qu’un agent n’intervienne.
API ANEF et données techniques du dossier : ce que l’écran ne montre pas
Le tableau de bord ANEF visible après connexion affiche un résumé simplifié, souvent limité à des mentions comme « Traitement en cours » ou « En attente d’instruction ». L’API, elle, renvoie un objet JSON contenant plusieurs champs exploitables.
Structure d’une réponse API type
En accédant à l’URL de l’API statut (accessible depuis un navigateur connecté au compte ANEF), le demandeur obtient un objet contenant notamment le champ dossier_state, un identifiant numérique de dossier, une date de création et, le cas échéant, une date de consommation du timbre fiscal. Le champ dossier_state est la donnée la plus utile : il affiche un code interne qui correspond à l’étape réelle du traitement.
Statuts internes et progression du dossier
Les statuts renvoyés par l’API suivent la logique de traitement administratif. On retrouve des codes comme VERIFICATION_FORMELLE (contrôle initial des pièces), CONTROLE_A_EFFECTUER (phase d’instruction active), ou encore INSEREEDANSDECRET (le dossier a été intégré dans un décret de naturalisation). Certains statuts intermédiaires, comme CAA (Contrôle Approfondi à Accomplir) ou CAE (Contrôle Approfondi Effectué), n’apparaissent jamais sur l’interface graphique mais sont visibles dans la réponse API.
La présence d’un champ decret.id dans la réponse indique que le dossier a été rattaché à un décret précis. Ce numéro permet ensuite de retrouver la publication au Journal Officiel, étape finale de la procédure.
Parcours complet de naturalisation : où l’API intervient à chaque étape
Replacer l’API dans la chronologie complète du parcours aide à comprendre ce que chaque statut signifie concrètement pour le demandeur.
Phase de recevabilité. Après le dépôt sur ANEF, l’API affiche d’abord un statut de vérification formelle. Le système (puis un agent) vérifie la complétude du dossier. Si une pièce manque, le statut reste bloqué à cette étape. Le demandeur reçoit une notification par email, mais l’API reflète le blocage plus rapidement que la frise visuelle.
Phase d’instruction par la préfecture. Le dossier passe ensuite en instruction. L’API peut alors afficher des codes liés aux enquêtes administratives (consultation des fichiers, vérification de l’insertion professionnelle, contrôle du casier judiciaire). Cette phase est la plus longue et la moins transparente sur l’interface classique. L’API permet de distinguer un dossier en attente d’enquête d’un dossier dont l’enquête est terminée.
La proposition préfectorale (favorable ou défavorable) génère un nouveau statut API. En cas d’avis défavorable, le demandeur peut exercer un recours administratif préalable obligatoire (RAPO), ce qui modifie à nouveau le statut dans l’API.
Phase de décret et publication. Quand le dossier reçoit un avis favorable définitif, il est intégré dans un décret signé par le Premier ministre. L’API affiche alors INSEREEDANSDECRET et un identifiant de décret. La dernière étape, la publication au Journal Officiel, officialise l’acquisition de la nationalité française. Le demandeur est ensuite convoqué pour la cérémonie d’accueil dans la citoyenneté.
Limites de l’API ANEF pour le suivi de naturalisation
L’API donne des informations plus granulaires que l’interface standard, mais elle a des limites concrètes qu’il faut garder en tête.
Un statut qui ne bouge pas pendant plusieurs semaines ne signifie pas un blocage. Certaines phases d’instruction (enquêtes de terrain, consultations interministérielles) ne génèrent aucun changement de code dans l’API tant qu’elles ne sont pas clôturées. L’absence de changement de statut n’est pas un signal négatif en soi.
L’API ne fournit aucun détail sur le contenu des échanges entre la préfecture et les services consultés. Le demandeur voit qu’une étape est en cours, mais pas la nature exacte du contrôle effectué. Il est donc inutile de contacter la préfecture pour demander des précisions sur un code API : les agents n’utilisent pas cette terminologie dans leurs échanges avec le public.
Les données renvoyées par l’API peuvent aussi présenter un léger décalage temporel avec le traitement réel. Une décision prise en fin de journée peut ne se refléter dans l’API que le lendemain ou après un délai de synchronisation interne.
Le parcours de naturalisation via ANEF reste un processus administratif long, dont la durée totale varie selon la préfecture et la complexité du dossier. L’API ANEF n’accélère rien, mais elle offre une lecture technique utile à chaque étape, du dépôt initial jusqu’à la publication du décret au Journal Officiel.
