Get a bazaar order

get/markets/{marketId}/orders/{orderId}

Retrieves a single bazaar order with its full details and merchant notes.

Path Parameters

marketIdstringrequired

orderIdstringrequired

Responses

200OK

application/json

idstringrequired

buyer_namestringrequired

descriptionstring

prioritystring ("royal" | "urgent" | "standard" | "low")required

commoditystring

Primary commodity requested by the buyer

quantityinteger

Requested quantity of the commodity

Unit used for the requested quantity

market_idstring

Market destination for the order

destination_stallstring

Bazaar stall or warehouse receiving the order

requested_delivery_datestring (date)

Date requested by the buyer for delivery

assigned_caravan_idstring

Caravan assigned to fulfill the order

quoted_pricenumber (float)

Quoted order price

currencystring

Currency used for the quoted price

created_atstring (date-time)required

notesarray of OrderNote

idstringrequired

contentstringrequired

actionstring ("reserved" | "packed" | "substituted" | "delayed" | "rejected")

author_namestring

Merchant or clerk who wrote the note

visibilitystring ("internal" | "buyer_visible")

Whether the note is internal or visible to the buyer

created_atstring (date-time)required

Errors

Request

curl -X GET 'https://api.cameltrading.example/v1/markets/mkt_marrakesh/orders/ord_silk_77' \
  -H 'Authorization: Bearer <your-token>'

Response

{
  "id": "ord_silk_77",
  "buyer_name": "House Al-Qamar Textiles",
  "description": "Request for indigo silk bolts and cardamom crates before the new moon auction",
  "priority": "urgent",
  "status": "open",
  "commodity": "Indigo silk",
  "quantity": 20,
  "unit": "bolt",
  "market_id": "mkt_marrakesh",
  "destination_stall": "Blue Gate Stall 14",
  "requested_delivery_date": "2026-02-20",
  "assigned_caravan_id": "car_sahara_001",
  "quoted_price": 3150,
  "currency": "CTD",
  "created_at": "2026-02-10T08:00:00Z",
  "notes": [
    {
      "id": "note_001",
      "content": "Two silk bolts reserved from lot lot_silk_118. Buyer requested delivery after sunset.",
      "action": "reserved",
      "author_name": "Layla bint Yusuf",
      "visibility": "buyer_visible",
      "created_at": "2026-02-15T11:00:00Z"
    }
  ]
}