Skip to content

Custom Watchlist Templates and Samples

MemberCheck supports custom watchlist to enable you to extend the PEP and Sanction screening to include any blacklist or specific lists applicable to your organisation.

The custom watchlist templates for Individuals and Corporates require separate CSVs due to their different structure and schema.

The sample templates have been provided to assist you in preparing your own files.

Templates

Examplesave_alt Download Sample
Custom watchlist for individual profilesCSV
Custom watchlist for corporate profilesCSV

Individual Custom Watchlist

The fields in the CSV file for individual entities are as follows:

FieldRequiredRemarks
UniqueIDMandatoryThe unique identifier for the entity for tracking within the system.
NamesMandatoryName of the entity including variations in spelling and aliases. Supports multiple names.
DOBsOptionalFull date of birth or year of birth. Supports multiple dates.
GenderOptionalGender of the profile.
AddressesOptionalRegistered or known locations associated with the entity. Supports multiple addresses.
LinkedIndividualsOptionalOther individuals associated with this entity. Supports multiple unique identifiers (UniqueID) of profiles defined in the same custom watchlist.
LinkedCompaniesOptionalOther business entities associated with this entity. Supports multiple unique identifiers (UniqueID) of profiles defined in the corporate custom watchlist.

Formatting and Samples

The first row of the CSV contains the header. Please keep the items in the header and ensure the contents match the sequence of the header items.

