Cart

Your shopping cart, grouped by seller. Its listings can sell to someone else until you pay, so availability is checked at checkout.

deliveryCountry
Type: stringnullable
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:
required

Your cart's items, grouped by seller. Each group ships as its own parcel.

Properties: 3
webUrl
Type: string
required

The cart page on cardnexus.com, where you review the cart and pay. The link carries no credentials: a signed-out visitor is sent to sign in and then back to the cart.

Examples

{
  "deliveryCountry": "FR",
  "itemCount": 2,
  "webUrl": "https://cardnexus.com/cart?signin=1",
  "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",
          "imageCensored": false,
          "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"
        }
      ]
    }
  ]
}

ProductListing

CartItem