Watchlist object

Middesk supports two watchlist products. As part of the Business Verification-Verify package, Middesk supports many key US Federal watchlists. If you require more comprehensive screenings, leverage the Enhanced Screenings product to run extensive searches against thousands of global watchlists.

Lists included in Business Verification-Verify

Code	Title	Agency	Organization
`CAP`	Capta List	Office of Foreign Assets Control	U.S. Department of Treasury
`DPL`	Denied Persons List	Bureau of Industry and Security	U.S. Department of Commerce
`DTC`	AECA/ITAR Debarred	Directorate of Defense Trade Controls	U.S. Department of State
`EL`	Entity List	Bureau of Industry and Security	U.S. Department of Commerce
`FSE`	Foreign Sanctions Evaders	Office of Foreign Assets Control	U.S. Department of Treasury
`ISN`	Nonproliferation Sanctions	Bureau of International Security and Non-Proliferation	U.S. Department of State
`MEU`	Military End User	Bureau of Industry and Security	U.S. Department of Commerce
`NS-CMIC`	Non-SDN Chinese Military-Industrial Complex Companies List	Office of Foreign Assets Control	U.S. Department of the Treasury
`NS-ISA`	Non-SDN Iranian Sanctions	Office of Foreign Assets Control	U.S. Department of Treasury
`NS-MBS`	Non-SDN Menu-Based Sanctions	Office of Foreign Assets Control	U.S. Department of Treasury
`PLC`	Palestinian Legislative Council	Office of Foreign Assets Control	U.S. Department of Treasury
`SDN`	Specially Designated Nationals	Office of Foreign Assets Control	U.S. Department of Treasury
`SSI`	Sectoral Sanctions Identifications List	Office of Foreign Assets Control	U.S. Department of Treasury
`UVL`	Unverified List	Bureau of Industry and Security	U.S. Department of Commerce

If only a subset of these lists are necessary for your compliance program, configure the lists and agencies the watchlist runs against in the Middesk Dashboard account settings.

Lists included in Enhanced Screenings

Enhanced Screenings contain thousands of lists to run against. Middesk sets up the account with a set of default lists from key global agencies to screen against. Beyond that, thousands more lists can be turned on as required by your compliance department.

To see which lists are enabled or available, go to the Dashboard Settings > Screenings > Watchlist and Enhanced Screenings to find more information.

Migrate to Enhanced Screenings

Some fields in the Watchlist object are now nullable in the API for Enhanced Screenings. Look below to see the fields that are nullable in Enhanced Screenings to see if you need to make any API changes before turning on Enhanced Screenings.

Watchlist object

The watchlist response has a container for displaying top-level information around watching screening.

Example JSON response

