For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact SalesGet Support
HomeGuidesAPI reference
HomeGuidesAPI reference
  • Get started
    • Quickstart—Verify a Business
    • Quickstart—Register an entity for payroll taxes
    • Learn how Middesk works
      • Lifecycle of a Business
      • How Middesk matches data
      • Review insights
      • Use rulesets or policies
      • Create orders
      • Use the sandbox and production environments
      • Use the enhanced sandbox
    • Security
    • Changelog
  • Build with Middesk
    • Get your API keys
    • Understand API changes
    • Status codes and errors reference
    • Implement webhooks
    • Secure webhooks
    • Use GraphQL
    • Connect MCP
  • Verify a business (KYB)
    • Verify TIN
    • Verify name and address
    • Verify Secretary of State status
    • Verify owners and officers
    • Screen for sanctions and watchlists
    • Search for adverse media
    • Search for Politically Exposed Persons
    • Implement KYC
    • Discover connections
    • Evaluate online presence
    • Assess credit risk
    • Accelerate onboarding
    • Monitor business activity
    • Manage business entities
    • Work with agents
LogoLogo
Contact SalesGet Support
On this page
  • Create an order
  • Order lifecycle
  • Available order types
  • Verification orders
  • Background check orders
  • Litigation and financial orders
  • People-focused orders
  • Order dependencies
Get startedLearn how Middesk works

Create orders

Was this page helpful?
Previous

Use the sandbox and production environments

Next
Built with

Orders specify what action should be performed on a business. This might be as simple as a verification or as involved as search for litigations.

A business always has one or more Orders associated with it.

Create an order

You can create an Order through the API or in the Dashboard. Through both routes you can create an Order when you create the Business object in your Middesk account or as a follow-up step on an existing Business object.

Each Order has two fields:

  • product specifies the type of Order to be fulfilled
  • subproducts are optional parameters that modify the request

Orders align with Middesk’s products, so a product might be business_verification_verify with no subproducts modifier or website with a web_analysis modification (as the subproduct).

If no orders are specified you create a Business, Middesk infers the orders to add based on the fields present in the request. The default is a Business Verification - Verify report. If a website is submitted, a Website Order is added. If a person is submitted with KYC fields, depending on the account settings, a KYC Order is added.

Create an Order through the API
Create an Order in the Dashboard

To create an Order through the API:

  • Use the orders array when creating a Business with a POST /businesses call
  • Use a POST /businesses/{business_id}/orders API call to add an Order to an existing Business

Order lifecycle

Orders progress through the following statuses:

StatusDescription
createdThe order has been created.
pendingMiddesk is processing the order.
auditedThe order has been reviewed and verified by Middesk.
completedThe order has been completed.
approvedThe order results have been approved.
rejectedThe order results have been rejected.

Available order types

Verification orders

ProductDescription
business_verification_verifyVerify business registration and identity details
enhanced_screeningsScreen businesses and individuals against watchlists and sanctions
websiteAnalyze web presence and classify industry
email_riskEvaluate email addresses submitted on a business for validity, deliverability, and other risk signals

Background check orders

ProductDescription
kycKnow Your Customer verification
kyc_doc_vKYC with document verification
documentsRetrieve Articles of Incorporation and Certificates of Good Standing

Litigation and financial orders

ProductDescription
adverse_mediaScreen for negative news and media coverage
bankruptciesSearch for business bankruptcies
litigationsSearch for business litigation records
tax_liensSearch for federal and state tax liens
ucc_liensSearch for UCC liens
liensSearch for all lien types

People-focused orders

ProductDescription
people_bankruptciesSearch for individual bankruptcies
people_criminal_historySearch for criminal history records
people_tax_liensSearch for individual tax liens
people_ucc_liensSearch for individual UCC liens
people_litigationsSearch for individual litigation records

Order dependencies

Most order types require a business_verification_verify order to be present first. This establishes a prerequisite chain for order fulfillment.

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