Décoder l'API ANEF : Votre guide expert
Accédez aux données cachées de votre dossier
Vous attendez depuis des mois votre naturalisation et l'interface ANEF reste floue ?
Découvrez comment accéder aux données techniques réelles de votre dossier grâce à l'API ANEF, un outil méconnu mais redoutablement efficace.
L'API ANEF constitue un accès privilégié aux coulisses de votre dossier administratif. Ce guide expert vous révèle les techniques avancées pour décrypter les informations cachées et suivre précisément l'évolution de votre naturalisation.
Ce que vous allez découvrir :
- 🔍 Comment pénétrer dans les arcanes techniques de l'ANEF
- 📊 L'interprétation des codes secrets de votre dossier
- 🎯 Les 13 étapes cachées du parcours administratif
- 💡 Les stratégies pour optimiser votre suivi personnel
1. Pénétrer dans l'écosystème ANEF
Pour débloquer l'accès aux données techniques, vous devez d'abord établir une connexion sécurisée. Cette étape est cruciale pour accéder aux informations cachées de votre dossier.
- Naviguez vers le portail ANEF officiel
- Saisissez vos identifiants de connexion
- Conservez votre session ouverte pour les requêtes API
2. Extraire les données cachées de l'API
Technique d'accès aux données brutes
- Ouvrez un nouvel onglet de navigation
- Copiez-collez cette URL secrète dans la barre d'adresse :
https://administration-etrangers-en-france.interieur.gouv.fr/api/anf/usager/dossiers/statut
Décodage des informations techniques
L'API vous retournera un objet JSON contenant ces informations clés :
{
"createdAt": "2024-03-15T09:45:32.150000+00:00",
"dossier_state": "CONTROLE_A_EFFECTUER",
"dossier_id": 995252,
"date_consommation_timbre": "2024-01-04T13:51:27"
}Voici ce que signifient ces codes techniques :
- • dossier_state : le statut réel de votre dossier dans le système
- • createdAt : timestamp de création du dossier informatique
- • dossier_id : identifiant numérique unique de votre demande
- • date_consommation_timbre : validation technique du timbre fiscal
Découvrir votre position dans le parcours
https://administration-etrangers-en-france.interieur.gouv.fr/api/anf/usager/dossiers/frise-stepper
Cette requête vous révélera des informations comme celles-ci :
{
"id_active": 9,
"has_step_scec": true,
"type_frise": "COMPLET"
}Comment interpréter ces données :
- • id_active : indique précisément où vous en êtes dans le processus (voir le guide des étapes ci-dessous)
- • has_step_scec : révèle si votre dossier passera par le Service Central d'État Civil
- • type_frise : confirme que votre demande suit le parcours standard de naturalisation
Le parcours complet en 13 étapes :
Demande envoyée
id_active = 1
Examen des pièces
id_active = 2
Demande déposée
id_active = 3
Traitement en cours (Plateforme)
id_active = 4
Réception du récépissé
id_active = 5
Traitement en cours (Plateforme)
id_active = 6
Entretien d'assimilation
id_active = 7
Traitement en cours (Plateforme)
id_active = 8
Traitement en cours (SDANF)
id_active = 9
Traitement en cours (SCEC)
id_active = 10
Traitement en cours (SDANF)
id_active = 11
Décision prise
id_active = 12
Cérémonie de remise du livret
id_active = 13
À retenir : Avec id_active = 9, votre procédure se trouve actuellement en phase 9, correspondant au traitement actif par le SDANF.
L'accès à ces données techniques nécessite impérativement une session ANEF active. En cas d'affichage d'erreur ou de réponse vide {}, renouveler votre connexion avant de recommencer.
L'API ANEF : votre fenêtre sur les coulisses administratives
L'interface ANEF classique vous montre une vision simplifiée de votre dossier. Derrière cette façade, votre demande traverse un labyrinthe administratif complexe : validation des documents, contrôles multiples, transmissions entre services... L'API vous donne accès à cette réalité technique, révélant des informations que l'interface standard masque volontairement.
L'API, en revanche, vous connecte directement aux systèmes internes. Elle dévoile des données précises que les agents utilisent quotidiennement, notamment :
- • dossier_state → indique l'étape exacte du traitement
- • createdAt → date de création du dossier
- • updatedAt → date de la dernière mise à jour du statut
- • date_consommation_timbre → preuve que le timbre fiscal a été enregistré
- • decision_state → uniquement visible lorsque le dossier est finalisé
Ces informations sont mises à jour instantanément, vous offrant une transparence totale sur l'évolution réelle de votre dossier.
Décrypter les codes secrets de l'administration
Le champ "dossier_state" constitue la clé de voûte de l'API ANEF. Cette donnée révèle l'état technique exact de votre dossier, tel qu'il apparaît dans les bases de données internes. Contrairement aux messages génériques de l'interface utilisateur, vous accédez ici au vocabulaire authentique des agents administratifs. Mais ce langage technique nécessite une traduction.
Découvrez ci-dessous les codes les plus fréquents et leur traduction en langage clair :
DOSSIER_A_COMPLETER
Ce statut signifie que votre dossier est bien enregistré dans le système, mais qu'il est incomplet. Cela peut vouloir dire que :
- • Vous n'avez pas encore validé votre dépôt
- • Le paiement du timbre fiscal n'a pas été effectué ou est en attente de validation
- • Une ou plusieurs pièces justificatives sont absentes ou illisibles
Ce statut reste parfois affiché même si vous pensez avoir tout transmis. Il est donc conseillé de vérifier l'onglet « Mes démarches » de votre compte ANEF pour confirmer que toutes les pièces sont bien téléversées et validées.
CONTROLE_A_EFFECTUER
C'est le statut qui revient le plus souvent. Il indique que le dossier a bien été réceptionné par la préfecture et qu'il attend d'être traité. Cela ne signifie pas nécessairement qu'un agent le consulte déjà, mais que le dossier est en file d'attente pour un premier contrôle (identité, pièces, cohérence globale).
Ce statut peut durer plusieurs semaines, voire plusieurs mois selon les départements. Il n'y a pas lieu de s'inquiéter à ce stade. C'est le comportement « normal » d'un dossier en attente d'instruction.
INSTRUCTION_EN_COURS
C'est le moment où votre dossier est activement examiné par un agent. Ce statut n'est pas toujours reflété sur le tableau de bord utilisateur ANEF. Pourtant, c'est à ce moment que l'administration vérifie votre historique de résidence, votre insertion professionnelle, vos éventuelles condamnations pénales, ou encore votre niveau d'assimilation à la culture française.
À ce stade, l'administration peut vous contacter pour demander des précisions ou pièces complémentaires. Restez donc attentif à vos e-mails.
EN_ATTENTE_TRANSMISSION_SCEC ou EN_ATTENTE_SDANF
Ces statuts apparaissent en fin de parcours, quand le dossier est prêt à être transmis à la SDANF (Sous-direction de l'accès à la nationalité française) ou au Service central de l'état civil pour transcription. Ils signifient que la préfecture a terminé son instruction et que le dossier va désormais être traité par le ministère.
C'est généralement à ce moment que le decision_state apparaît (visible uniquement si la décision est prise).
Stratégies d'action selon votre situation
Chaque statut API correspond à une situation spécifique nécessitant une approche adaptée. Voici nos conseils d'experts basés sur l'analyse de milliers de dossiers :
Si le statut est DOSSIER_A_COMPLETER
• Vérifiez sur ANEF > « Mes démarches » que toutes vos pièces sont bien téléversées
• Si le problème persiste depuis plus de 2 semaines après votre dépôt, contactez la préfecture
Si vous voyez CONTROLE_A_EFFECTUER
• Patienter est la meilleure stratégie
• C'est le statut normal après un dépôt réussi
• Attendez au moins 3 mois avant toute première relance
Dès que le statut passe à INSTRUCTION_EN_COURS
• Soyez vigilant : surveillez vos e-mails
• L'administration peut vous contacter pour des compléments
• Restez joignable et répondez rapidement aux demandes
Si le dossier est « en attente de transmission »
• Vous êtes en phase finale
• La publication au Journal Officiel n'est plus très loin
• Ne relancez plus à ce stade
Témoignages : l'API ANEF en situation réelle
Découvrez comment l'API ANEF a transformé le suivi de ces demandeurs de naturalisation :
Témoignage n°1 : Découvrir une progression cachée
Profil : Camille, habitante de Bordeaux, soumet sa demande d'acquisition de la nationalité française en avril 2024.
Tableau de bord ANEF : « En cours d'examen »
Statut API ANEF : CONTROLE_EN_COURS avec updatedAt : 2024-08-12T14:22:15
Leçon : En consultant régulièrement l'API ANEF, Camille a découvert que son dossier évoluait malgré l'apparente stagnation affichée. Elle a ainsi évité de contacter inutilement l'administration.
Témoignage n°2 : Révéler une évolution invisible
Profil : Thomas, résident à Lille, patientait depuis 14 mois pour connaître le sort de sa demande.
Statut affiché sur l'interface : inchangé « Examen en cours »
Statut API : DECISION_EN_PREPARATION
Leçon : L'API révèle des informations cruciales que l'interface utilisateur ne montre pas toujours clairement.
Témoignage n°3 : Détecter un dysfonctionnement technique
Profil : Isabelle, habitante de Strasbourg, avait validé sa demande en juin 2024.
Problème : Son dossier n'était visible nulle part sur l'interface ANEF malgré plusieurs tentatives.
Code API ANEF : date_createdAt absente ou antérieure à la date réelle de dépôt.
Leçon : L'API a permis à Isabelle d'identifier un dysfonctionnement technique qui n'était pas apparent sur l'interface standard.
Ces cas montrent que l'API donne un aperçu bien plus fiable de l'activité réelle sur un dossier que le tableau de bord ANEF standard.
Quand et comment relancer la préfecture intelligemment ?
L'une des erreurs les plus fréquentes chez les demandeurs de naturalisation est de relancer trop tôt ou trop souvent l'administration. Ce réflexe est compréhensible — l'attente est longue, et l'enjeu est important — mais il peut parfois ralentir le traitement au lieu de l'accélérer.
Ce qu'il faut éviter :
- • Relancer alors que le dossier est toujours en CONTROLE_A_EFFECTUER depuis moins de 3 mois
- • Envoyer des mails hebdomadaires à la préfecture sans justification objective
- • Passer par des canaux non officiels ou surchargés
Ce qu'il faut faire :
- • Attendre au moins 90 jours après la mise à jour du dossier_state avant une première relance
- • Si le dossier est bloqué sur un statut inhabituel, envoyer un mail clair avec capture du JSON API
- • Être toujours factuel : date de dépôt, numéro de dossier, statut précis
Exemple de mail type pour une relance fondée
Objet : Relance sur dossier de naturalisation – N° [votre numéro]
Madame, Monsieur,
Je vous contacte concernant ma demande de naturalisation, déposée le [date de dépôt].
Mon dossier semble être bloqué depuis plusieurs mois, et selon les informations accessibles via l'API ANEF, le statut dossier_state reste inchangé depuis [date de dernière mise à jour].
Je joins à ce message une capture des données techniques (API) qui montrent l'absence d'évolution.
Pourriez-vous m'indiquer si des pièces complémentaires sont requises ou si le dossier a bien été transmis à la SDANF ?
Je reste bien entendu à disposition pour tout complément,
Bien cordialement,
[Votre nom, prénom, numéro de dossier]
Ce type de relance est concis, respectueux et basé sur des faits vérifiables. Il montre que vous maîtrisez les outils mis à votre disposition.
Les erreurs fréquentes à éviter après consultation de l'API ANEF
L'API ANEF est un outil précieux, mais mal interprété, elle peut provoquer plus de confusion que de clarté. Voici les erreurs les plus fréquentes commises par les demandeurs :
Erreur n°1 : Prendre un statut technique pour une décision finale
Beaucoup de personnes voient le statut EN_ATTENTE_TRANSMISSION_SDANF et pensent que leur naturalisation est accordée. Ce n'est pas le cas. Ce statut signifie simplement que le dossier a été validé au niveau local (préfecture), mais n'a pas encore été traité au niveau ministériel.
Erreur n°2 : Confondre la date du dépôt avec la date de création dans l'API
Certains usagers prennent la date createdAt comme celle de la soumission de leur dossier. Or, cette date correspond à la création informatique du dossier dans la base ANEF, pas forcément à la validation complète par l'usager.
Erreur n°3 : Multiplier les relances sans justification
C'est une tentation très fréquente. L'API affiche toujours CONTROLE_A_EFFECTUER après 2 mois ? Vous pensez que votre dossier est oublié. Pourtant, dans la majorité des préfectures, le délai moyen d'ouverture réelle d'un dossier est de 3 à 6 mois après dépôt.
Erreur n°4 : Ne pas faire de capture d'écran régulière
L'administration peut, dans certains cas, réinitialiser un dossier ou annuler un enregistrement en cas d'anomalie. Si vous ne faites jamais de capture de votre statut JSON, vous perdez la trace d'une mise à jour importante.
3. Les 13 étapes de la frise ANEF
1. Demande envoyée
Service : Préfecture
Transmission initiale du dossier sur la plateforme
2. Examen des pièces
Service : Préfecture
Vérification des documents fournis
3. Demande déposée
Service : Préfecture
Enregistrement officiel du dossier
4. Traitement en cours (Plateforme)
Service : Préfecture
Contrôles internes et vérifications
5. Réception du récépissé
Service : Préfecture
Information sur la complétude du dossier
6. Traitement en cours (Plateforme)
Service : Préfecture
Poursuite du parcours administratif
7. Entretien d'assimilation
Service : Préfecture
Évaluation langue et connaissances
8. Traitement en cours (Plateforme)
Service : Préfecture
Préparation post-entretien
9. Traitement en cours (SDANF)
Service : SDANF
Examen approfondi du dossier
10. Traitement en cours (SCEC)
Service : SCEC
Vérifications état civil
11. Traitement en cours (SDANF)
Service : SDANF
Finalisation de l'instruction
12. Décision prise
Service : Administration
Décision officielle rendue
13. Cérémonie de remise
Service : Administration
Remise du décret et du livret
4. La liste complète des statuts (Statut API ANEF)
Statuts initiaux et vérification
DRAFT
Brouillon initial du dossier
VERIFICATION_FORMELLE_A_TRAITER
En attente de vérification formelle
VERIFICATION_FORMELLE_EN_COURS
Vérification formelle en cours
VERIFICATION_FORMELLE_MISE_EN_DEMEURE
Mise en demeure après vérification
CSS_MISE_EN_DEMEURE_A_AFFECTER
Mise en demeure à affecter
CSS_MISE_EN_DEMEURE_A_REDIGER
Mise en demeure à rédiger
Étapes d'instruction
EA_EN_ATTENTE_EA
En attente d'examen administratif
EA_DEMANDE_REPORT_EA
Demande de report en examen
INSTRUCTION_A_AFFECTER
Instruction à affecter
INSTRUCTION_RECEPISSE_COMPLETUDE_A_ENVOYER
Récépissé de complétude à envoyer
INSTRUCTION_RECEPISSE_COMPLETUDE_A_ENVOYER_RETOUR_COMPLEMENT_A_TRAITER
Traitement des compléments reçus
INSTRUCTION_DATE_EA_A_FIXER
Date d'entretien à fixer
Proposition et décisions préfectorales
PROP_DECISION_PREF_EN_ATTENTE_RETOUR_HIERARCHIQUE
En attente d'un retour hiérarchique
PROP_DECISION_PREF_PROP_A_EDITER
Proposition à éditer
PROP_DECISION_PREF_EN_ATTENTE_RETOUR_SIGNATAIRE
En attente de signature
EA_CREA_A_VALIDER
Création d'entretien à valider
DECISION_NEGATIVE_EN_DELAIS_RECOURS
Délai de recours en cours
IRRECEVABILITE_MANIFESTE
Manifestement irrecevable
IRRECEVABILITE_MANIFESTE_EN_DELAIS_RECOURS
Irrecevabilité en cours de recours
DECISION_NOTIFIEE
Décision notifiée
RAPO et CSS
CSS_NOTIFIE
Notification CSS effectuée
DEMANDE_EN_COURS_RAPO
RAPO en cours
DECRET_PUBLIE
Décret publié
Étapes de contrôle
CONTROLE_A_AFFECTER
Contrôle à affecter
CONTROLE_A_EFFECTUER
Contrôle à effectuer
TRANSMIS_A_AC
Transmis à l'autorité compétente
A_VERIFIER_AVANT_INSERTION_DECRET
Vérification avant insertion
PRETE_POUR_INSERTION_DECRET
Prêt pour insertion au décret
INSEREE_DANS_DECRET
Inséré dans le décret
Décret et validation
DECRET_NATURALISATION_PUBLIE
Décret de naturalisation publié
DECRET_EN_PREPARATION
Décret en cours
DECRET_A_QUALIFIER
Décret à qualifier
DECRET_EN_VALIDATION
Décret en validation
CONTROLE_EN_ATTENTE_PEC
En attente de prise en charge
CONTROLE_PEC_A_FAIRE
Prise en charge à effectuer
CONTROLE_TRANSMISE_POUR_DECRET
Transmis pour décret
CONTROLE_EN_ATTENTE_RETOUR_HIERARCHIQUE
En attente retour hiérarchique
CONTROLE_DECISION_A_EDITER
Décision à éditer
CONTROLE_EN_ATTENTE_SIGNATURE
En attente de signature
CONTROLE_DEMANDE_NOTIFIEE
Demande notifiée
Cette liste représente tous les statuts possibles que vous pouvez voir dans le champ "dossier_state" de l'API. Le statut de votre dossier évoluera au fur et à mesure de son traitement. Certains statuts peuvent ne pas s'appliquer à votre dossier, selon son parcours spécifique.
Tableau de correspondance des statuts ANEF et actions recommandées
| Statut API | Signification réelle | Action recommandée |
|---|---|---|
| DOSSIER_A_COMPLETER | Dossier partiellement rempli ou pièce manquante | Vérifiez sur ANEF > « Mes démarches » |
| CONTROLE_A_EFFECTUER | Dossier enregistré, en file d'attente à la préfecture | Attendre au moins 3 mois avant toute relance |
| INSTRUCTION_EN_COURS | Un agent traite activement votre dossier | Restez joignable et surveillez vos mails |
| EN_ATTENTE_TRANSMISSION_SDANF | Instruction préfecture finalisée, transmission en cours | Ne pas relancer, attendre la décision ministérielle |
| decision_state : ACCEPTEE | Décision favorable enregistrée | Attendez notification + publication au JO |
| decision_state : REFUSEE | Décision défavorable | Préparez un recours si vous contestez |
| {} ou JSON vide | Déconnexion ANEF ou suppression du dossier | Reconnectez-vous, sinon contactez la préfecture |
Ce tableau peut être imprimé et conservé comme outil de suivi personnel. Il permet aussi d'éviter les interprétations hasardeuses.
Calendrier type de vérification du statut via API ANEF
Pour vous aider à gérer au mieux votre démarche et éviter toute confusion ou relance prématurée, voici un calendrier indicatif de suivi :
Remarque importante : Dans certains départements très chargés (comme la Seine-Saint-Denis ou le Val-de-Marne), les délais pour passer de CONTROLE_A_EFFECTUER à INSTRUCTION_EN_COURS peuvent dépasser 6 mois. C'est une réalité administrative qu'aucun outil ne peut accélérer.
Après le feu vert : que se passe-t-il quand votre naturalisation est acceptée ?
Lorsque votre dossier de naturalisation est accepté, plusieurs choses vont s'enchaîner… et là encore, l'API ANEF peut vous fournir des informations précieuses que le tableau de bord classique ne permet pas de consulter clairement.
Dans certains cas, le champ "decision_state" s'affiche
Une fois la décision prise, ce champ apparaît avec la valeur "ACCEPTEE" ou "REFUSEE". Cela précède souvent la réception officielle de la notification de décision.
Ce que fait la préfecture après acceptation :
- • Vous transmet une notification officielle (généralement par courrier recommandé)
- • Transmet votre dossier à la Direction de l'État Civil pour la transcription de votre acte de naissance
Étape suivante : la transcription de votre naissance à Nantes
Qui s'en occupe ? Le Service Central d'État Civil (SCEC), basé à Nantes.
Quel document est produit ? Un acte de naissance français, indispensable à toutes les démarches suivantes.
Comment savoir si la transcription est en cours ? L'API ANEF ne vous donnera pas d'information à ce sujet. Pour suivre l'évolution :
- • Attendre l'envoi postal automatique de votre acte de naissance (délai moyen : 4 à 8 semaines)
- • Vérifier la publication de votre nom au Journal Officiel
Pourquoi l'API ANEF ne suffit plus après le décret ?
Parce que l'API est exclusivement conçue pour le suivi des démarches de dépôt. Une fois la décision rendue, le traitement sort du système ANEF pour basculer dans des bases gérées par d'autres administrations (le ministère de la Justice, puis le ministère des Affaires étrangères).
FAQ - Questions fréquentes
Définition de l'ANEF
L'Administration Numérique pour les Étrangers en France constitue le portail officiel du Ministère de l'Intérieur dédié aux procédures administratives des ressortissants étrangers. Cette plateforme centralise :
- La soumission des demandes de cartes de séjour
- Le monitoring en temps réel de l'évolution des procédures
- Les formulaires de demande d'acquisition de la nationalité française
- La gestion centralisée des pièces justificatives
Rôle de l'API ANEF
L'interface de programmation applicative ANEF constitue un canal technique d'accès privilégié aux informations de votre procédure. Elle délivre des données plus techniques que l'interface utilisateur standard, incluant :
- L'état technique exact de votre demande
- La phase précise du circuit de traitement
- Les jalons temporels clés de votre dossier
- Les métadonnées techniques d'évolution
Méthodes de suivi de votre procédure ANEF
Deux approches complémentaires s'offrent à vous :
1. Consultation via l'interface utilisateur
- Authentifiez-vous sur la plateforme ANEF
- Rendez-vous dans la rubrique dédiée au suivi de naturalisation
- Examinez la progression visuelle de votre demande
2. Exploitation de l'API (approche technique avancée)
- Établissez une session authentifiée sur votre compte
- Utilisez les endpoints API détaillés dans ce tutoriel
- Accédez à des informations techniques approfondies
Synthèse
L'exploitation de l'API ANEF Naturalisation vous confère une visibilité technique supérieure à la frise conventionnelle. Grâce aux endpoints documentés, vous pourrez :
- Déterminer l'état technique précis de votre procédure
- Localiser exactement la phase de traitement active
- Comprendre la séquence complète de votre demande
- Monitorer l'évolution de votre dossier avec précision
Ce guide pratique devrait vous permettre de naviguer plus efficacement dans les méandres administratifs de votre acquisition de la nationalité française.