Skip to main content

Overview

Retrieve a paginated list of orders placed by the authenticated user within the specified tenant. This endpoint is useful for customer-facing applications where users need to view their order history.

Authorization

  • User must be authenticated with a valid Bearer token
  • User must be a member of the tenant
  • Requires X-Tenant-ID header

Tenant Scoping

Only orders that match both conditions are returned:
  • Orders belonging to the authenticated user
  • Orders belonging to the specified tenant
This ensures users can only see their own orders within the current tenant context.

Response

Returns a paginated list of the user’s orders with:
  • Order items
  • Product details for each item
  • Order status and timestamps

Example Usage

Response Example

Use Cases

  • Customer order history page
  • Order tracking interface
  • User dashboard showing recent orders
  • Mobile app order list

Notes

  • Orders are sorted by creation date (newest first)
  • Results are paginated with 20 orders per page
  • Only orders from the current tenant are shown
  • Users cannot see orders from other tenants, even if they belong to multiple tenants