Tasks

Tasks are modular building blocks that can be used in a decision making process when reviewing a business. A business can have one or more tasks which explain what Enigma found in our KYB evaluation process. Tasks help you understand whether the submitted business is valid and meets your KYB requirements, or if additional investigation is needed.

Attribute	Type	Description
task_name	string	The unique identifier for the task
status	string	Used to signal whether or not the task requires review. Can be either `success` or `failure`
result	string	A simplified summary of the more detailed reason (see below)
reason	String	The detailed reasoning behind the outcome of the task

JSON sample

 "tasks": [
  {
 	 "task_name": "address_verification",
   "status": "failure",
   "reason": "We could not match the input address to any identified address",
  },
 ]

Business Name Verification

The name_verification task compares the input query business name to the matched business name and determines whether the names match or not.

task_name	status	result	reason
name_verification	success	name_exact_match	An input name and a name we identified match exactly
name_verification	success	name_approximate_match	An input name and a name we identified match approximately
name_verification	failure	no_match	We could not match an input name to any identified name

Address Verification

The address_verification task compares the input query addresses to the matched addresses and determines whether the addresses match or not.

task_name	status	result	reason
address_verification	success	address_exact_match	An input address and an address we identified match exactly
address_verification	success	address_approximate_match	An input address and an address we identified match approximately
address_verification	failure	no_match	We could not match an input address to any identified address

Domestic Registration Check

The domestic_registration checks matched company registrations to see whether or not the queried business has a domestic registration in a U.S. state, and if so, whether it is active.

task_name	status	result	reason
domestic_registration	success	domestic_active	Active domestic filing found
domestic_registration	success	domestic_unknown	Domestic filing found but no status provided by state
domestic_registration	failure	domestic_inactive	Inactive domestic filing found
domestic_registration	failure	domestic_not_found	We found no domestic filing for the business

Watchlist Check

The watchlist task checks whether the queried business appears on any U.S. government sanctions lists.

task_name	status	result	reason
watchlist	success	no_hits	No hits identified on the consolidated sanctions list (including OFAC)
watchlist	failure	hits	X hit(s) identified on the consolidated sanctions list (including OFAC)

TIN Verification

The tin_verification task verifies that the submitted EIN is valid and that it matches the business name submitted.

task_name	status	result	reason
tin_verification	success	tin_verified	TIN and Name combination matches IRS records
tin_verification	failure	error	Invalid TIN
tin_verification	failure	not_completed	IRS is unavailable
tin_verification	failure	not_completed	Duplicate TIN matching request
tin_verification	failure	tin_not_verified	TIN and Name combination does not match IRS records
tin_verification	failure	tin_not_verified	TIN entered is not currently issued