Sign in
Orders V2

Get orders list

Changed on

Get orders list with filtering and pagination

Retrieves a list of orders for the current user with:

  1. Role-based filtering (buyer or seller)
  2. Status filtering (pending, completed, cancelled)
  3. Quality tier filtering (min and max)
  4. Pagination support
  5. Sorting options

Returns order previews with quality tier information visible.

Requirements:

  • 45.1: Provide OrderListV2 React component (backend support)
  • 45.2: Maintain visual parity with V1 OrderList component
  • 45.3: Use RTK_Query_Client for API calls
  • 45.4: Show quality tier in order preview
  • 45.5: Filter orders by quality tier
get/orders

Request

  • Base URL: /api/v2 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v2/orders
  • Auth: loggedin (a scheme the document does not define)

Query parameters

status'pending' | 'completed' | 'cancelled'
role'buyer' | 'seller'
quality_tier_minnumber double
quality_tier_maxnumber double
pagenumber double
page_sizenumber double
sort_by'created_at' | 'updated_at' | 'total_price'
sort_order'asc' | 'desc'

Response

Orders list with pagination metadata

totalnumber double required

Total number of orders matching filters

pagenumber double required

Current page number

page_sizenumber double required

Number of results per page

Changes

  • v2a3060250b39bRevision changes
    • ○

      the endpoint scheme security loggedin was added to the API

    • ○

      the endpoint scheme security jwt was removed from the API