Simulations

What Are Sandbox Simulations?

Sandbox Simulations let you:

• Test your integration with realistic, production-like data.
• Simulate actions that happen in a ShipBob facility (e.g., shipping or delivering an order).
• Spot and fix issues before they happen in real life.

Think of it as a practice run—everything works like the real thing, but no actual shipments are made.

Step 1: Set Up Your Sandbox Environment

Before running simulations, make sure your sandbox account is ready. Follow our Sandbox Setup guide to:

• Sign up for a sandbox account
• Generate an API access token
• Use the correct base URLs
• Add payment methods and inventory (if needed)

Once setup is complete, continue with the steps below to simulate fulfillment events.

Step 2: Understand How Simulations Work

Here’s the basic flow:

1. Send a request to a Simulation API endpoint.
2. Get a simulation ID in response.
3. The simulation runs in the background (it might take a little time to complete).

Step 3: Pick an Action to Simulate

You can simulate the following:

• Mark a Shipment/Order as Shipped
• Mark a Shipment/Order as Delivered

To simulate other actions (e.g., returns, inventory changes), email techspecialists@shipbob.com.

Step 4: Prepare Your Shipment

Ensure your shipment is eligible:

• Inventory: Product must have stock in Cicero (IL) or Moreno Valley (CA).
• Packaging Preferences: Set in Merchant App → Products → [Your Product] → Packaging Preferences.
• Customs Info: Required for international shipments (set under Customs Information).
• Shipment Status: Must not be On-Hold, Exception, or Cancelled.
• Fulfillment Center: Inventory must exist in the selected location.
• Test Payment Method: Add dummy card in Dashboard → Payment Details using:
  • 4111 1111 1111 1111, any name, email, expiration, and CVC.

Step 5: Run a Simulation

Endpoint

1
POST https://sandbox-api.shipbob.com/2025-07/simulate/shipment

Authorization: Bearer {token}
Header: shipbob_channel_id (integer)

Request Body Schema

1
{
2
  "shipment_id": 11471145,
3
  "simulation": {
4
    "action": "ShipOrder",
5
    "delay": null,
6
    "next": {
7
      "action": "DeliverOrder",
8
      "delay": 10
9
    }
10
  }
11
}

Example Requests

Mark as Shipped:

1
{
2
  "shipment_id": 11471145,
3
  "simulation": {
4
    "action": "ShipOrder"
5
  }
6
}

Mark as Delivered:

1
{
2
  "shipment_id": 11471145,
3
  "simulation": {
4
    "action": "DeliverOrder"
5
  }
6
}

Ship then Deliver with Delay:

1
{
2
  "shipment_id": 11471145,
3
  "simulation": {
4
    "action": "ShipOrder",
5
    "delay": 5,
6
    "next": {
7
      "action": "DeliverOrder",
8
      "delay": 10
9
    }
10
  }
11
}

Step 6: Check Simulation Status

Use the simulation_id returned from your request to check its progress.

Endpoint

1
GET https://sandbox-api.shipbob.com/2025-07/simulate/status/{simulation_id}

Authorization: Bearer {token}

Response (200 OK)

1
{
2
  "simulation_id": "d1cdb...ef3",
3
  "entity_id": "11471145",
4
  "entity_type": "shipment",
5
  "simulation": {
6
    "action": "ShipOrder",
7
    "status": "Success",
8
    "message": "ShipOrder",
9
    "schedule_time": "2025-06-01T14:00:00Z",
10
    "next": {
11
      "action": "DeliverOrder",
12
      "status": "Pending",
13
      "message": "DeliverOrder",
14
      "schedule_time": "2025-06-01T14:10:00Z"
15
    }
16
  }
17
}

Simulation API Reference

FAQ