Purchase

A purchase — an order where you are the buyer — with the seller and what you paid. total is the full amount you were charged, including shipping, tax, and the buyerFee.

actions
Type: array of object
required

The operations that can act on this purchase now, filtered by the permissions of your key.

Properties: 3
buyerFee
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
completedAt
Type: Format: date-timenullable
required

When the order closed. null if still open.
currency
Type: stringenum
required

The currency every amount in this response is expressed in. Sales are in your selling currency; purchases are in the currency you paid.
values
- USD
  
  US Dollar.
- EUR
  
  Euro.
- GBP
  
  British Pound.
- CAD
  
  Canadian Dollar.
- CHF
  
  Swiss Franc.
- SEK
  
  Swedish Krona.
- DKK
  
  Danish Krone.
- NOK
  
  Norwegian Krone.
- PLN
  
  Polish Złoty.
- HUF
  
  Hungarian Forint.
deliveredAt
Type: Format: date-timenullable
required

When the parcel was delivered. null if not yet.
items
Type:
required

The items in the order.

Properties: 10
orderNumber
Type: string
required

Human-readable order reference, shared across the sale and the purchase, e.g. OR-ASNBC-1.
placedAt
Type: stringFormat: date-time
required

When the order was placed.
seller
Type:
required

The other party on an order — the buyer on a sale, the seller on a purchase — with their public profile and reputation.

Properties: 7
shipBy
Type: Format: date-timenullable
required

The ship-by deadline. Set while the order is pending_shipment or cancellation_requested; null otherwise.
shippedAt
Type: Format: date-timenullable
required

When the order was marked shipped. null if not yet.
shippingAmount
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
shippingManagedByCardNexus
Type: boolean
required

true when CardNexus manages shipping on this purchase: the shipping you paid went to CardNexus, and the seller ships with a label generated on CardNexus. false when the seller ships the order themselves. Set when the order is placed and never changes afterwards.
shippingService
Type: stringenum
required

The shipping the buyer paid for. tracked ships with a tracking number. untracked ships as a letter, which may have no tracking number.
values
- tracked
  
  The order ships with a tracking number.
- untracked
  
  The order ships as a letter, which may have no tracking number.
status
Type: enum
required

Where the order is in its lifecycle. pending_shipment is awaiting dispatch; shipped and delivered track the parcel; completed is closed and paid out; cancelled_* and resolved_* are the terminal cancellation and dispute outcomes.
values
- pending_shipment
  
  Awaiting dispatch.
- cancellation_requested
  
  The buyer asked to cancel; awaiting a response.
- cancelled_buyer
  
  Cancelled — the buyer's cancellation was accepted.
- cancelled_seller
  
  Cancelled by the seller.
- cancelled_auto
  
  Cancelled automatically by CardNexus.
- shipped
  
  On its way to the buyer.
- delivered
  
  Delivered to the buyer.
- completed
  
  Closed and paid out.
subtotal
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
tax
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
total
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
untrackedCloseAt
Type: Format: date-timenullable
required

When this untracked order closes on its own: it completes and the seller is paid, unless a dispute is opened before then. null on tracked orders, and until an untracked order ships.
updatedAt
Type: stringFormat: date-time
required

When the order last changed.
webUrl
Type: string
required

The order page on cardnexus.com. The link carries no credentials: a signed-in person lands on the order.

Examples

{
  "orderNumber": "OR-ASNBC-1",
  "status": "delivered",
  "placedAt": "2026-06-13T15:02:00.000Z",
  "updatedAt": "2026-06-17T11:40:00.000Z",
  "shippedAt": "2026-06-14T09:12:00.000Z",
  "deliveredAt": "2026-06-17T11:40:00.000Z",
  "completedAt": null,
  "shippingService": "tracked",
  "webUrl": "https://cardnexus.com/orders/OR-ASNBC-1",
  "shipBy": null,
  "untrackedCloseAt": null,
  "currency": "EUR",
  "items": [
    {
      "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"
      }
    }
  ],
  "subtotal": {
    "amount": 9,
    "currency": "EUR"
  },
  "shippingAmount": {
    "amount": 3.5,
    "currency": "EUR"
  },
  "shippingManagedByCardNexus": false,
  "buyerFee": {
    "amount": 0.6,
    "currency": "EUR"
  },
  "tax": {
    "amount": 0,
    "currency": "EUR"
  },
  "total": {
    "amount": 13.1,
    "currency": "EUR"
  },
  "seller": {
    "id": "665f3a2b1c8d4e9f7a6b5c4d",
    "username": "north_arena_tcg",
    "avatarUrl": "https://images.cardnexus.com/avatars/north_arena_tcg.png",
    "country": "GB",
    "type": "pro",
    "rating": {
      "average": 4.9,
      "count": 214
    },
    "reliability": {
      "orderCount": 96,
      "completedCount": 94,
      "completionRate": 0.98,
      "avgShipTimeHours": 21.4
    }
  },
  "actions": [
    {
      "id": "mark-complete",
      "method": "POST",
      "path": "/v1/purchases/OR-ASNBC-1/mark-complete"
    }
  ]
}

SaleDetail

PurchaseDetail