Orders

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.

PropertyTypeDescription
packagestringThe type of order. The possible options can be found below.
subproductsstring[]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 PackageSubproducts (Optional)DependenciesRequired Business Attributes
adverse_mediabusiness_verification_verify
bankruptciesbusiness_verification_verify
business_verification_qualifyname
address
business_verification_verifyname
address
documentsArticles of Incorporation, Certificate of Good Standingbusiness_verification_verify
enhanced_screeningsbusiness_verification_verify
kycPerson fields:
first_name
last_name
dob
ssn
address_line1
city
state
postal_code
email
phone_number
kyc_doc_vPerson fields:
document_uuid

- required KYC fields
litigationsbusiness_verification_verify
people_bankruptciesbusiness_verification_verifyPerson fields: first_name last_name
ssn
tax_liensbusiness_verification_verify
ucc_liensucc_documentsbusiness_verification_verify
websiteWebsite fields:
url

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 PackageSubproducts (Optional)DependenciesRequired Business AttributesDeprecating?
adverse_mediaidentity
bankruptciesidentity
documentsArticles of Incorporation, Certificate of Good Standingidentity
enhanced_screeningsidentity
kycPerson fields:
first_name
last_name
dob
ssn
address_line1
city
state
postal_code
email
phone_number
kyc_doc_vPerson fields:
document_uuid

- required KYC fields
identityname
address
yes
litigationsidentity
people_bankruptciesidentityPerson fields: first_name last_name
ssn
liensucc_documentsidentityyes
websiteWebsite fields:
url

Order Status

statusdescription
createdThe order has been successfully created and is about to start processing.
pendingThe order is being processed.
auditedThe order has been flagged for review by Middesk's internal analyst team.
completedThe order has been completed.
approvedThe order has been approved.
rejectedThe 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: email
  • 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 website URL is provided, a Website Order will order a search for details around the website. Regardless of whether a website URL is provided, the Website Order will classify the industry associated with a particular Business. 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.