Get order

http

GET /v1/orders/:id

Fetches one order by its DuckHub id (the id field from GET /v1/orders). Returns 404 if the order does not exist — or belongs to a different venue.

Example#

bash

curl https://api.duck-hub.com/v1/orders/cml9x2f4a0001abcd1234efgh \
  -H "Authorization: Bearer dk_live_your_api_key"

javascript

const orderId = 'cml9x2f4a0001abcd1234efgh'
const response = await fetch(
  `https://api.duck-hub.com/v1/orders/${orderId}`,
  { headers: { Authorization: 'Bearer dk_live_your_api_key' } },
)
 
if (response.status === 404) {
  // unknown order id for this venue
}
const order = await response.json()

Response#

200 OK — a single order object, same shape as the items[] entries of GET /v1/orders; every field is described in the field reference.

json

{
  "id": "cml9x2f4a0001abcd1234efgh",
  "orderNumber": "1024",
  "status": "confirmed",
  "type": "pickup",
  "customerName": "Anna",
  "customerPhone": "+380971234567",
  "customerEmail": null,
  "deliveryAddress": null,
  "deliveryNotes": null,
  "paymentMethod": "terminal",
  "comment": "No onions, please",
  "changeFromAmount": null,
  "scheduledFor": "2026-07-05T13:30:00.000Z",
  "currency": "UAH",
  "subtotalAmount": 21500,
  "deliveryFee": 0,
  "discountAmount": 0,
  "totalAmount": 21500,
  "createdAt": "2026-07-05T11:58:21.000Z",
  "updatedAt": "2026-07-05T12:01:05.000Z",
  "confirmedAt": "2026-07-05T12:01:05.000Z",
  "completedAt": null,
  "items": [
    {
      "productExternalId": "prod-margherita",
      "productName": "Margherita",
      "quantity": 1,
      "unitPrice": 21500,
      "totalPrice": 21500,
      "modifiers": []
    }
  ]
}

Errors#

401 — see Authentication
403 — free plan (the Orders API requires a paid plan)
404 Order not found — unknown id for this venue