Documentation · Données en vrac
Utilisation des données en vrac
Chaque collection que nous publions peut être téléchargée en entier sous forme d’un ensemble de fichiers, reconstruits à partir du registre et publiés à des adresses fixes. Ce guide vous aide à déterminer si les fichiers en vrac conviennent à votre travail, quelle collection choisir et où poursuivre votre lecture.
Dois-je utiliser les données en vrac?
Il existe trois façons d’utiliser nos données. Choisissez celle qui correspond au nombre de noms que vous vérifiez et à l’endroit où votre processus de correspondance doit s’exécuter.
| Approche | Convient à | Pour commencer |
|---|---|---|
| API de vérification | La vérification de clients ou de contreparties un à un, ou par petits lots (jusqu’à 20 requêtes par appel), notre moteur de correspondance évaluant chaque résultat. | Premiers pas avec l’API, outil de vérification |
| Fichiers en lot | L’exécution de votre propre processus de correspondance ou de résolution d’entités, le chargement des données dans un entrepôt ou un graphe, l’analyse et la recherche, ou le travail hors ligne. | Cette section |
| Déploiement auto-hébergé | L’exécution du service de vérification dans votre propre environnement. | Déploiement sur site |
Les fichiers en vrac vous donnent toutes les fiches en une seule fois, mais il vous revient alors de concevoir la correspondance : variantes de noms, translittération, dates et identifiants doivent tous être traités de votre côté. Si vous voulez seulement savoir si quelques milliers de noms figurent sur une liste, l’API demande généralement moins de travail.
Comprendre le modèle de données
Chaque ligne d’un registre source devient une fiche (Person, Company, Organization, Vessel, Airplane ou LegalEntity), dotée d’un identifiant de la forme crown-<number>. Son inscription sur ce registre constitue une entité Sanction distincte, crown-<number>-sanction, qui indique le registre, le programme, le lien vers la source et la date d’inscription. Lorsque nous avons associé des fiches de différents registres à une même partie, elles partagent un canonical_id.
Chaque fiche porte un sujet de risque, tiré du type de liste de son registre :
| Type de liste du registre | Sujet dans les fichiers |
|---|---|
| Sanctions | sanction |
| Personnes politiquement vulnérables (PPV) | role.pep |
| Interdiction de contracter et exclusion | debarment |
| Mandats fiscaux, insolvabilité | reg.action |
Pour en savoir plus, consultez la référence du modèle, la structure des entités, les sujets de risque et le modèle de données des déclarations. La même description est publiée en JSON à l’adresse /downloads/meta/model.json, afin qu’un programme de chargement puisse la lire.
Choisir une collection
Une collection est un ensemble de registres publiés ensemble. Cinq sont offertes en fichiers en vrac :
| Collection | Contenu | Fiches | Registres | Version du |
|---|---|---|---|---|
default | Tous les registres ci-dessous dans un seul ensemble de fichiers | — | — | — |
sanctions | Registres de sanctions | — | — | — |
peps | Personnes politiquement vulnérables (PPV) | — | — | — |
crime | Interdiction de contracter, exclusion et application de la loi | — | — | — |
maritime | Navires et fiches comportant un numéro IMO | — | — | — |
Nous recommandons default. Les collections plus petites en sont des sous-ensembles : vous ne perdez donc rien à prendre l’ensemble et à le filtrer vous-même, et vous conservez un seul processus lorsque vos besoins évoluent. Filtrez selon le sujet ou le registre source (le champ datasets). Par exemple, avec jq :
# only politically exposed persons
jq -c 'select(.properties.topics // [] | index("role.pep"))' entities.ftm.json
# only records from one register, by its short identifier
jq -c 'select(.datasets | index("ofac_sdn"))' targets.nested.json
Vous ne souhaitez que les PEPs? Consultez Utilisation des données PEP.
Les fichiers ne contiennent que les registres dont les conditions autorisent la redistribution (voir les positions en matière de licences); leurs totaux sont donc inférieurs aux chiffres consultables sur le site. Par exemple, la recherche contient 1,283,679 fiches de PEP, le téléchargement peps —.
Les données de référence des registres (registres d’entreprises, propriété effective, identifiants de valeurs mobilières) ne sont pas publiées en fichiers en vrac : voir Connaître votre entreprise et Valeurs mobilières.
Formats de données et mises à jour
Chaque collection est publiée en plusieurs formats à partir de la même version, de sorte que les identifiants de fiches concordent d’un fichier à l’autre. La page Formats de données les compare; Garder les données à jour explique les adresses, l’index des versions et les sommes de contrôle; Fichiers delta explique les mises à jour incrémentielles.
Le catalogue de toutes les collections, avec les versions, les chiffres et la taille des fichiers, se trouve à l’adresse /downloads/collections/index.json.
Licences
Le téléchargement ne nécessite ni compte ni clé. En vertu de notre licence de données, l’utilisation non commerciale est gratuite, à condition de citer la source. L’utilisation commerciale, par exemple pour vérifier vos clients ou intégrer les données à un produit, nécessite une licence commerciale; voir aussi utilisation gratuite et non commerciale. Les conditions propres à chaque registre l’emportent lorsqu’elles sont plus strictes.
Partout où vous reproduisez les données, citez-les sous cette forme (tirée de la section 5.1 de la licence de données) :
Source: [Source Publisher name], compiled by Crown Intelligence (crownintelligence.net).
Data as of [date shown on record]. Verify against the original source before relying on this information.
Nos textes juridiques sont des ébauches en attente de révision par des juristes canadiens; les versions publiées les remplaceront.
À consulter également : Crown Default · Sanctions · PEPs · Maritime · Connaître votre entreprise · Valeurs mobilières · Enrichissement des données
Dernière mise à jour : 2026-10-03