Orders - Sorraia API

An order is a completed purchase through an e-commerce widget (or a catalog/collection checkout). Orders are read-only in v1.

The order object

{
  "id": 3001,
  "ecommerceWidgetId": 77,
  "collectionId": null,
  "customerName": "Jane Doe",
  "customerEmail": "[email protected]",
  "customerPhone": null,
  "amountCents": 2500,
  "currency": "usd",
  "status": "paid",
  "shippingAddress": null,
  "trackingNumber": null,
  "trackingCarrier": null,
  "shippedAt": null,
  "createdAt": "2026-05-20T09:30:00.000Z"
}

status is one of paid, shipped, refunded, or failed. Widget-mode orders carry ecommerceWidgetId; cart/catalog orders carry collectionId. Stripe identifiers and signed download tokens are never exposed. GET /v1/ecommerce-widgets/{id}/orders — scope read:orders. Paginated (page, limit), newest first.

curl https://api.sorraia.app/v1/ecommerce-widgets/77/orders \
  -H "Authorization: Bearer sor_live_xxxxxxxx"

const result = await sorraia.orders.listWidgetOrders({ id: 77 });

Get an order

GET /v1/orders/{id} — scope read:orders.

curl https://api.sorraia.app/v1/orders/3001 \
  -H "Authorization: Bearer sor_live_xxxxxxxx"

const order = await sorraia.orders.getOrder({ id: 3001 });