Sign in

v1

latestOpenAPI 3.1.02026-07-1712816.6 KB
orders

Create a new order

Places a new order with pizzas (requires userId).

Order limits:

  • Maximum 50 pizzas per order
  • Maximum 5 active orders per user

The estimated completion time is as follows:

  • 3-5 minutes for 1-2 pizzas, plus 1 minute for each additional pizza.

Order statuses are updated automatically:

  • Orders move from 'pending' to 'in-preparation' 1-3 minutes after creation.
  • Orders move from 'in-preparation' to 'completed' 2-3 minutes around their estimated completion time.
post/orders

Request body

userIdstring required
nicknamestring

Optional nickname for the order that will be displayed instead of order ID (first 8 characters will be shown)

Example request

{
  "userId": "user123",
  "nickname": "My Pizza Order",
  "items": [
    {
      "pizzaId": "pizza-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)

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": [
    {
      "pizzaId": "pizza-1",
      "quantity": 1,
      "extraToppingIds": [
        "topping-1",
        "topping-2"
      ]
    }
  ]
}