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

  • e01ecd3056dfRevision changes
    • ▲

      removed the required property // from the response with the status

    • ●

      removed the optional property // from the response with the status

    • ○

      added the optional property // to the response with the status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status