Sign in
Orders V2

Get order detail

Changed on

Get order details with variant information

Retrieves complete order information including:

  1. Order metadata (status, timestamps, total price)
  2. Buyer and seller information (username, display_name, avatar)
  3. Array of order items with variant details
  4. Quality tier, variant attributes, and display_name for each item
  5. Price per unit snapshot from time of purchase

Authorization: User must be either the buyer or seller of the order.

Requirements:

  • 26.1: GET /api/v2/orders/:id endpoint
  • 26.2: Return order metadata with buyer and seller information
  • 26.3: Return array of order items with variant details
  • 26.4: Include quality_tier for each order item
  • 26.5: Include variant attributes for each item
  • 26.6: Include variant display_name for each item
  • 26.7: Include price_per_unit snapshot from time of purchase
  • 26.8: Calculate order totals with per-variant pricing
  • 26.9: Include order status and timestamps
  • 26.10: Return 404 if order not found
  • 26.11: Validate user authorization to view order
  • 26.12: Include fulfillment status per item
get/orders/{orderId}

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/{orderId}
  • Auth: loggedin (a scheme the document does not define)

Path parameters

orderIdstring required

UUID of the order to retrieve

Response

Order details with buyer/seller info and variant details

order_idstring required

UUID of the order

total_pricenumber double required

Total price in aUEC (atomic units)

statusstring required

Order status

kindstring required

Order kind (Delivery, Escort, etc.)

titlestring required

Order title

descriptionstring required

Order description

payment_typestring required

Payment type

offer_session_idstring nullable

Offer session ID (if created from offer)

created_atstring required

ISO 8601 timestamp of order creation

updated_atstring required

ISO 8601 timestamp of last update

Changes

  • v2a3060250b39bRevision changes
    • ▲

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

    • ○

      the endpoint scheme security loggedin was added to the API

    • ○

      the endpoint scheme security jwt was removed from the API

    • ○

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

    • ○

      added the required property to the response with the status