CartSellerGroup

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.

    • 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.

    • 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.

    • 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.

  • 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.

    • 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.

  • seller
    Type: object · ListingSeller
    required

    The seller behind a Marketplace listing.

    • country
      Type: string
      required

      The seller's country as a two-letter ISO 3166-1 alpha-2 code.

    • id
      Type: string
      required

      Stable opaque identifier for the seller. Do not parse.

    • rating
      Type: object · OrderPartyRating
      required

      A party's average review score and the number of reviews behind it.

    • shipping
      Type: object · Moneynullable
      required

      What this seller charges to ship your order to your delivery country. null when no delivery country applies.

      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.

    • type
      Type: string enum
      required

      pro if they sell as a registered company, individual if they sell as a private person.

      values
      • pro

        You sell as a registered company.

      • individual

        You sell as a private person.

    • username
      Type: string
      required

      The seller's public handle.

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