A Business always has one or more Orders. Orders can be added to a Business through two API endpoints: at the time of business creation through the business creation endpoint, and after a business has completed through the order creation endpoint. Each Order you create on a Business has a package attribute which specifies a Middesk product you want fulfilled for your submitted business. Additional Orders can be added to a Business after the Business has completed through the Orders endpoint.
If no Orders are specified when creating a Business, Middesk will infer the orders to add to the business based on the fields present in the request. The default will be to run a Business Verification - Verify report. If a website is submitted, a Website Order will be added to the Business. Similarly, if a person is submitted with KYC fields, depending on the account settings, a KYC Order will be added.
If Orders are specified when the Business is created, the requirements for the submitted Order should be satisfied. E.g. Document orders require an Business Verification - Verify order to be present as well; the requirements for each order type are specified below.
All Order types require that your account is configured to allow such orders. Contact Sales to inquire about access to these products.
| Property | Type | Description |
|---|---|---|
| package | string | The type of order. The possible options can be found below. |
| subproducts | string[] | Optional. Some Order types have different functionality based on the provides subproducts. Order types and possible subproducts can be found below. |
Current Order Types
If your Order form/Contract/Invoices have Identity or Liens or your account was created before August 2023, you likely should be using our old Order types found here.
| Order Package | Subproducts (Optional) | Dependencies | Required Business Attributes |
|---|---|---|---|
| adverse_media | business_verification_verify | ||
| bankruptcies | business_verification_verify | ||
| business_verification_qualify | nameaddress | ||
| business_verification_verify | nameaddress | ||
| documents | Articles of Incorporation, Certificate of Good Standing | business_verification_verify | |
| enhanced_screenings | business_verification_verify | ||
| kyc | Person fields:first_namelast_namedobssnaddress_line1citystatepostal_codeemailphone_number | ||
| kyc_doc_v | Person fields:document_uuid- required KYC fields | ||
| litigations | business_verification_verify | ||
| people_bankruptcies | business_verification_verify | Person fields: first_name last_namessn | |
| tax_liens | business_verification_verify | ||
| ucc_liens | ucc_documents | business_verification_verify | |
| website | web_analysis, industry_classification | nameaddressWebsite fields: url (only required if web_analysis is requested) |
Old Order Types
There is some overlap between the new and the older order types, however, we are moving away from a couple of the order types denoted below. Additionally, these orders can all be used together and the orders above can all be used together, but a business can only have old or new order types.
| Order Package | Subproducts (Optional) | Dependencies | Required Business Attributes | Deprecating? |
|---|---|---|---|---|
| adverse_media | identity | |||
| bankruptcies | identity | |||
| documents | Articles of Incorporation, Certificate of Good Standing | identity | ||
| enhanced_screenings | identity | |||
| kyc | Person fields:first_namelast_namedobssnaddress_line1citystatepostal_codeemailphone_number | |||
| kyc_doc_v | Person fields:document_uuid- required KYC fields | |||
| identity | nameaddress | yes | ||
| litigations | identity | |||
| people_bankruptcies | identity | Person fields: first_name last_namessn | ||
| liens | ucc_documents | identity | yes | |
| website | Website fields:url |
Order Status
| status | description |
|---|---|
created | The order has been successfully created and is about to start processing. |
pending | The order is being processed. |
audited | The order has been flagged for review by Middesk's internal analyst team. |
completed | The order has been completed. |
approved | The order has been approved. |
rejected | The order has been rejected. |
Adverse Media
The Adverse Media Order will search for online news and media containing references to the Business and People associated with the Business. The Adverse Media object will return various risk categories and their scores for each Person and Business Name along with the media sources that were found. There are a number of different parameters that can tune the behavior of this Order. These settings can be found in the Settings page of the dashboard.
Bankruptcies Order
The Bankruptcies Order will perform a search to find any bankruptcies associated with the business. It will not search for Bankruptcies on the People associated with the Business, if People Bankruptcies are also needed, place a People Bankruptcy Order.
For more information about the responses of a Bankruptcy Order, check out Bankruptcy.
Business Verification - Qualify Order
A lighter version of our Business Verification - Verify product. This Order will find the associated SOS (Secretary of State) Registrations and return insights around name verification, address verification, person verification, SOS registration status, and time in business.
For more information about the responses of a Business Verification - Qualify Order, check out the examples under Business.
Business Verification - Verify Order
A Business Verification - Verify Order will allow for fetching of SOS (Secretary of State) Registrations, and generating a full Identity report, complete with name verification, address verification, tin verification, SOS details and more. If an Order is not specified when creating a business, and a name and address are submitted and this package is enabled for the account, a Business Verification - Verify Order will be created.
For more information about the responses of a Business Verification - Verify Order, check out the examples under Business.
Enhanced Screenings
An Enhanced Screenings order will allow a customer to be screen the Business against Global Watchlists and perform a Politically Exposed Person screening on the officers of the Business. This order type can be ordered alongside an Business Verification - Verify report (or Identity report) or after the Business Verification - Verify Order has completed processing.
For more information about the the Watchlist response check out Watchlist. For more details on the Politically Exposed Person Screening, check out Politically Exposed Persons.
Documents Order
A Document Order will order SOS Documents for a Business. This type of Order is dependent upon a Business Verification - Verify Order and can be ordered at the time of Business creation, or after a Business Verification - Verify Order has been completed for the Business.
Supported SOS documents are Articles of Incorporation (also called Articles of Formation or Articles of Organization) and Certificates of Good Standing. If no subproducts are specified, only Articles of Incorporation will be ordered.
For more information about the responses of a Document Order, check out Document.
KYC Order
A KYC Order will submit a KYC Order to Socure for each person with PII fields submitted to Middesk when you create a business. If an Order is not specified when creating a business and a person with Socure fields has been provided, a KYC Order will be created.
For more information about the response of a KYC Order, check out KYC.
KYC Order Requirements
A KYC Order must have one (or more) people that have Socure's Required PII fields as outlined on the People section of Create a Business page:
- Required:
first_name- Required:
last_name- Required:
dob- Required:
ssn- Required:
address_line1- Optional:
address_line2- Required:
city- Required:
state- Required:
postal_code- Required:
- Required:
phone_number- Optional:
device_session_id
KYC with Document Verification Order
A KYC with Document Verification Order allows a customer to upload government-issued ID to Socure. Socure confirms the authenticity of the document and verify that it matches the PII extracted from the ID against the submitted person information.
Litigations Order
A Litigations Order will order a search for legal cases associated with a particular Business. This type of Order is dependent upon an Identity Order. It can be ordered at the time of Business creation or after an Identity Order has been completed for the Business.
For more information about the responses of a Litigations Order, check out Litigations.
People Bankruptcies Order
A People Bankruptcies Order will search for bankruptcies associated with all people on the business with the required information. This type of Order is dependent upon an Identity Order and can be ordered at the time of Business creation, or after an Identity Order has been completed for the Business.
Website Order
If the web_analysis subproduct is specified, the website URL must be provided. The Website Order will order a search for details around the website.
If the industry_classification subproduct is specified, regardless of whether a website URL is provided, the Website Order will classify the industry associated with a particular Business.
If no subproducts are specified and a website URL is provided, both web_analysis and industry_classification will be ordered. If no subproducts are specified and no website URL is included, only. industry_classification will be ordered.
This type of Order isn't dependent upon an Identity Order, and it can be ordered at the time of Business creation or as a separate order either before or after the creation of a Business.
For more information about the responses of a Website Order, see Website.