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: string Format: date-time
required

When you added the item to your cart.
condition
Type: string · CardConditionenumnullable
required

The card's condition: NM, LP, MP, HP, or DMG. null when the card is graded or the product is sealed.

Card condition: NM (Near Mint), LP (Lightly Played), MP (Moderately Played), HP (Heavily Played), DMG (Damaged).
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: object · Gradednullable
required

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

Grading details for a slabbed card.
- certification
  Type: string nullable
  required
  
  The certification number printed on the slab. null when the card does not carry one.
- grade
  Type: string
  required
  
  The grade assigned by the grading company, as printed on the slab.
- gradingService
  Type: string
  required
  
  The grading company that graded the card, e.g. PSA, BGS, CGC.
imageUrl
Type: string nullable
required

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

The card's language as a two-letter code, e.g. en, fr. null when the listing has no language.
lineTotal
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.
- amount
  Type: number
  required
  
  Decimal amount in the currency's major unit (e.g. 5.23 for €5.23). 2 decimal places for EUR/USD/GBP/CHF/CAD/AUD.
- currency
  Type: string enum
  required
  values
  USD
  
  US Dollar.
  
  EUR
  
  Euro.
  
  GBP
  
  British Pound.
  
  CAD
  
  Canadian Dollar.
  
  CHF
  
  Swiss Franc.
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: 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.
- amount
  Type: number
  required
  
  Decimal amount in the currency's major unit (e.g. 5.23 for €5.23). 2 decimal places for EUR/USD/GBP/CHF/CAD/AUD.
- currency
  Type: string enum
  required
  values
  USD
  
  US Dollar.
  
  EUR
  
  Euro.
  
  GBP
  
  British Pound.
  
  CAD
  
  Canadian Dollar.
  
  CHF
  
  Swiss Franc.

Examples

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