📦 Single Listing & Order Endpoints – StockX Python SDK

This page covers how to retrieve detailed information about a single listing or individual order using the StockX SDK.

---

🔍 Get Single Listing

Retrieves the full details of a single listing using its listingId.

▶️ Function

from stockx.listings import get_single_listing

result = await get_single_listing("your-listing-id")

🧾 Parameters

• listingId (str):
  The unique identifier for the listing you want to retrieve.

📤 Response

Returns a dict containing listing details such as:

• Listing status (ACTIVE, COMPLETED, etc.)
• Product and variant IDs
• Inventory type
• Creation and update timestamps
• Associated shipment IDs (if any)

---

📦 Get Single Order

Retrieves a specific order's full record using its orderNumber.

▶️ Function

from stockx.orders import get_order_by_id

result = await get_order_by_id("your-order-number")

🧾 Parameters

• orderNumber (str):
  The unique order number assigned by StockX.

📤 Response

Returns a dict containing:

• Order status (e.g., SHIPPED, COMPLETED)
• Product and variant information
• Tracking and fulfillment details
• Timestamps for various lifecycle stages

---

✅ Usage Example

import asyncio
from stockx.connection import setup
from stockx.orders import get_order_by_id
from stockx.listings import get_single_listing

setup({"api_key": "YOUR_API_KEY", "jwt": "YOUR_JWT_TOKEN"})

async def main():
    listing = await get_single_listing("listing-id")
    print("Listing Details:", listing)

    order = await get_order_by_id("order-number")
    print("Order Details:", order)

asyncio.run(main())

---

🛑 Notes

• Ensure setup() is called before using any API functions.
• Both endpoints require valid and active credentials.
• These calls are read-only and do not modify your StockX account.

Need help? Visit the FAQs or open a GitHub issue.