Types of Matchlists

There are 5 types of Matchlists:

TypeDetailExample
STRINGAny valid string"blacklist_value": "abcde"
IP_NETIP address"ip_address": "255.255.255.255",
IP_CIDRIP addressing scheme"cidr": "255.255.255.255/32",
USERUnit21 user entity object"first_name": "Arthur",
"last_name": "Gonzalez",
"middle_name": "John",
"date_of_birth": "04/05/1989",
"ssn": "1112223333",
"email": "[email protected]",
"ip_address": "43.192.250.0",
"phone_number": "+12345678901",
BUSINESSUnit21 business entity object"business_name": "Acme Corp",
"dba_name": "Acme Inc",
"corporate_tax_id": "111223333",
"street": "123 Peactree Dr",
"city": "Atlanta",
"state": "GA",
"country": "US",
"zip_code": "94205"

User Matchlist


User matchlists let you screen events against lists of users and user data. Although no field is required, you MUST fill at least one field.

📘

The alias fields let you check a field for a second name.

If you add Fred for the First Name, and Grizzly for First Name Alias, the list will check whether either Fred or Grizzly appears in an event's first_name field. Aliases for Middle Name and Last Name work the same way.

810

You must fill at least one field.

Business Matchlist


Business matchlists let you screen events against lists of businesses and business data. Although no field is required, you MUST fill at least one field.

837

You must fill at least one field.

Single IP (IP_INET) Matchlist


To add a single IP to a matchlist, select IP_INET as the list type. Then you can add IPs and source locations.

506

Range of IPs (CIDR) Matchlist


You can also add a whole range of IP addresses to an existing matchlist. This is useful when you want to do things like check against an entire IP subnet. IP ranges are in CIDR subnet mask notation°. You may want to check this caculator° for help, or ask a developer.

492

This IP range checks every IP between 192.168.1.0 and 192.168.1.255. See a CIDR calculator for more details.

String Matchlist


If you want to check for a word across a variety of different fields, you can upload data as a simple string. A string could be any word or collection of words.