Documentation · Modèle de données

Structure des entités

Nos fichiers en vrac et notre API décrivent le monde sous forme d’entités : des personnes, des sociétés, des navires et les inscriptions qui les désignent. Cette page explique l’objet JSON d’une entité, la façon dont les entités se renvoient les unes aux autres et l’organisation des fichiers d’entités.

Entités

Une entité est un objet JSON comportant quelques champs fixes et un objet properties. Voici une personne tirée de la liste de gel des avoirs de Monaco, telle qu’elle apparaît dans entities.ftm.json :

{
  "id": "crown-379759982",
  "caption": "SULTAN AZIZ AZAM",
  "schema": "Person",
  "properties": {
    "name": [
      "SULTAN AZIZ AZAM"
    ],
    "topics": [
      "sanction"
    ],
    "alias": [
      "AZIZ AZAM",
      "SULTAN AZIZ",
      "SULTAN AZZIZ AZZAM",
      "SULTAN AZIZ EZZAM"
    ],
    "birthDate": [
      "1985"
    ],
    "nationality": [
      "af"
    ],
    "notes": [
      "Nat: AFGHANISTAN · DOB: 1985"
    ]
  },
  "referents": [],
  "datasets": [
    "monaco_siccfin_liste_nationale_de_gel_des_fonds"
  ],
  "first_seen": "2026-09-24T11:22:17.136797+00:00",
  "last_seen": "2026-09-24T11:22:17.136797+00:00",
  "last_change": "2026-09-24T11:22:17.136797+00:00",
  "target": true,
  "canonical_id": "crown-e-d9d87cf7-081f-41c3-bcd3-42a1194a9e9d"
}

Chaque valeur de propriété est une liste, même lorsque le fournisseur ne donne qu’une seule valeur, car de nombreux fournisseurs indiquent plusieurs noms ou dates de naissance pour une même personne. Les propriétés que peut porter chaque schéma figurent dans le dictionnaire de données.

Champs fixes

Comment les légendes sont choisies

La légende d’une partie est son nom principal exactement tel que le fournisseur l’a écrit, y compris sa casse et l’ordre des mots du fournisseur (AZAM, SULTAN AZIZ dans une liste, SULTAN AZIZ AZAM dans une autre). Nous ne choisissons pas encore d’orthographe privilégiée entre les registres. La légende d’une entité Sanction est son programme ou, en l’absence de programme, le nom du registre.

Horodatages

Les horodatages suivent la norme ISO 8601 en UTC, avec un décalage de fuseau horaire.

Ces dates décrivent notre collecte, et non l’inscription. Pour connaître la date à laquelle une personne a été inscrite, utilisez le champ listingDate de l’entité Sanction lorsque le fournisseur en indique une, ou consultez la fiche du fournisseur lui-même.

Références entre entités

Une propriété de type entity contient l’ID d’une autre entité. Pour l’instant, la seule propriété de ce type est entity sur l’entité Sanction, qui renvoie à la partie inscrite. L’inscription de la personne ci-dessus figure sur une ligne distincte du même fichier :

{
  "id": "crown-379759982-sanction",
  "schema": "Sanction",
  "caption": "Personne physique",
  "properties": {
    "entity": [
      "crown-379759982"
    ],
    "authority": [
      "Monaco SICCFIN — Liste nationale de gel des fonds"
    ],
    "program": [
      "Personne physique"
    ]
  },
  "datasets": [
    "monaco_siccfin_liste_nationale_de_gel_des_fonds"
  ],
  "first_seen": "2026-09-24T11:22:17.136797+00:00",
  "last_seen": "2026-09-24T11:22:17.136797+00:00",
  "last_change": "2026-09-24T11:22:17.136797+00:00"
}

Ici, le fournisseur a inscrit le type de partie (« Personne physique ») dans sa colonne de programme, et nous conservons sa formulation. Les champs Sanction sont à lire comme ceux du fournisseur, et non comme une classification de notre part.

Relations

FollowTheMoney modélise les liens tels que la propriété, les postes d’administrateur, les liens familiaux et les associés comme des entités à part entière qui renvoient à deux parties. Nous ne publions pas encore d’entités de relation. Les déclarations de bénéficiaires effectifs (par exemple le registre britannique des personnes exerçant un contrôle important) sont conservées dans nos tables de registres, mais ne font pas partie des fichiers d’entités. L’élaboration d’un modèle de relations est un chantier prévu (point 23 de l’arriéré de données).

Fichiers d’entités

Nos fichiers d’entités sont au format JSON Lines : un objet JSON complet par ligne, sans tableau englobant, de sorte qu’un fichier de n’importe quelle taille peut être lu ligne par ligne. Dans entities.ftm.json, chaque partie est suivie, à la ligne suivante, de son entité Sanction. Les fichiers de chaque collection, avec leurs tailles et leurs sommes de contrôle, sont énumérés dans Utiliser les données en vrac ; la façon d’appliquer les changements entre les versions est décrite dans Fichiers delta.

# after downloading a collection's file
head -2 entities.ftm.json          # first party and its listing
wc -l entities.ftm.json            # number of entities (parties + listings)

Outils pour les données FollowTheMoney

Comme nos fichiers suivent FollowTheMoney, les outils conçus pour ce modèle peuvent les lire. Il s’agit de projets tiers, que nous ne maintenons pas.

• Documentation de FollowTheMoney, y compris la référence de chaque schéma et type de propriété.
• Le paquet Python followthemoney, qui lit, valide et convertit les fichiers d’entités.

Voir aussi : Sujets de risque, Glossaire : jeu de données, Toutes les sources de données.

Dernière mise à jour : 2026-10-04