Sous Chef API
Sous Chef Ordering API
Documentation

Quickstart

API keys are not issued publicly. To get one, contact support@yoursouschef.com. The same address registers the webhook url we deliver to. The key is shown once; store it as a secret.

Examples call production, https://api.yoursouschef.com. The sandbox is https://api.dev.yoursouschef.com: same paths, same headers, its own keys.

1. List your stores

POST https://api.yoursouschef.com/ordering/stores/fetchStores
x-api-key: otk_…
content-type: application/json

{ "limit": 100 }

Each store carries a code. That code is what every other operation takes as storeCode.

2. Read a store's menu

POST https://api.yoursouschef.com/ordering/menus/fetchMenu

{ "storeCode": "<code>" }

Item and modifier ids in the reply are what createOrder takes.

3. Send an order

POST https://api.yoursouschef.com/ordering/orders/createOrder

{
  "storeCode": "<code>",
  "platformOrderId": "your-order-123",
  "fulfillment": "pickup",
  "items": [
    { "itemId": "<MenuItem.id>", "name": "Margherita", "quantity": 1, "unitPrice": 1250, "totalPrice": 1250 }
  ],
  "subtotal": 1250,
  "total": 1250
}

200 means we queued the order. The restaurant's decision arrives as an order.created or order.rejected webhook at your registered url (order.created is not sent yet, coming before sandbox access). See Concepts → Order intake.