Uso de los datos de PEP

Consejos prácticos para la verificación con nuestros datos de PEP, ya sea que utilice la API o cargue los archivos masivos.

Selección del conjunto de datos

Para el uso masivo, recomendamos la colección default, filtrada por el tema role.pep: obtiene los mismos registros de PEP que en la colección peps y mantiene los registros de sanciones y de inhabilitación para contratar en el mismo flujo de trabajo, de modo que no se pase por alto a una PEP que además esté sancionada.

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

Si solo desea PEPs, descargue la colección peps (— registros). Mediante la API, realice la verificación contra /api/match/peps, o contra /api/match/default y revise el list_type de cada resultado.

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"]}}}}'

Para conservar en la misma llamada los registros de sanciones y de inhabilitación para contratar, realice la verificación contra default y agregue el filtro topics=role.pep. Así, los candidatos se limitan a los registros etiquetados como PEPs, y el filtro que aplicó se devuelve en el campo filters de la respuesta.

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"]}}}}'

Para limitar o ampliar los registros, agregue include_dataset (conserva solo los registros indicados) o exclude_dataset (los excluye). Ambos reciben el nombre completo del registro tal como aparece en Fuentes y en el campo datasets de cada resultado, codificado como URL, y ambos pueden repetirse. Por ejemplo, solo los miembros de la House of Commons:

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"]}}}}'

Los mismos tres filtros funcionan en /api/search. Varios valores de un mismo filtro se combinan con OR; filtros distintos, con AND. Consulte la solicitud para ver las reglas completas.

Qué revisar en un registro de PEP

En los archivos masivos	En los resultados de la API	Uso
`properties.sanctions[].properties.program`	`programme`	El cargo o función tal como lo publica el registro.
`properties.sanctions[].properties.authority`, `datasets`	`source`	El registro, que indica el país y el nivel de gobierno.
`birthDate`, `nationality`	`birth_date`, `nationality`	Para confirmar la identidad. A menudo falta en los registros de titulares de cargos.
`first_seen`, `last_seen`	`last_seen`	Cuándo recopilamos el registro por primera vez y cuándo lo confirmamos por última vez.
`canonical_id`	`merged_entity`	Otros registros que hemos vinculado como la misma persona.

Todavía no contamos con las fechas de inicio y fin del cargo, la circunscripción, el partido ni si la persona sigue en el cargo; consulte la metodología de PEP.

Filtrado

Por país o nivel de gobierno: filtre por el registro (datasets o source); cada registro pertenece a un único editor. La lista de registros figura en el sources.json de cada colección, con su país. Mediante la API, utilice include_dataset o exclude_dataset.
Es preferible excluir que incluir. Si algunos registros quedan fuera de sus obligaciones, descártelos por nombre en lugar de mantener una lista corta de los registros que desea: así, los registros nuevos que agreguemos les llegarán por defecto.
Registros tipificados como organizaciones. Algunos registros de PEP incluyen entidades (comités, partidos) en lugar de personas. Filtre por schema = Person si solo desea personas físicas.

Última actualización 2026-10-03