Some fields support array of multiple values, for example: Names, Date of Birth, Addresses, Linked Individuals and Linked Companies. For multiple values in the array, each set of data should be separated by semicolon (;) and text containing commas (,) should be enclosed with double quotes (").

The first value in the array of multiple values are considered primary data and will be displayed as the main data in the result profile.

Details of supported formats and examples:

FieldSupported FormatsExamples
UniqueIDUp to 10 digitsUnique identifier from 1 up to 10 digits:
  • 1
  • 10001
  • 100001
  • 200001
NamesUp to 255 characters per name.

Supported name formats:

  • FirstName,MiddleName,LastName
  • FirstName,LastName
  • FirstName LastName
  • OriginalScriptName
For mononymous names, please enter dash (-) for the FirstName and the actual name in the LastName. See example for Suharto in the next column.
Single name:
  • "Charles,Montgomery,Burns"
  • "Charles, Burns"
  • Charles Burns
  • - Suharto
  • 習近平
Multiple names:
  • "Charles,Montgomery,Burns; Monty,Burns; Charlie Burns"
  • "Jinping XI; 習近平; 近平習"
DOBsSupported date formats:
  • DD-MM-YYYY
  • DD/MM/YYYY
  • DD MMM YYYY
  • YYYY-MM-DD
  • YYYY/MM/DD
  • YYYY
Single date:
  • 20-04-1960
  • 20/04/1960
  • 20 APR 1960
  • 1960-04-20
  • 1960/04/20
  • 1960
Multiple dates:
  • 1960; 1961; 01/01/1961
  • "1950-04-01; 1950-04-02"
GenderSupported gender values:
  • Female
  • Male
For "Unspecified" gender, please leave blank.
  • Female
  • female
  • Male
  • male
AddressesAddress contains 6 specific components separated by commas (,).
The country component is essential to enable screening by Country of Residence. Other components are not used in the screening but provide more detailed information for the profile.
Leave the components blank if you do not have information.
  • Building name
  • Street address
  • City
  • State or County
  • Postal or Zip code
  • Country
Single location:
  • ",,,,,MU"
  • ",,Notting Hill,London,,GB"
  • ",213/100 Railway Street,Chatswood,NSW,, AU"
  • "Building A, 213/100 Railway Street, Chatswood, NSW, 2067, AU"
  • "Character Building, 742 Evergreen Terrace, Springfield, Oregon,, US"
Multiple locations:
  • ",,Port Louis,,,MU; ,,Pretoria,,,ZA; ,,Maputo,,,MZ"
  • ",,Notting Hill,London,,GB; ,,Canberra, ACT,, AU; ,,Arlington, Virginia,,US"
  • "Character Building, 742 Evergreen Terrace, Springfield, Oregon,, US; ,,San Angelo,Texas,,US"

Note: To minimise incompatibilities with variations in country name spelling, we recommend using the ISO 3166-1 2-letter code for country names.

LinkedIndividualsThe unique identifier (UniqueID) of the individual(s) associated with this entity. Ensure the unique identifier refers to an existing profile in the same custom watchlist.Single associated individual:
  • 10001
Multiple associated individuals:
  • 10001;10002;10335
LinkedCompaniesThe unique identifier (UniqueID) of the business entity associated with this entity. Ensure the unique identifier refers to an existing profile in the corporate custom watchlist to be uploaded together with the individual custom watchlist.Single associated company:
  • 50001
Multiple associated individuals:
  • 50001;50002

Example of CSV content

1
2
3
4
5
6
UniqueID,Names,Gender,DOBs,"Addresses (Building,Street address,City,State,Postal code,Country)",LinkedIndividuals,LinkedCompanies
1001,"Charles, Montgomery, Burns; Monty Burns; Charlie Bernz",Male,1960-01-01;01/01/1961,"Character Building, 742 Evergreen Terrace, Springfield, Oregon,,US; ,,Notting Hill,London,,GB",1002;1003,5001
1002,"Liliana, Bancroft;Liliana, Lily, Bancroft;Lily, Bancroft",Female,1955,",,,,,US",1001,
1003,Larry Burns, Male,1940-01-01;1939-12-31,",,,Oregon,,US",1001,
1004,Clifford Burns,Male,28/12/1980,",,San Angelo,Texas,,US",,5002
1005,- Suharto;- Soeharto,Male,,",,,,,ID",,

Screening for Charles Burns would return the following profile from the sample custom watchlist:

Corporate Custom Watchlist

The fields in the CSV file for corporate entities are as follows:

FieldRequiredRemarks
UniqueIDMandatoryThe unique identifier for the entity for tracking within the system.
NamesMandatoryName of the entity including variations in spelling and aliases. Supports multiple names.
AddressesOptionalRegistered or known locations associated with the entity. Supports multiple addresses.
LinkedIndividualsOptionalOther individuals associated with this entity. Supports multiple unique identifiers (UniqueID) of profiles defined in the Individuals custom watchlist.
LinkedCompaniesOptionalOther business entities associated with this entity. Supports multiple unique identifiers (UniqueID) of profiles defined in the same custom watchlist.

Formatting and Samples

The first row of the CSV contains the header. Please keep the items in the header and ensure the contents match the sequence of the header items.

Some fields support array of multiple values, for example: Names, Addresses, Linked Individuals, and Linked Companies. For multiple values in the array, each set of data should be separated by semicolon (;) and text containing commas (,) should be enclosed with double quotes (").

The first value in the array of multiple values are considered primary data and will be displayed as the main data in the result profile.

Details of supported formats and examples:

FieldSupported FormatsExamples
UniqueIDUp to 10 digitsUnique identifier from 1 up to 10 digits:
  • 1
  • 10001
  • 100001
  • 200001
NamesUp to 255 characters per name.

Supported name formats:

  • CompanyName
  • OriginalScriptName
Single name:
  • "AB & C Alphabet Company"
  • "Alpha, Bravo & Charlie Pty. Ltd."
  • Springfield Nuclear Power Plant
  • 贵州烟草
Multiple names:
  • "AB & C Alphabet Company; ABC Alphabet Company; The Alpha Bet Incorporated; The Company"
  • "China Tobacco Industrial Company Ltd; 贵州烟草"
AddressesAddress contains 6 specific components separated by commas (,).
The country component is essential to enable screening by Country of Residence. Other components are not used in the screening but provide more detailed information for the profile.
Leave the components blank if you do not have information.
  • Building
  • Street address
  • City
  • State or County
  • Postal or Zip code
  • Country
Single location:
  • ",,,,,MU"
  • ",,Notting Hill,London,,GB"
  • ",213/100 Railway Street,Chatswood,NSW,, AU"
  • "Building A, 213/100 Railway Street, Chatswood, NSW, 2067, AU"
  • "Tower A, 1002 Evergreen Terrace, Springfield, Oregon,, US"
Multiple locations:
  • ",,Port Louis,,,MU; ,,Pretoria,,,ZA; ,,Maputo,,,MZ"
  • ",,Notting Hill,London,,GB; ,,Canberra, ACT,, AU; ,,Arlington, Virginia,,US"
  • "Tower A, 1002 Evergreen Terrace, Springfield, Oregon,, US; ,,San Angelo,Texas,,US"

Note: To minimise incompatibilities with variations in country name spelling, we recommend using the ISO 3166-1 2-letter code for country names.

LinkedIndividualsThe unique identifier (UniqueID) of the individual(s) associated with this entity. Ensure the unique identifier refers to an existing profile in the Individuals custom watchlist to be uploaded together with the corporate custom watchlist.Single associated individual:
  • 10001
Multiple associated individuals:
  • 10001;10002;10335
LinkedCompaniesThe unique identifier (UniqueID) of the business entity associated with this entity. Ensure the unique identifier refers to an existing profile in the same corporate custom watchlist.Single associated company:
  • 50001
Multiple associated individuals:
  • 50001;50002

Example of CSV content

1
2
3
4
5
UniqueID,Names,"Addresses (Building,Street address,City,State,Postal code,Country)",LinkedIndividuals,LinkedCompanies
5001,Springfield Nuclear Power Plant,",,Springfield,Oregon,,US",1001,
5002,"AB & C Alphabet Company; ABC Alphabet Company; The Alpha Bet Incorporated; Alpha, Bravo & Charlie Pty. Ltd.",",,San Angelo,Texas,,US; Building A, 188 Main Street, Sydney, NSW, 2000, AU; ,818 Cable Street, Parramatta, NSW, 2150, AU",1004,
5003,Lumosyn Innovations Pty Ltd; ルモシン・イノベーションズ; 露莫森创新,",, Kunming, Yunnan Province,, CN",,5004
5004,Nexara Technologies; Teknologi Nexara; ネクサラテクノロジーズ,",,,,,ID",,5003

Screening for ABC Alphabet Company would return the following profile from the sample custom watchlist:


Cross-linking Individuals and Corporates

To cross-link profiles in the Individual and Corporate custom watchlists, you need to upload both files together. Uploading these files separately will not be able to create the associated relationships.


Encoding and formatting

For the best compatibility and success of processing the CSV custom watchlists, please ensure you apply the following to your CSVs:

  • The file has UTF-8 encoding
  • Line breaks for each record is separated by carriage return and line feed e.g. CRLF or \r\n
  • Each set of data within multiple-value array should be separated by semicolon (;)
  • Values containing commas (,) should be enclosed with double quotes (")
  • Dates should follow any of the supported formats as provided above.

Watch out for date formats in spreadsheets

Be mindful of date format changes when using spreadsheets. If you're editing and saving custom watchlists, ensure the date formats stay consistent. For instance, Excel might automatically reformat dates based on your system's settings.

Similar to batch files, you can use a text editor to review contents and formatting, if required.