Skip to main content

List POS orders

Method GET​

https://my.easyweek.io/api/public/v2/orders

Description: This endpoint returns the workspace's point-of-sale (POS) orders, newest first, paginated. Only POS orders are returned — appointment (booking) orders are excluded. Monetary values are integers in minor units (e.g. cents).

Example Request​

curl -i -X GET \
  https://my.easyweek.io/api/public/v2/orders?status={status}&location_uuid={location_uuid}&staffer_uuid={staffer_uuid}&customer_uuid={customer_uuid}&per_page={per_page} \
  -H 'Authorization: Bearer <YOUR_SECRET>' \
  -H 'Workspace: <YOUR_WORKSPACE>'

Query Parameters​

  • per_page (integer, optional): Number of items per page (alias of limit), maximum 100. Defaults to 15.
  • status (string, optional): Filter by status — one of open, paid, cancelled, refunded.
  • location_uuid (string, optional): Filter by branch.
  • staffer_uuid (string, optional): Filter by the staff member who made the sale.
  • customer_uuid (string, optional): Filter by customer.
  • created_at_from (string, optional): Inclusive lower bound on creation time, UTC ISO 8601 (YYYY-MM-DDTHH:MM:SSZ).
  • created_at_to (string, optional): Inclusive upper bound on creation time, UTC ISO 8601.

Example Response​

{
  "data": [
    {
      "uuid": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "status": "open",
      "order_number": 42,
      "is_reverted": false,
      "booking_uuids": [],
      "created_at": "2026-07-16T09:00:00Z",
      "subtotal": 3000,
      "account_paid_amount": 0,
      "voucher_paid_amount": 0,
      "discount_amount": 0,
      "discount_mode": null,
      "discount_percent": null,
      "promocode": null,
      "promocode_discount_amount": null,
      "payment_method": null,
      "comment": null,
      "customer": null,
      "goods": [
        {
          "good_uuid": "9c2f1b7e-2f8a-4a1e-bd2c-6b3a1f9e0d11",
          "name": "Shampoo",
          "article": "SKU-123",
          "quantity": 2,
          "price": 1500
        }
      ],
      "services": [],
      "vouchers": []
    }
  ],
  "links": {
    "first": "https://my.easyweek.io/api/public/v2/orders?page=1",
    "last": "https://my.easyweek.io/api/public/v2/orders?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://my.easyweek.io/api/public/v2/orders",
    "per_page": 15,
    "to": 1,
    "total": 1
  }
}