Task

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 with a different Business Name
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
tintinWarningWarningThe IRS has a record for the submitted TIN and Person Name combination
tintinFailureMismatchWe believe the submitted TIN is associated with a different Business Name
tintinFailureNot FoundThe IRS does not have a record for the submitted TIN and Business Name combination
tintinFailureErrorInvalid TIN format: Invalid TIN format

People Verification Review Task Outcomes

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

Watchlists Review Task Outcomes

categorykeystatussub_labelmessage
watchlistwatchlistSuccessNo HitsNo Watchlist hits were identified
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

SOS Domestic Sub-status Review Task Outcomes

categorykeystatussub_labelmessage
sossos_domestic_sub_statusSuccessGood StandingThe domestic registration is in Good Standing.
sossos_domestic_sub_statusWarningPending ActiveThe domestic registration is Pending Active.
sossos_domestic_sub_statusWarningPending InactiveThe domestic registration is Pending Inactive.
sossos_domestic_sub_statusWarningNot Provided by StateThe domestic registration is Not Provided by State.
sossos_domestic_sub_statusFailureNot in Good StandingThe domestic registration is Not in Good Standing.
sossos_domestic_sub_statusFailureDissolvedThe domestic registration is Dissolved.

Industry Classification Review Task Outcomes

categorykeystatussub_labelmessage
industryindustrySuccessNo HitsThis business likely does not operate in a high risk industry
industryindustryFailureHitsWe believe the company may operate in “X” industry

Entity Type Review Task Outcomes

In order to use the entity type review tasks, you must submit an entity type with the business's formation. See the create a business endpoint for more details.

categorykeystatussub_labelmessage
formationentity_type_matchSuccessVerifiedThe submitted entity type matches the entity type on the domestic registration
formationentity_type_matchFailureUnverifiedThe submitted entity type does not match the entity type on the domestic registration
categorykeystatussub_labelmessage
namename_and_entity_typeSuccessVerifiedThe submitted business name and entity type match the registration name
namename_and_entity_typeFailureUnverifiedThe submitted business name and entity type do not match the registration name