Skip to main content

​
What the sandbox is

The sandbox is a read-only demo environment with a fully modeled building. It has real equipment hierarchies, sensor points, and spatial data, so you can run queries immediately without connecting your own building. The demo building includes:
  • Multiple wings and floors with HVAC zones
  • AHUs, VAVs, FCUs, pumps, and heat exchangers
  • Temperature, pressure, humidity, and airflow sensors
  • Equipment chains with feeds relationships you can traverse

​
Access the sandbox

1

Sign in or create an account

Go to app.betacit.com and sign in. If you don’t have an account, sign up. The sandbox is available on all plans.
2

Switch to the sandbox site

In the site selector, choose Demo Building (Sandbox). This is a shared, read-only site that resets periodically.
3

Copy your site ID

The sandbox site ID is shown in your dashboard. You’ll need it for every query.
export TACIT_API_KEY="your-api-key"
export SITE_ID="sandbox-site-id"

​
Try a query

List all HVAC equipment in the demo building: 
curl -X POST https://app.betacit.com/graphql \
  -H "Authorization: Bearer $TACIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "{ equipment(siteId: \"'$SITE_ID'\", is: \"HVAC_Equipment\") { name type location { name } } }"
  }'
Response
{
  "data": {
    "equipment": [
      { "name": "TE01-XX-AHU-001", "type": "AHU", "location": { "name": "Tower East" } },
      { "name": "TW01-LBR-RPC-01", "type": "VAV", "location": { "name": "Library" } },
      { "name": "TW01-XX-AHU-001", "type": "AHU", "location": { "name": "Tower West" } }
    ]
  }
}

​
What you can do in the sandbox

The sandbox supports all read queries, the same API surface as production:
  • Browse buildings, floors, wings, and zones
  • Query equipment by Brick class (is: "AHU", is: "Temperature_Sensor")
  • Traverse upstream and downstream equipment chains
  • Cross-reference IFC model elements with entityByIfcId
  • Fetch point metadata and current values
The sandbox is read-only. REST endpoints that create, update, or delete resources will return 403 Forbidden.

​
Next steps

Quickstart

Connect your own building and run queries against real data.

Query your first building

A deeper walkthrough with progressively complex query patterns.