A business has one or more tasks that are assigned in the diligence process. Tasks are used to assist in the decision making process when reviewing a business.

{
 "key": "address_property_type",
 "category": "address",
 "label": "Office Address",
 "sub_label": "Commercial",
 "status": "success",
 "message": "Submitted Office Address is a Commercial Property"
}
AttributeTypeDescription
keystringThe unique identifier for the task.
categorystringThe task category. Used to group similar tasks together.
labelstringA prettified version of the task category.
sub_labelstringA brief explanation of the task.
statusstringUsed to signal whether or not the task requires review. One of success, warning, or failure.
messagestringThe detailed reasoning behind why the task is surfaced.

Name Review Task Outcomes

categorykeystatussub_labelmessage
namenameSuccessVerifiedMatch identified to the submitted Business Name
namenameWarningSimilar MatchSimilar match identified to the submitted Business Name
namenameFailureAlternate NameWe believe the submitted TIN is associated with “[the name that we have found]”
namenameFailureUnverifiedUnable to identify a match to the submitted Business Name

Address Verification Review Task Outcomes

categorykeystatussub_labelmessage
addressaddress_verificationSuccessVerifiedMatch identified to the submitted Office Address
addressaddress_verificationWarningApproximate MatchIdentified an address within 0.2 miles of the submitted Office Address
addressaddress_verificationWarningSimilar MatchIdentified a similar address
addressaddress_verificationWarningIncomplete MatchIdentified a partial match with a submitted address that is incomplete
addressaddress_verificationFailureUnverifiedUnable to identify a match to the submitted Office Address

TIN Match Review Task Outcomes

categorykeystatussub_labelmessage
tintinSuccessFoundThe IRS has a record for the submitted TIN and Business Name combination
tintinFailureNot FoundThe IRS does not have a record for the submitted TIN and Business Name combination
tintinFailureErrorInvalid TIN or IRS is Unavailable
tintinFailureMismatchWe believe the submitted TIN is associated with a different Business Name

People Verification Review Task Outcomes

categorykeystatussub_labelmessage
peopleperson_verificationSuccessVerifiedMatch identified to the submitted People
peopleperson_verificationWarningPartial MatchSimilar match identified to the submitted People
peopleperson_verificationFailureUnverifiedUnable to identify a match to the submitted People

Watchlists Review Task Outcomes

categorykeystatussub_labelmessage
watchlistwatchlistSuccessNo HitsNo Watchlists hits were identified on the consolidated sanctions list (including OFAC)
watchlistwatchlistFailureHitsX Watchlists hit(s) have been identified

SOS Filings Status Review Outcome

This review task is unique in that more than one review task from this category can be returned and each outcome carries a distinct key value.

For example, let's say Middesk found 3 registrations for a given business; one is active, one is unknown, and one is inactive. The business response from Middesk would contain:

  • one review task with "key":"sos_active" and "message": "1 of 3 filings found are Active"
  • one review task with "key":"sos_unknown" and "message": "1 of 3 filings have no status provided"
  • one review task with "key":"sos_inactive" and "message": "1 of 3 filings found are Inactive"
categorykeystatussub_labelmessage
sossos_activeSuccessActiveX of Y filings found are Active
sossos_inactiveWarningPartially ActiveX of Y filings found are Inactive
sossos_unknownWarningPartially UnknownX of Y filings have no status provided
sossos_inactiveFailureInactiveThe business has no Active Secretary of State filings
sossos_not_foundFailureNot RegisteredThe business has no Secretary of State filings

SOS Domestic Review Task Outcomes

categorykeystatussub_labelmessage
sossos_domesticSuccessDomestic ActiveActive domestic filing found
sossos_domesticWarningDomestic UnknownNo domestic filing status provided
sossos_domesticFailureDomestic InactiveInactive domestic filing found
sossos_domesticFailureDomestic MissingThe business has no domestic filing

SOS Match Review Task Outcomes

categorykeystatussub_labelmessage
sossos_matchSuccessSubmitted ActiveThe business is Active in the state of the submitted Office Address
sossos_matchWarningSubmitted UnknownThe submitted state does not make filing status available
sossos_matchFailureSubmitted InactiveThe business is Inactive in the state of the submitted Office Address
sossos_matchFailureSubmitted Not RegisteredThe business is not registered in the state of the submitted Office Address

True Industry (Industry Classifications) Review Task Outcomes

categorykeystatussub_labelmessage
industryindustrySuccessNo HitsTrue industry identified as “Other Non-Prohibited”
industryindustryFailureHitsWe believe the company may operate in “X” industry