Utilisation des données PEP

Conseils pratiques pour effectuer une vérification à partir de nos données PEP, que vous appeliez l’API ou que vous chargiez les fichiers en bloc.

Choix du jeu de données

Pour une utilisation en bloc, nous recommandons la collection default, filtrée sur le thème role.pep : vous obtenez les mêmes fiches PEP que dans la collection peps et vous conservez les fiches de sanctions et d’interdiction de contracter dans le même flux de traitement, de sorte qu’une PPV qui fait aussi l’objet de sanctions ne passe pas inaperçue.

# PEP records from the Crown Default collection
jq -c 'select(.properties.topics | index("role.pep"))' targets.nested.json > peps.json

Si vous ne souhaitez que les PEPs, téléchargez la collection peps (— fiches). Avec l’API, effectuez la vérification par rapport à /api/match/peps, ou par rapport à /api/match/default et consultez le champ list_type de chaque résultat.

curl -X POST "https://api.crownintelligence.net/api/match/peps" \
  -H "Content-Type: application/json" \
  -d '{"queries":{"q1":{"schema":"Person","properties":{"name":["Jane Example"],"nationality":["ca"]}}}}'

Pour conserver les fiches de sanctions et d'interdiction de contracter dans le même appel, effectuez la vérification par rapport à default et ajoutez le filtre topics=role.pep. Les candidats se limitent alors aux fiches étiquetées comme PEPs, et le filtre que vous avez appliqué est renvoyé en écho dans le champ filters de la réponse.

curl -X POST "https://api.crownintelligence.net/api/match/default?topics=role.pep" \
  -H "Content-Type: application/json" \
  -d '{"queries":{"q1":{"schema":"Person","properties":{"name":["Jane Example"],"nationality":["ca"]}}}}'

Pour restreindre ou élargir les registres, ajoutez include_dataset (conserver uniquement les registres nommés) ou exclude_dataset (les exclure). Les deux acceptent le nom complet du registre tel qu’il figure sur la page Sources et dans le champ datasets de chaque résultat, encodé pour une URL, et peuvent être répétés. Par exemple, pour les membres de la Chambre des communes seulement :

curl -X POST "https://api.crownintelligence.net/api/match/default?topics=role.pep&include_dataset=Canada%20Commons%20%E2%80%94%20Members%20of%20the%20House%20of%20Commons" \
  -H "Content-Type: application/json" \
  -d '{"queries":{"q1":{"schema":"Person","properties":{"name":["Pierre Poilievre"]}}}}'

Les trois mêmes filtres fonctionnent sur /api/search. Plusieurs valeurs d’un même filtre sont combinées par OU, et des filtres différents par ET. Consultez la requête pour connaître l’ensemble des règles.

Éléments à consulter dans une fiche PEP

Dans les fichiers en bloc	Dans les résultats de l’API	Utilité
`properties.sanctions[].properties.program`	`programme`	Le rôle ou la fonction tel que le registre le publie.
`properties.sanctions[].properties.authority`, `datasets`	`source`	Le registre, qui indique le pays et l’ordre de gouvernement.
`birthDate`, `nationality`	`birth_date`, `nationality`	Pour confirmer l’identité. Souvent absente des registres de titulaires de charges publiques.
`first_seen`, `last_seen`	`last_seen`	La date à laquelle nous avons recueilli la fiche pour la première fois et celle de sa dernière confirmation.
`canonical_id`	`merged_entity`	Les autres fiches que nous avons associées à la même personne.

Nous ne détenons pas encore les dates d’entrée en fonction et de fin de mandat, la circonscription, le parti, ni l’indication selon laquelle une personne est toujours en poste; consultez la méthodologie PEP.

Filtrage

Par pays ou par ordre de gouvernement : filtrez sur le registre (datasets ou source); chaque registre relève d’un seul éditeur. La liste des registres figure dans le sources.json de chaque collection, avec le pays. Par l’API, utilisez include_dataset ou exclude_dataset.
Privilégiez l’exclusion à l’inclusion. Si certains registres ne relèvent pas de vos obligations, écartez-les par leur nom plutôt que de conserver une courte liste de registres souhaités : les nouveaux registres que nous ajouterons vous parviendront ainsi par défaut.
Fiches de type organisation. Quelques registres PEP répertorient des organismes (comités, partis) plutôt que des personnes. Filtrez sur schema = Person si vous ne voulez que des particuliers.

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