Use the enhanced sandbox

Testing with the standard sandbox requires memorizing specific business names and input values to trigger specific verification outcomes. The enhanced sandbox removes that friction. Define your own test businesses, select expected results, and save reusable scenarios from the Dashboard.

The enhanced sandbox is not enabled by default. Contact your account manager or contact sales to request access and migrate any preexisting test cases. Once enabled, the enhanced sandbox replaces the standard sandbox.

How enhanced sandbox mode works

The enhanced sandbox is built around three core concepts:

Scenario templates—Pre-configured verification outcome sets (for example, all verified, TIN mismatch, watchlist hit). Select a template and the sandbox delivers that result consistently.
Custom test businesses—Define business details (name, address, TIN, entity type, officers) instead of using hardcoded trigger values. Combine multiple conditions in a single scenario, such as a business in good standing with a TIN mismatch, or an approximate address match with a watchlist hit.
Scenario library—Saved scenarios stored in your account, accessible to your entire team from Settings → Sandbox configuration. Create, view, edit, and delete scenarios as needed.

The enhanced sandbox simulates all data without performing real compliance checks. Scenarios are deterministic—the same configuration produces the same verification results every time, so you can build repeatable test workflows and debug without chasing changing data.

The enhanced sandbox does not support API access. Create and manage all scenarios through the Dashboard. For API-based sandbox testing, refer to the standard sandbox trigger values in Use the sandbox and production environments.

Pre-built scenario templates

The enhanced sandbox includes ready-to-use templates for common verification outcomes. Use these pre-built scenario templates to simulate specific outcomes on test businesses in your account.

Scenario	Simulation outcomes
Happy path	All verifications pass
TIN mismatch	Tax ID does not match business records
Similar name match	Close but non-exact business name
Name not found	Business missing from state records
Inactive or dissolved	Business is no longer active
Open UCC liens	Outstanding UCC filings
Federal tax lien	Federal tax lien present
Bankruptcy	Chapter 11 filing on record
Watchlist hit	Sanctions list match
Active litigation	Ongoing lawsuit
Prohibited industry	High-risk industry classification
High-quality website	Clean, well-established web presence
Low-quality website	Suspicious or low-trust website
Offline website	Website not reachable

Simulated outcomes supported by verification type

The enhanced sandbox allows you to create simulated verification outcomes across Middesk’s supported verification types, so you can reliably reproduce specific scenarios without using real data. If a case is not covered by a pre-built test scenario template, you can build your own scenario by combining supported outcomes and reusing it for consistent end-to-end testing.

Verification type	Simulated outcomes
Business registration	Active, inactive, dissolved, not found, similar name match
TIN and EIN	Match, mismatch, unknown, sole proprietor
Address	Verified, approximate, incomplete, CMRA, registered agent, deliverable, undeliverable
Liens and legal records	UCC, federal tax, state liens; open, pending, or closed
Bankruptcy	Chapter 7, Chapter 11, Chapter 13
Litigation	Civil, contract disputes; open or closed cases
Watchlist and OFAC screening	Sanctions matches, aliases, associated programs
Adverse media	High risk, moderate risk, low risk
Industry classification	NAICS codes, MCC codes, prohibited industries
Website and online presence	Domain quality, domain age, social profiles, risky keywords

How to use enhanced sandbox mode

Switch to sandbox mode

In the Dashboard, switch to the sandbox environment using the environment selector.

Open sandbox configuration

Navigate to Settings → Sandbox configuration.

Select a scenario with business details

Click the Create new example button, select a scenario template, and input business details to pair with the scenario.

Submit a verification

Click the Place order button in sandbox mode, select the business from the dropdown, and order the verification on that business. The system automatically applies the pre-configured business details.

Review results

Middesk returns simulated verification results that match the selected scenario. Validate that your workflow handles the outcome correctly.

Get a demo

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