Documentation de l'API Mortalis

Démarrage

1. 1. Créer un compte gratuit Inscrivez-vous en ligne avec votre e-mail : la clé d'API reçue est la même que pour Adralis et Kompaz. Sans clé, l'API répond quand même, avec un débit limité, pour essayer.
2. 2. Appeler l'API Une requête GET avec le nom de naissance, le prénom et la date de naissance de la personne, et votre clé dans l'en-tête X-API-Key.
3. 3. Lire la réponse decede vaut true si un décès correspond. La date et le lieu du décès sont dans deces.

La requête

curl -H "X-API-Key: VOTRE_CLE" \
  "https://api.nubelo.fr/v1/deces/recherche?nom=NOM&prenom=PRENOM&date_naissance=AAAA-MM-JJ"

Sans date de naissance, la recherche n'est pas possible : le nom et le prénom seuls renverraient des homonymes.

Affiner avec une commune (facultatif)

La commune ne sert pas à identifier la personne : la fiche en contient déjà deux, celle de la naissance et celle du décès. C'est un élément de plus, comparé à ces deux communes, qui fait monter ou baisser l'indice de confiance. Donnez un code INSEE, un code postal, un code postal avec la commune, ou la commune seule. Personne n'est écarté à cause de la commune : elle n'est pas forcément celle de la naissance ou du décès (c'est souvent le domicile).

La réponse

{
  "decede": true,
  "mode": "unique",
  "deces": [
    {
      "nom": "NOM",
      "prenoms": "PRENOM1 PRENOM2",
      "sexe": "M",
      "date_naissance": "AAAA-MM-JJ",
      "lieu_naissance": "COMMUNE",
      "date_deces": "AAAA-MM-JJ",
      "code_commune_deces": "00000",
      "commune_deces": "COMMUNE",
      "departement_deces": "00",
      "confiance": 90
    }
  ],
  "periode": { "du": "AAAA-MM-JJ", "au": "AAAA-MM-JJ" },
  "source": "INSEE, fichier des personnes décédées ; …"
}

Une date de décès dont le mois ou le jour est inconnu est renvoyée tronquée (AAAA-MM ou AAAA).

Erreurs et limites

Chaque appel avec clé consomme un crédit Nubelo ; le solde restant est dans l'en-tête X-Credits-Restants (illimite avec l'abonnement illimité). Une requête refusée parce que ses paramètres sont invalides ne consomme rien.

Traiter un fichier

Sur compte.nubelo.fr/fichiers, déposez un fichier CSV ou Excel (jusqu'à 1 million de lignes) et choisissez Mortalis. Le service détecte les colonnes du nom de naissance, du prénom et de la date de naissance (vous pouvez corriger), et, si vous en avez, celles du code INSEE, du code postal ou de la commune, qui affinent l'indice de confiance, vous présente le coût et un aperçu, puis ne démarre qu'après votre validation. Les colonnes d'origine ne sont pas modifiées.

Un crédit par ligne exploitable. Dates acceptées : JJ/MM/AAAA, AAAA-MM-JJ, JJ-MM-AAAA, JJ.MM.AAAA et AAAAMMJJ. Le fichier contient le nom de naissance : une cliente enregistrée sous son nom d'épouse n'est retrouvée que si le fichier fournit aussi son nom de jeune fille.

Les données

La source est le fichier des personnes décédées publié par l'Insee sur data.gouv.fr, à partir des actes de décès des mairies. Mortalis garde les 24 derniers mois et se met à jour chaque mois, quand l'Insee publie le fichier du mois précédent (entre le 3 et le 23 du mois).

Une personne absente du fichier n'est pas forcément vivante : elle peut être décédée avant la période couverte, ou à l'étranger sans transcription en France, et un décès récent peut ne pas encore y figurer. Le dernier mois de la base est toujours incomplet. Le fichier ne contient ni adresse ni coordonnées.