OrderLineItem

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

condition
Type: enumnullable
required

The card's condition: NM, LP, MP, HP, or DMG. null when the item is graded or 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 item is graded. null for raw cards and sealed products.

Properties: 3
imageUrl
Type: stringnullable
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:
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
productId
Type:
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.
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:
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

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

OrderMetadata

OrderParty