Sign in

v1

latestOpenAPI 3.0.32026-07-1712816.3 KB
orders

Create a new order

Places a new order with burgers (requires userId). French fries are included as a side for every burger order.

Limitations:

  • Maximum 5 active orders per user
  • Maximum 50 burgers total per order
post/orders

Request body

userIdstring required
nicknamestring

Optional nickname for the order (only first 10 chars displayed)

Example request

{
  "userId": "user123",
  "nickname": "John",
  "items": [
    {
      "burgerId": "burger-1",
      "quantity": 1,
      "extraToppingIds": [
        "topping-1",
        "topping-2"
      ]
    }
  ]
}

Response

Order created successfully

idstring required
createdAtstring date-time required
estimatedCompletionAtstring date-time required
completedAtstring date-time

ISO date string for when the order was completed (undefined until completed)

nicknamestring

Optional nickname for the order

totalPricenumber float required
status'pending' | 'in-preparation' | 'ready' | 'completed' | 'cancelled' required
  • pending: Order has been created but not yet started - in-preparation: Order is being prepared - ready: Order is ready for pickup - completed: Order has been picked up - cancelled: Order has been cancelled

Example response

{
  "items": [
    {
      "burgerId": "burger-1",
      "quantity": 1,
      "extraToppingIds": [
        "topping-1",
        "topping-2"
      ]
    }
  ]
}