ProductListing

One seller's Marketplace listing for a product: price, quantity for sale, the card's condition and language, and the seller behind it.

comment
Type: string nullable
required

The seller's note about this listing. null when there is none.
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.
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.
listingId
Type: string
required

Stable opaque identifier for this listing. Pass it to POST /v1/cart/items to buy from it. Do not parse.
price
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.
quantity
Type: integer
min:
-9007199254740991
max:
9007199254740991
required

How many units this listing has for sale.
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

{
  "listingId": "665f3a2b1c8d4e9f7a6b5c52",
  "price": {
    "amount": 4.5,
    "currency": "EUR"
  },
  "quantity": 3,
  "condition": "NM",
  "language": "en",
  "finish": "Standard",
  "graded": null,
  "comment": "Pack fresh, straight into a toploader",
  "seller": {
    "id": "665f3a2b1c8d4e9f7a6b5c4d",
    "username": "north_arena_tcg",
    "country": "DE",
    "type": "pro",
    "rating": {
      "average": 4.9,
      "count": 214
    },
    "shipping": {
      "amount": 3.5,
      "currency": "EUR"
    }
  }
}