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
  • Business status
  • Other core Business properties
Get startedLearn how Middesk works

Lifecycle of a Business

Was this page helpful?
Previous

How Middesk matches data

Next
Built with

The Middesk API operates on a single primary object: a Business. A Business object is the Middesk representation of the business entity that you engage with in your platform.

As in the real world, a Business is not a static entity. When you create and manage Business objects in your Middesk account, pay attention to the Business lifecycle and its key properties.

The lifecycle of a Business object in Middesk has three stages:

1

Submission

You—“client” in the image below—create the Business in Middesk.

2

Verification

Middesk researches a business to appropriate depths.

3

Approval

You decide what happens next, based upon Middesk’s verification results.

Verification flow · 3 stages
How a business moves through Middesk
Lifecycle of a Business

A business moves through three stages: Submission (client submits business), Verification (Middesk processes the business, either auto-resolving or routing to an analyst, then delivers insights), and Approval (client reviews and approves or rejects).

01 · SubmissionClientSubmits BusinessopenSubmit Business: POST /v1/businesses02 · VerificationMiddeskProcesses BusinessopenPath AAuto resolvedpendingPath BAnalyst in the Loopin_auditMiddesk · ResultDelivers InsightsVerification findings ready for reviewin_reviewProcess business.updatedevents via Webhooks03 · ApprovalClientReviews businessin_reviewClientReviews businessrejectedClientReviews businessapproved

Middesk tracks the lifecycle of a Business, and always provides auditable records of how a Business object changes over time.

Business status

The Business object has a status property that reflects the Business’ state in the Middesk system. The value of this property changes during the lifecycle, so you can build workflows tailored to your platform.

StatusDescription
openThe Business has been created, but Middesk has not yet begun verification.
pendingMiddesk has begun but not yet completed verification.
in_auditMiddesk is required to audit and ensure the quality of this Business.
in_reviewThe Business is ready to be reviewed by you. Your action items are listed in the review property.
approvedYou approved the Business.
rejectedYou rejected the Business.

Other core Business properties

Along with status, there are several key properties on the Business object to watch.

When a Business status changes to in_review, Middesk has completed its investigation into that Business and is now ready for you to examine the insights. These insights come from the Business’ review property.

A Business also has numerous resource-related properties, including:

  • name
  • addresses
  • tin
  • website

These resource properties represent people, places, and things associated with the business. They provide additional evaluation factors in various compliance scenarios or to drive different programmatic workflows in your implementation.

Middesk can help you monitor businesses to watch for relevant activity after the approval stage.

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