Get your cart

​

Returns your shopping cart, grouped by seller. Each group carries the seller's profile, their shipping charge to your delivery country, and the items you are buying from them.

An empty cart returns deliveryCountry: null and no seller groups.

Each item's unitPrice is the price when you added it. If the seller lowers their price, your cart price follows; if they raise it, the item is removed from your cart. When a listing no longer has enough units, your cart quantity is reduced to what is available.

Adding items to your cart does not put them on hold — availability is checked at checkout.

Requires the cart:read scope.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/cart
curl https://public-api.cardnexus.com/v1/cart \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "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"
        }
      ]
    }
  ]
}

Cart returned.