Get a purchase

​

Returns one of your purchases in full — the buyer view of the order.

On top of the items and totals, you get what you paid (buyer fee and tax), the shipping address, tracking and delivery, any refund, and the seller's profile (country, review score, recent order-handling stats).

Only the buyer on the order can read it; any other order number returns 404 Not Found.

Requires the purchases:read scope.

Path Parameters
  • orderNumber
    Type: string
    min length:  
    1
    required

    The order reference, e.g. OR-ASNBC-1. Path parameter — not a query string.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/purchases/{orderNumber}
curl 'https://public-api.cardnexus.com/v1/purchases/{orderNumber}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "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,
  "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"
  },
  "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
    }
  },
  "shippingAddress": {
    "recipientName": "Marie Dubois",
    "line1": "14 Rue des Lilas",
    "line2": null,
    "city": "Lyon",
    "state": null,
    "postalCode": "69003",
    "countryCode": "FR",
    "phone": null
  },
  "shipping": {
    "trackingNumber": "6A18432197431",
    "carrier": "Colissimo",
    "trackingUrl": "https://www.laposte.fr/outils/suivre-vos-envois?code=6A18432197431",
    "status": "delivered",
    "shippedAt": "2026-06-14T09:12:00.000Z",
    "deliveredAt": "2026-06-17T11:40:00.000Z",
    "history": null
  },
  "refund": null,
  "cancellation": null
}

Purchase returned.