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 product
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 you don't specify any Orders when you create a Business, Middesk will infer the orders you want to add to your business based on the fields present in your request. We will run an Identity report in most cases. We'll assume you want a TIN Order if you've submitted a TIN and we'll assume you want a KYC order if you've submitted a person that has KYC fields.
If you do specify Orders when you create a Business you'll need to make sure that the requirements for the submitted order types are satisfied. E.g. Documents orders require an Identity order to be present as well; the requirements for each order type are specified below.
There are currently seven types of Orders: Identity, TIN, Documents, Liens, KYC, Website, and Litigations. Documents, Liens, KYC, and Litigations orders require that your account is configured to allow such orders. Contact Sales to inquire about access to these products.
Property | Type | Description |
---|---|---|
product | string | The type of order. May be tin , identity , documents , liens , kyc , website , or litigations . |
subproducts | string[] | Optional. The subproducts to order. Articles of Incorporation and Certificate of Good Standing are supported subproducts for documents orders. If this parameter is not passed for documents orders, it defaults to ['Articles of Incorporation'] . |
Identity Order
An Identity Order will allow for fetching of SOS (Secretary of State) Registrations, scraping websites, and generating a full Identity report. If an Order is not specified when creating a business, an Identity Order will be created by default.
Identity Order Requirements
A Business must have an address to qualify for an Identity Order.
Document Order
A Document Order will order SOS Documents for a Business. 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.
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.
Document Order Requirements
A Business must have an Identity Order in order to qualify for a Document Order.
TIN Order
A TIN Order only requires the name
and tin
of a Business and verifies if the submitted Business name matches the name associated with the TIN. This Order type can be ordered during Business creation or after a Business has been completed. If an Order is not specified when creating a business and a TIN has been provided, a TIN Order will be created.
For more information about the responses of a TIN Order, see Employer Identification Number
TIN Order Requirements
A Business must have a TIN to qualify for a TIN Order.
Lien Order
A Lien Order will order a search for active liens associated with a Business in the state in which the Business is registered. 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.
For more information about the responses of a Lien Order, see Lien.
Lien Order Requirements
A Business must have an Identity Order to qualify for a Lien Order.
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, see Litigations.
Litigations Order Requirements
A Business must have an Identity Order to qualify for a Litigations Order.
Website Order
A Website Order will order a search for details around the website and 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.
Website Order Requirements
A Website Order must have/be passed a website URL to run the Website and Industry Classification analyses.
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.
Note that a KYC Order is not dependent on an Identity Order; you can submit a KYC only Order if you don't want to run an Identity Order on a business.
For more information about the response of a KYC Order, see 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
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. |