Développeurs

API publique

Trois endpoints (deux GET, un POST), gratuits, sans clé d'API, limités à 60 requêtes/minute par IP. Réponses JSON stables, en cache côté serveur. Aucune de ces routes ne nécessite ni ne stocke de donnée personnelle.

Conditions d'usage

Usage libre, y compris commercial, à condition de créditer et lier versfrance-naturalisation.netdans toute application ou page publique qui affiche ces données. Les données de/api/v1/delays sont sous licenceODbL 1.0et doivent aussi créditer naturalisation-facile.fr, le producteur de la donnée primaire. Pas de SLA, pas de garantie de disponibilité — c'est une API gratuite d'un site indépendant, pas un service commercial.

GET/api/v1/delays

Délai médian de naturalisation par préfecture (36 plateformes, 101 départements).

curl

curl "https://france-naturalisation.net/api/v1/delays"

JavaScript

const res = await fetch("https://france-naturalisation.net/api/v1/delays");
const { platforms } = await res.json();

POST/api/v1/eligibility-check

Vérifie l'éligibilité à la naturalisation à partir de réponses au questionnaire, envoyées dans un corps JSON (jamais dans l'URL) — aucune donnée stockée ni journalisée, aucun e-mail requis. Un GET renvoie 405.

Paramètres : Corps JSON (Content-Type: application/json) : residence, etudes, marie, duree-mariage (si marie=oui), francais, emploi, casier, oqtf — voir les valeurs possibles dans la réponse 400 si une réponse manque.

curl

curl -X POST "https://france-naturalisation.net/api/v1/eligibility-check" \
  -H "Content-Type: application/json" \
  -d '{"residence":"plus-10","etudes":"non","marie":"non","francais":"avance","emploi":"stable","casier":"non","oqtf":"non"}'

JavaScript

const res = await fetch("https://france-naturalisation.net/api/v1/eligibility-check", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ residence: "plus-10", etudes: "non", marie: "non", francais: "avance", emploi: "stable", casier: "non", oqtf: "non" }),
});
const { result } = await res.json();

GET/api/v1/requirements/{pays}

Critères clés de naturalisation pour un pays donné (délai moyen, niveau de français requis, coût, double nationalité).

Paramètres : {pays} = slug pays (ex. "maroc", "algerie") — identique à /guide/nationalite/{pays}.

curl

curl "https://france-naturalisation.net/api/v1/requirements/maroc"

JavaScript

const res = await fetch("https://france-naturalisation.net/api/v1/requirements/maroc");
const { keyFacts } = await res.json();

Autres ressources ouvertes

Dépôt open source prefecture-delays— le script de collecte et l'historique complet des relevés derrière /api/v1/delays.
Dataset data.gouv.fr— le même jeu de données publié sur le portail officiel de l'open data français.
openapi.json— spécification OpenAPI du reste du site.
llms.txt— index pensé pour les agents IA et assistants de recherche.