Skip to main content
Endpoints

Orders

Wholesale orders where your org is a party — as the seller or the buyer. The role field is relative to you.

List orders

GET /api/v1/orders?limit=50
{
  "data": [
    {
      "id": "abc123",
      "order_number": "W-…",
      "role": "seller",
      "counterparty": { "org_id": "…", "name": "Retailer LLC" },
      "status": "received",
      "channel": "distryb_b2b",
      "subtotal_cents": 120000,
      "total_cents": 120000,
      "created_at": "2026-05-01T17:04:00.000Z"
    }
  ],
  "has_more": false,
  "limit": 50
}

Retrieve one order

GET /api/v1/orders/{id}

Returns the same shape plus items. If your org isn't a party to the order, you get 404 — the API never reveals another org's records.