# Synthetic sandbox response examples

These examples use only the reviewed `sandbox-2026-09-v1` vocabulary. They are
illustrative API responses, not exported production records. IDs, cursors,
dates, counts, and histories are synthetic and may differ between integrations.

Use the examples to build parsers and fixtures. Validate real responses against
the linked JSON Schema, accept documented nullable values, and never copy a
sandbox ID, cursor, certificate, or database row into production.

## Complete order snapshot

The order separates the vehicle family (`model`) from its trim (`variant`).
`configuration` contains the resolved readable values while `option_codes`
retains the reviewed raw configuration vocabulary. `delivery_center` is always
present and every non-null sandbox center ends in ` - SANDBOX`.

```json
{
  "resource": {"type": "order", "id": "ord_sb_A7mQ2pL9xK4v"},
  "revision": 42,
  "history_complete": true,
  "data": {
    "model": "Model Y",
    "variant": "Long Range AWD",
    "option_codes": ["APBS", "IPB0", "MDLY", "MTY03", "PN00", "TW01", "WY20P"],
    "configuration": {
      "color": "Quicksilver",
      "wheels": "Induction 20-inch",
      "interior": "All Black",
      "autopilot": "Autopilot",
      "tow_hitch": true
    },
    "delivery_center": "Düsseldorf-Holthausen - SANDBOX",
    "country": "DE",
    "status": "in_transit"
  }
}
```

Download the [complete order JSON](https://integration.boringordertracker.com/docs/examples/sandbox-order.json)
and its [order response schema](https://integration.boringordertracker.com/schemas/order-response.json).

## Existing-vehicle snapshot

```json
{
  "resource": {"type": "vehicle", "id": "veh_sb_R8nW3cT6zP2k"},
  "revision": 118,
  "history_complete": true,
  "data": {
    "model": "Model 3",
    "variant": "Long Range AWD",
    "option_codes": ["APBS", "IWW", "MDL3", "MT322", "PPSW", "TW00", "W40B"],
    "configuration": {
      "color": "Pearl White Multi-Coat",
      "wheels": "Photon 18-inch",
      "interior": "Black and White",
      "autopilot": "Autopilot",
      "tow_hitch": false
    },
    "battery_level": 74,
    "battery_range_km": 412.7,
    "odometer_km": 18452.6,
    "software_version": "2026.33.4"
  }
}
```

Download the [complete vehicle JSON](https://integration.boringordertracker.com/docs/examples/sandbox-vehicle.json)
and its [vehicle response schema](https://integration.boringordertracker.com/schemas/vehicle-response.json).

## Delta sync upsert

An upsert replaces the stored allowed projection for the random resource ID.
Treat its `data` object with the same field rules as the corresponding detail
response; do not derive a trim or color from a raw code when BOT returns `null`.

```json
{
  "items": [
    {
      "revision": 741,
      "operation": "upsert",
      "event": "resource.updated",
      "occurred_at": "2026-09-01T00:00:00Z",
      "connection_id": "conn_sb_N4jK8sQ2mL7x",
      "resource": {"type": "order", "id": "ord_sb_A7mQ2pL9xK4v"},
      "data": {
        "model": "Model Y",
        "variant": "Long Range AWD",
        "delivery_center": "Düsseldorf-Holthausen - SANDBOX"
      }
    }
  ],
  "next_cursor": "cur_sb_0000000000000000000741",
  "has_more": false
}
```

Download the [complete sync JSON](https://integration.boringordertracker.com/docs/examples/sandbox-sync.json)
and its [sync response schema](https://integration.boringordertracker.com/schemas/sync-response.json).

## Complete allowed history

```json
{
  "resource": {"type": "order", "id": "ord_sb_A7mQ2pL9xK4v"},
  "items": [
    {
      "sequence": 1,
      "field": "delivery_center",
      "operation": "set",
      "old_value": null,
      "new_value": "Düsseldorf-Holthausen - SANDBOX",
      "event_at": "2026-04-14T08:02:00Z",
      "observed_at": "2026-04-14T08:02:00Z",
      "data_quality": "authoritative"
    },
    {
      "sequence": 2,
      "field": "configuration.color",
      "operation": "set",
      "old_value": null,
      "new_value": "Quicksilver",
      "event_at": "2026-04-14T08:03:00Z",
      "observed_at": "2026-04-14T08:03:00Z",
      "data_quality": "authoritative"
    }
  ],
  "next_cursor": "hcur_sb_0000000000000000000004",
  "has_more": false,
  "history_complete": true
}
```

Download the [complete history JSON](https://integration.boringordertracker.com/docs/examples/sandbox-history.json)
and its [history response schema](https://integration.boringordertracker.com/schemas/history-response.json).

## Privacy-thresholded statistics

Statistics return aggregate cells only. A missing cell is suppressed or absent;
it is not zero. Use `orders_total` for the independently thresholded country
total and never sum surviving breakdown cells to reconstruct a total.

```json
{
  "generation_id": "stats_sb_20260901T000000Z",
  "published_at": "2026-09-01T00:00:00Z",
  "minimum_cell_size": 5,
  "data": {
    "orders_total": [{"dimensions": {"country": "DE"}, "value": 342}],
    "by_model_variant_status": [{
      "dimensions": {
        "country": "DE",
        "model": "Model Y",
        "variant": "Long Range AWD",
        "status": "in_transit"
      },
      "value": 27
    }],
    "by_delivery_center": [{
      "dimensions": {
        "country": "DE",
        "delivery_center": "Düsseldorf-Holthausen - SANDBOX"
      },
      "value": 54
    }],
    "by_color": [{
      "dimensions": {"country": "DE", "color": "Quicksilver"},
      "value": 31
    }]
  }
}
```

Download the [complete statistics JSON](https://integration.boringordertracker.com/docs/examples/sandbox-statistics.json)
and its [statistics response schema](https://integration.boringordertracker.com/schemas/statistics-response.json).

## Fields that never appear

The examples deliberately contain no VIN, real order number, BOT account ID,
contact/address/payment/financing data, provider credentials, raw provider
response, GPS position, presence-sensitive live state, or cross-integration ID.