Cart

Your shopping cart, grouped by seller. Adding items does not put them on hold — availability is checked at checkout.

deliveryCountry
Type: string nullable
required

Where your order will ship, as a two-letter ISO 3166-1 alpha-2 code, set by POST /v1/cart/items. null while your cart is empty.
itemCount
Type: integer
min:
-9007199254740991
max:
9007199254740991
required

Total units across every item in your cart.
sellers
Type: array object[] · CartSellerGroup[]
required

Your cart's items, grouped by seller. Each group ships as its own parcel.
Your cart's items from one seller. Each seller's items ship together as one parcel; the seller's shipping charge is under seller.shipping.
- items
  Type: array object[] · CartItem[]
  required
  
  The items you are buying from this seller.
  
  One listing in your cart: the product it sells, the card's condition and language, how many units you are buying, and the price per unit. unitPrice is the price when you added the item — if the seller lowers their price your cart follows, and if they raise it the item is removed from your cart.
- itemsSubtotal
  Type: object · Money
  required
  
  A monetary amount as a decimal in the currency's major unit paired with its currency code — { amount: 14.99, currency: "USD" } means $14.99.
- seller
  Type: object · ListingSeller
  required
  
  The seller behind a Marketplace listing.

Examples

{
  "deliveryCountry": "FR",
  "itemCount": 2,
  "sellers": [
    {
      "seller": {
        "id": "665f3a2b1c8d4e9f7a6b5c4d",
        "username": "north_arena_tcg",
        "country": "DE",
        "type": "pro",
        "rating": {
          "average": 4.9,
          "count": 214
        },
        "shipping": {
          "amount": 3.5,
          "currency": "EUR"
        }
      },
      "itemsSubtotal": {
        "amount": 9,
        "currency": "EUR"
      },
      "items": [
        {
          "listingId": "665f3a2b1c8d4e9f7a6b5c52",
          "productId": 50212,
          "productName": "Dark Magician (SDMY-EN001)",
          "imageUrl": "https://images.cardnexus.com/yugioh/SDMY-EN001.png",
          "condition": "NM",
          "language": "en",
          "finish": "Standard",
          "graded": null,
          "quantity": 2,
          "unitPrice": {
            "amount": 4.5,
            "currency": "EUR"
          },
          "lineTotal": {
            "amount": 9,
            "currency": "EUR"
          },
          "addedAt": "2026-07-12T15:02:00.000Z"
        }
      ]
    }
  ]
}