Order object | Middesk

This page describes the order object, which represents a request for verification data on a business. Orders are associated with specific packages (verification products) and track the status of data retrieval.

Example JSON response

1 {
2   "object": "order",
3   "id": "f074244d-5cf3-4703-950a-73a7d54ee555",
4   "package": "identity",
5   "status": "completed",
6   "business_id": "b3638510-87ec-425e-bdaa-ad6e48dec871",
7   "subproducts": ["web_analysis", "industry_classification"],
8   "created_at": "2024-01-30T23:49:01.100Z",
9   "updated_at": "2024-01-30T23:49:05.200Z"
10 }

Order attributes

Attribute	Type	Description
`object`	string	The object type. Always `order`.
`id`	string (uuid)	The unique identifier for the order.
`package`	string	The verification package requested. Possible values are: `identity`, `liens`, `adverse_media`, `bankruptcies`, `business_enrichment`, `documents`, `enhanced_screenings`, `kyc_doc_v`, `kyc`, `litigations`, `people_litigations`, `people_bankruptcies`, `people_tax_liens`, `people_criminal_history`, `tin`, `website`, `business_verification_qualify`, `business_verification_verify`, `tax_liens`, `ucc_liens`.
`status`	string	The current status of the order. Possible values are: `created`, `pending`, `audited`, `completed`, `approved`, `rejected`.
`business_id`	string (uuid)	The unique identifier of the business associated with this order.
`subproducts`	string[]	Additional subproducts included with this order. Possible values are: `articles_of_incorporation`, `certificate_of_good_standing`, `articles_of_incorporation_with_fallback`, `ucc_documents`, `web_analysis`, `industry_classification`.
`created_at`	timestamp	The timestamp when the order was created.
`updated_at`	timestamp	The timestamp when the order was last updated.

Order statuses

Status	Description
`created`	The order has been created but processing has not started.
`pending`	The order is currently being processed.
`audited`	The order has been audited and is awaiting final review.
`completed`	The order has been completed and all data has been retrieved.
`approved`	The order has been approved after review.
`rejected`	The order has been rejected after review.

Package types

Package	Description
`identity`	Core business identity verification including name, address, and registration data.
`liens`	Search for UCC liens and tax liens associated with the business.
`adverse_media`	Screen for negative news coverage about the business.
`bankruptcies`	Search for bankruptcy filings associated with the business.
`business_enrichment`	Enrich business data with additional information.
`documents`	Retrieve business formation documents.
`enhanced_screenings`	Perform enhanced screening checks including watchlists.
`kyc`	Know Your Customer verification for business principals.
`kyc_doc_v`	KYC with document verification.
`litigations`	Search for litigation records involving the business.
`people_litigations`	Search for litigation records involving business principals.
`people_bankruptcies`	Search for bankruptcy filings involving business principals.
`people_tax_liens`	Search for tax liens involving business principals.
`people_criminal_history`	Search for criminal history of business principals.
`tin`	Verify the business Tax Identification Number.
`website`	Analyze the business website.
`business_verification_qualify`	Quick qualification check for the business.
`business_verification_verify`	Full business verification.
`tax_liens`	Search for tax liens associated with the business.
`ucc_liens`	Search for UCC liens associated with the business.

Get a demo

Contact your account manager or contact sales to inquire about access.