OrderLineItem

A single line of an order: the product sold, its condition or grade, quantity, and price.

condition
Type: string · CardConditionenumnullable
required

The card's condition: NM, LP, MP, HP, or DMG. null when the item is graded or 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 item 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 image captured at the time of sale. null when there is none.
language
Type: string
required

The card's language as a two-letter code, e.g. en, fr.
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.
productId
Type: integer · CatalogId
min:
-9007199254740991
max:
9007199254740991nullable
required

The catalogue product that was sold. Returned by GET /v1/products. null when the product is no longer in the catalogue.

A catalogue product or expansion id — a stable integer. Games are addressed by their slug instead.
productName
Type: string
required

The product name captured at the time of sale.
quantity
Type: integer
min:
-9007199254740991
max:
9007199254740991
required

How many units of this item were sold.
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

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