API reference · Types
OrderAdditionOfferLine
Part of the response of GET /orders/{orderId}/addition-offers, POST /orders/{orderId}/addition-offers and POST /orders/{orderId}/addition-offers/{offerRef}/withdraw and the payload of order.addition_offer.updated.
Type: object
Example
{
"sku_id": 14602,
"product_id": 86,
"quantity": 2,
"reference_unit_price_cents": 450,
"unit_price_cents": 400,
"name": "Abyssal Nightstalker",
"set_name": "Portal Second Age",
"condition": "Near Mint",
"category_name": "Magic: The Gathering",
"language": "English",
"finish": "Normal",
"collector_number": null,
"rarity": "Uncommon"
}Fields
sku_idinteger requiredThe exact printing offered. Everything beside it is frozen from it.
Example
14602product_idinteger requiredSee Canonical catalog in Core concepts.
Example
86quantityinteger requiredThe number of units.
Example
2reference_unit_price_centsinteger requiredThe seller’s live listing price when the offer was authored: the ceiling this offer was allowed to charge up to, and the “was” price a discount reads against.
Example
450unit_price_centsinteger requiredWhat this offer charges per unit; at or below the reference.
Example
400namestring or null requiredExample
Abyssal Nightstalkerset_namestring or null requiredExample
Portal Second Ageconditionstring or null requiredThe normalized condition assigned to the card.
Example
Near Mintcategory_namestring or null requiredExample
Magic: The Gatheringlanguagestring or null requiredThe language of the card printing.
Example
Englishfinishstring or null requiredThe catalog’s printing, under the name the order line snapshot uses.
Example
Normalcollector_numberstring or null requiredExample
nullraritystring or null requiredThe rarity assigned to the card printing.
Example
Uncommon
Used by
GET /orders/{orderId}/addition-offers- List an order's add-on offers (not yet available) (response)POST /orders/{orderId}/addition-offers- Send or replace an add-on offer (not yet available) (response)POST /orders/{orderId}/addition-offers/{offerRef}/withdraw- Withdraw an add-on offer (not yet available) (response)order.addition_offer.updated- Add-on offer updated (not yet available) (payload)