> 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.

# Use the enhanced sandbox

> Create custom test scenarios with configurable verification outcomes to test your Middesk integration through the Dashboard.

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.

> **Warning**
>
> The enhanced sandbox is not enabled by default. Contact your account manager or [contact sales](https://www.middesk.com/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.

> **Info**
>
> 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](/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](https://www.middesk.com/contact-sales) to inquire about access.