List bazaar orders

get/markets/{marketId}/orders

Returns all bazaar orders for a market destination.

Path Parameters

marketIdstringrequired

Query Parameters

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

Filter by buyer priority level

Filter by fulfillment status

Responses

200OK

application/json

market_idstring

itemsarray of BazaarOrder

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

totalinteger

pageinteger

per_pageinteger

request_idstring

Request

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

Response

{
  "market_id": "mkt_marrakesh",
  "items": [
    {
      "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"
    }
  ],
  "total": 9,
  "page": 1,
  "per_page": 20,
  "request_id": "req_7f3a91c2"
}