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.

Task results are based on the data the API returns. This means you will only see tasks which are relevant to the data you requested.

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",
                "result": "address_not_verified",
                "reason": "We could not match an input address to any identified address"
            },
 ]

Business Name Verification

The name_verification task compares the queried business name(s) to the business names on any matching records we found, and determines whether or not there is a matching name.

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	name_not_verified	We could not match an input name to any identified name

SoS Business Name Verification

The sos_name_verification task compares the queried business name(s) to the registered names on any matching Secretary of State registrations we found, and determines whether the names match or not.

task_name	status	result	reason
sos_name_verification	success	name_exact_match	An input name and a name on an SoS record match exactly
sos_name_verification	success	name_approximate_match	An input name and a name on an SoS record match approximately
sos_name_verification	failure	name_not_verified	We could not match an input name to any name on an SoS record

Address Verification

The address_verification task compares the queried address(es) to the addresses on any matching record, 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	address_not_verified	We could not match an input address to any identified address

SoS Address Verification

The sos_address_verification task compares the queried address(es) to the addresses on any matching Secretary of State registrations we found, 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 on an SoS record match exactly
address_verification	success	address_approximate_match	An input address and an address on an SoS record match approximately
address_verification	failure	address_not_verified	We could not match an input address to any address on an SoS record

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.

Only available when jurisdiction and status attributes are included on legal entities' registrations.

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.

Only available when your request includes OFAC screening.

task_name	status	result	reason
watchlist	success	watchlist_no_hits	No hits identified on the consolidated sanctions list (including OFAC)
watchlist	failure	watchlist_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.

Only available when your request includes TIN verification.

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