1 {
2   "id": "3fc438eb-1234-4fc1-bb5e-fcac60db2e2e",
3   "object": "watchlist",
4   "lists": [
5     {
6       "abbr": "DPL",
7       "title": "Denied Persons List",
8       "agency": "Bureau of Industry and Security",
9       "results": [],
10       "agency_abbr": "BIS",
11       "organization": "U.S. Department of Commerce"
12     },
13     {
14       "abbr": "DTC",
15       "title": "AECA/ITAR Debarred",
16       "agency": "Directorate of Defense Trade Controls",
17       "results": [
18         {
19           "id": "a6be972d-2eff-4785-a57f-f2b834f3fb96",
20           "object": "watchlist_result",
21           "listed_at": null,
22           "entity_name": "Gia An Du",
23           "entity_aliases": [
24             "Anthony Huynh",
25             "Simon Du",
26             "Gia Simon Du"
27           ],
28           "agency_list_url": "http://bit.ly/307FuRQ",
29           "agency_information_url": "http://bit.ly/307FuRQ"
30         }
31       ],
32       "agency_abbr": "DDTC",
33       "organization": "U.S. Department of State"
34     },
35     {
36       "abbr": "EL",
37       "title": "Entity List",
38       "agency": "Bureau of Industry and Security",
39       "results": [],
40       "agency_abbr": "BIS",
41       "organization": "U.S. Department of Commerce"
42     },
43     {
44       "abbr": "SDN",
45       "title": "Specially Designated Nationals",
46       "agency": "Office of Foreign Assets Control",
47       "results": [],
48       "agency_abbr": "OFAC",
49       "organization": "U.S. Department of Treasury"
50     },
51     {
52       "abbr": "NSISA",
53       "title": "Non-SDN Iranian Sanctions Act",
54       "agency": "Office of Foreign Assets Control",
55       "results": [],
56       "agency_abbr": "OFAC",
57       "organization": "U.S. Department of Treasury"
58     },
59     {
60       "abbr": "FSE",
61       "title": "Foreign Sanctions Evaders",
62       "agency": "Office of Foreign Assets Control",
63       "results": [],
64       "agency_abbr": "OFAC",
65       "organization": "U.S. Department of Treasury"
66     },
67     {
68       "abbr": "ISN",
69       "title": "Nonproliferation Sanctions",
70       "agency": "Bureau of International Security and Non-Proliferation",
71       "results": [],
72       "agency_abbr": "ISN",
73       "organization": "U.S. Department of State"
74     },
75     {
76       "abbr": "P561",
77       "title": "Foreign Financial Institutions Subject to Part 561",
78       "agency": "Office of Foreign Assets Control",
79       "results": [],
80       "agency_abbr": "OFAC",
81       "organization": "U.S. Department of Treasury"
82     },
83     {
84       "abbr": "PLC",
85       "title": "Palestinian Legislative Council",
86       "agency": "Office of Foreign Assets Control",
87       "results": [],
88       "agency_abbr": "OFAC",
89       "organization": "U.S. Department of Treasury"
90     },
91     {
92       "abbr": "SSI",
93       "title": "Sectoral Sanctions Identifications",
94       "agency": "Office of Foreign Assets Control",
95       "results": [],
96       "agency_abbr": "OFAC",
97       "organization": "U.S. Department of Treasury"
98     },
99     {
100       "abbr": "UVL",
101       "title": "Unverified List",
102       "agency": "Bureau of Industry and Security",
103       "results": [],
104       "agency_abbr": "BIS",
105       "organization": "U.S. Department of Commerce"
106     },
107     {
108       "abbr": "CAP",
109       "title": "Capta List",
110       "agency": "Office of Foreign Assets Control",
111       "results": [],
112       "agency_abbr": "OFAC",
113       "organization": "U.S. Department of Treasury"
114     }
115   ],
116   "agencies": [
117     {
118       "org": "U.S. Department of Treasury",
119       "abbr": "OFAC",
120       "name": "Office of Foreign Assets Control"
121     },
122     {
123       "org": "U.S. Department of Commerce",
124       "abbr": "BIS",
125       "name": "Bureau of Industry and Security"
126     },
127     {
128       "org": "U.S. Department of State",
129       "abbr": "DDTC",
130       "name": "Directorate of Defense Trade Controls"
131     },
132     {
133       "org": "U.S. Department of State",
134       "abbr": "ISN",
135       "name": "Bureau of International Security and Non-Proliferation"
136     }
137   ],
138   "hit_count": 1
139 }

Watchlist attributes

Attribute	Type	Description
`id`	string	Unique identifier for the object
`object`	string, value is `watchlist`	A definition of the type of object returned
`lists`	object[]	The details of any potential matches of that entity against the search list
`hit_count`	number	The number of watchlist hits found

List object

Inside the watchlist object, many lists are found under the lists key. Each list has the following attributes.

Attribute	Type	Description	Guaranteed
`abbr`	string	The watchlist abbreviation/code (see table above)	No. For Enhanced Screenings, this field may be null.
`title`	string	The full name for the watchlist (see table above)	Yes
`agency`	string	The agency responsible for maintaining the watchlist (see table above)	Yes
`agency_abbr`	string	The agency’s abbreviated name (see table above)	No. For Enhanced Screenings, this field may be null.
`organization`	string	The governing organization for the agency	No. For Enhanced Screenings, this field may be null.
`results`	object[]	Hits or results for the watchlist based on business name or officer name match	Yes. May be [].

Result object

Results are included with each watchlist. When hits are found, one or many result objects appear in this collection. When no hits are found, the collection is empty.

Attribute	Type	Description	Guaranteed
`id`	string	Unique identifier for the object	Yes
`object`	string, value is watchlist_result	A definition of the type of object returned	Yes
`listed_at`	timestamp	When the result was listed	No
`entity_name`	string	The proper name for the entity matched	Yes
`entity_aliases`	string[]	A list of aliases for the person or business	Yes, may be []
`agency_list_url`	string	A short link to the agency’s posting for the record	No
`agency_information_url`	string	A short link to the agency’s information	No
`addresses`	object[]	Addresses associated with the watchlist hit	Yes, may be []
`url`	string	Url link to the watchlist hit	No
`score`	float	A score to indicate how similar a submitted name is to a sanction name	Yes

Date of birth watchlist filter for submitted people

To use the date of birth configuration for watchlists, you must pass in the additional dob field in the people object in the Create a Business API call. Similar to the name field for people, use the date of birth field for more than just one submitted “person.” After setting the Date of Birth Fuzzy Match Tolerance settings, you only receive positive watchlist hits if the submitted date of birth field is within the setting’s parameters.

title ="Create/patch a business request"

1 {
2   "people": [
3     {
4       "name": "Jane Doe",
5       "dob": "1990-01-01"
6     },
7     {
8       "name": "John Doe",
9       "dob": "1988-10-23"
10     }
11   ]
12 }

Get a demo

Contact your account manager or contact sales to inquire about access.