Developer Platform v1.4

Modern REST & WebSocket
APIs for Hospitality.

Build custom kiosks, delivery integrations, ERP syncs, and proprietary analytics on top of the TestyGrid real-time engine.

Authentication Quickstart
curl -X GET "https://api.testygrid.com/v1/orders" \
  -H "Authorization: Bearer tg_live_99a8b7c6d5e4" \
  -H "Content-Type: application/json"

Core REST Endpoints

GET/v1/orders

Retrieve active dining, takeaway, and delivery orders with real-time station statuses.

Sample 200 OK Response:
{
  "data": [
    {
      "id": "ord_884920",
      "order_number": "ORD-092",
      "table": "T-04",
      "status": "preparing",
      "items": [
        { "name": "Truffle Wagyu Burger", "qty": 2, "price": 45.50 }
      ],
      "total": 45.50,
      "created_at": "2026-08-12T19:30:00Z"
    }
  ]
}
POST/v1/orders

Inject new orders directly into POS & KDS from external delivery or mobile channels.

Sample 200 OK Response:
{
  "success": true,
  "order_id": "ord_992104",
  "kds_station_routing": ["hot_kitchen", "bar"],
  "estimated_prep_time_mins": 14
}
GET/v1/inventory/depletion

Query real-time stock levels, depletion rates, and pending supplier purchase orders.

Sample 200 OK Response:
{
  "items": [
    { "sku": "ING-TRUFFLE-OIL", "name": "White Truffle Oil", "stock_grams": 450, "reorder_threshold": 500, "status": "low_stock" }
  ]
}

Real-Time Webhook Events

Subscribe your endpoints to live dining room events. We support HMAC-SHA256 signature verification and automatic exponential backoff retries.

order.created

Fires when a customer or staff initiates a ticket

order.item_ready

Fires when a kitchen station bumps a dish

table.vacated

Fires when bill is settled and table is cleared

inventory.depleted_below_min

Fires when raw ingredient reaches reorder trigger