Documentation · Modèle de données
Métadonnées des jeux de données
Chaque collection est accompagnée de fichiers lisibles par machine qui la décrivent : date de construction, contenu, registres contributeurs et fichiers à télécharger. Utilisez-les pour automatiser les téléchargements et vérifier qu’un fichier est complet.
Le catalogue
Un seul fichier énumère toutes les collections avec leur version actuelle, leurs chiffres et leurs fichiers :
/downloads/collections/index.jsonIl répertorie actuellement — collections. Récupérez-le à intervalle régulier, comparez le version de chaque collection à celui que vous détenez, et ne retéléchargez que si ce dernier a changé. Des collections peuvent être ajoutées; votre code doit ignorer celles qu’il ne connaît pas.
Métadonnées d’une collection : index.json
Chaque collection possède son propre index.json, par exemple /downloads/collections/maritime/index.json. Ses champs :
| Section | Champ | Description |
|---|---|---|
| — | scope | Nom court de la collection, utilisé dans les chemins de fichiers. |
| — | title | Nom d’affichage de la collection. |
| — | version | Version de la construction : la date et l’heure UTC de la construction, suivies d’un court suffixe aléatoire. Change à chaque construction. |
| — | generated_at | Moment où la construction a été écrite. |
| — | last_change | Moment où le contenu a changé pour la dernière fois par rapport à la construction précédente. |
| — | records | Nombre de fiches (parties répertoriées). |
| — | searchable | Fiches comportant un nom exploitable. |
| — | distinct_entities | Fiches comptées une seule fois par nom normalisé et date de naissance. Mesure approximative; voir Identifiants. |
| — | sources | Nombre de registres contributeurs. |
| — | first_seen | Date de première apparition la plus ancienne parmi toutes les fiches. |
| — | last_processed | Date la plus récente à laquelle une fiche a été confirmée auprès de son éditeur. |
types | type, records | Fiches par type d’entité (nos codes de type internes : INDIVIDUAL, COMPANY, ORGANIZATION, VESSEL, AIRCRAFT, UNKNOWN). |
countries | country, records | Fiches par code de pays (nationalité ou pays du registre). |
fill | name, alias, birthDate, … | Fiches comportant au moins une valeur pour chaque propriété. Voir taux de remplissage des champs. |
delta | added, modified, removed | Nombre de changements par rapport à la construction précédente, ou null pour une première construction. |
| — | licence | Un renvoi vers notre licence d’utilisation des données. |
files | name, type, path, bytes, rows, sha256 | Chaque fichier de la collection avec sa taille, son nombre de lignes et sa somme de contrôle SHA-256. |
Chaque construction ajoute également une ligne à statistics.json avec les mêmes chiffres, la plus récente en premier; c’est ce que lit la page de statistiques.
Métadonnées des sources : sources.json et l’API
sources.json énumère les registres qui contribuent à une collection, un objet par registre :
| Champ | Description |
|---|---|
name | Nom du registre, tel qu’il apparaît sur nos pages de sources. |
list | Nom court de la liste utilisé dans les fiches. |
country | Pays ou territoire de l’éditeur. |
records | Fiches de ce registre dans la collection. |
first_seen | Moment du premier chargement du registre. |
last_loaded | Chargement le plus récent. |
publisher_type | Type de source, sous forme de code interne (par exemple SANCTIONS_LIST, PEP_REGISTER, DEBARMENT_LIST, COURT_PORTAL). |
cadence_hours | Fréquence prévue d’actualisation de la source, en heures. |
source_url | La page ou le flux de l’éditeur. |
Les mêmes renseignements, avec davantage de chiffres, sont disponibles pour chaque registre à partir de /api/source?name= et pour tous les registres à partir de /api/sources; voir la référence des points d’accès.
Champs que nous ne publions pas encore : le nom de l’organisation d’un éditeur et son statut d’organisme officiel (point 20 de l’arriéré de données), un indicateur d’obsolescence pour les sources interrompues, et une liste contrôlée de fréquences d’actualisation.
Types de liste
Plutôt que des étiquettes libres, chaque registre se voit attribuer un type de liste. Celui-ci détermine les collections auxquelles appartient une fiche et le sujet qui lui est associé.
| Type de liste | Signification | Sujet | Collections |
|---|---|---|---|
SANCTION | Listes de sanctions, de gel des avoirs, de terroristes et listes de désignation similaires. | sanction | Crown Default, sanctions consolidées |
PEP | Registres de personnes politiquement vulnérables (PPV) et de titulaires de charges publiques. | role.pep | Crown Default, personnes politiquement vulnérables |
DEBARMENT | Exclusions des marchés publics, des programmes de santé et des professions réglementées. | debarment | Crown Default, interdiction de contracter et application de la loi |
TAX_WARRANT | Avis de recouvrement fiscal et avis publics d’exécution similaires. | reg.action | Crown Default, interdiction de contracter et application de la loi |
INSOLVENCY | Procédures d’insolvabilité publiées. | reg.action | Crown Default, interdiction de contracter et application de la loi |
La collection maritime n’est pas un type de liste : elle regroupe les fiches de type navire ou portant un numéro IMO, quel que soit le type de liste. Certains registres sont actuellement associés à un mauvais type de liste (point 33 de l’arriéré de données).
Les termes employés ici sont définis dans le glossaire.
Dernière mise à jour : 2026-10-04