CartItem

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.

addedAt
Type: stringFormat: date-time
required

When you added the item to your cart.
condition
Type: enumnullable
required

The card's condition: NM, LP, MP, HP, or DMG. null when the card is graded or the product is sealed.
values
- NM
  
  Near Mint.
- LP
  
  Lightly Played.
- MP
  
  Moderately Played.
- HP
  
  Heavily Played.
- DMG
  
  Damaged.
finish
Type: string
required

The card's finish, e.g. Standard, Foil, Reverse Holo.
graded
Type: nullable
required

Grading details when the card is graded. null for raw cards and sealed products.

Properties: 3
imageCensored
Type: boolean
required

true when cardnexus.com hides the product's art by default. The image is still returned in imageUrl.
imageUrl
Type: stringnullable
required

The product's image. null when there is none.
language
Type: stringnullable
required

The card's language as a two-letter code, e.g. en, fr. null when the listing has no language.
lineTotal
Type:
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.

Properties: 2
listingId
Type: string
required

The listing this item comes from. Listing ids come from GET /v1/products/{productId}/listings and from the optimizer's run results.
productId
Type: integer
min:
-9007199254740991
max:
9007199254740991
required

The catalogue product the listing sells.
productName
Type: string
required

The product's name.
quantity
Type: integer
min:
-9007199254740991
max:
9007199254740991
required

How many units of the listing are in your cart.
unitPrice
Type:
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.

Properties: 2

Examples

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

Cart

CartSellerGroup