> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.middesk.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.middesk.com/_mcp/server.

# Order object

> Lists the contents of an order object.

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

**`Example JSON response`**

```json title="Example JSON response"
{
  "object": "order",
  "id": "f074244d-5cf3-4703-950a-73a7d54ee555",
  "product": "identity",
  "package": "identity",
  "status": "completed",
  "business_id": "b3638510-87ec-425e-bdaa-ad6e48dec871",
  "subproducts": ["web_analysis", "industry_classification"],
  "created_at": "2024-01-30T23:49:01.100Z",
  "updated_at": "2024-01-30T23:49:05.200Z"
}
```

## Order attributes

| Attribute        | Type              | Description                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ---------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `object`         | string            | The object type. Always `order`.                                                                                                                                                                                                                                                                                                                                                                                                  |
| `id`             | string (uuid)     | The unique identifier for the order.                                                                                                                                                                                                                                                                                                                                                                                              |
| `product`        | string            | The product type 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_ucc_liens`, `people_criminal_history`, `tin`, `website`, `business_verification_qualify`, `business_verification_verify`, `tax_liens`, `ucc_liens`. |
| `package`        | string            | Equivalent to `product`. Included for backward compatibility.                                                                                                                                                                                                                                                                                                                                                                     |
| `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`.                                                                                                                                                                                         |
| `completed_at`   | timestamp \| null | The timestamp when the order was completed.                                                                                                                                                                                                                                                                                                                                                                                       |
| `monitoring`     | boolean           | Whether this order includes monitoring.                                                                                                                                                                                                                                                                                                                                                                                           |
| `requester`      | object            | Information about who initiated the order.                                                                                                                                                                                                                                                                                                                                                                                        |
| `requester.name` | string \| null    | The name of the requester.                                                                                                                                                                                                                                                                                                                                                                                                        |
| `requester.type` | string \| null    | The type of requester. Possible values: `account`, `user`, `api_key`.                                                                                                                                                                                                                                                                                                                                                             |
| `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.                     |

## Product types

| Product                         | 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_ucc_liens`              | Search for UCC 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](https://www.middesk.com/contact-sales) to inquire about access.