List your sales

​

Returns your sales — orders where you are the seller — as a cursor-paginated list, newest first.

Each item carries the order, its items and totals, the buyer you sold to — their handle, country, review score, and recent order-handling stats — and the address to ship to, so a batch of parcels can be prepared from one call.

Filter with status (repeatable), the placedFrom / placedTo date range, and your own metadata — ?metadata[fulfillment_stage]=packed returns the sales carrying exactly that pair, and repeating the parameter with another key requires all of them. Walk the full set by following pagination.nextCursor: pass it back as cursor until it comes back null. limit defaults to 50, maximum 100.

Requires the sales:read scope.

Query Parameters
  • cursor
    Type: string
  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Integer numbers.

  • status
    Type: array string[] · enum

    Filter to orders in any of these statuses. Repeat the parameter for multiple values, e.g. ?status=shipped&status=delivered.

    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.

    • Type: string · enum

      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.

  • placedFrom
    Type: string · Format: date-time

    An ISO 8601 date-time in UTC, e.g. 2024-08-14T10:23:11.000Z.

  • placedTo
    Type: string · Format: date-time

    An ISO 8601 date-time in UTC, e.g. 2024-08-14T10:23:11.000Z.

  • metadata
    Type: object

    Return only sales whose metadata matches every one of these key/value pairs exactly, e.g. ?metadata[fulfillment_stage]=packed. Repeat the parameter with a different key to require several, up to 10 per call. Matching is case-sensitive and exact — there is no partial or prefix match.

    • propertyName
      Type: string
      keys: 
      string
      max length:  
      500
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/sales
curl https://public-api.cardnexus.com/v1/sales \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": [
    {
      "orderNumber": "OR-ASNBC-1",
      "status": "shipped",
      "placedAt": "2026-06-13T15:02:00.000Z",
      "updatedAt": "2026-06-14T09:12:00.000Z",
      "shippedAt": "2026-06-14T09:12:00.000Z",
      "deliveredAt": null,
      "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"
          },
          "inventoryId": "665f3a2b1c8d4e9f7a6b5c4d",
          "customId": "YRG|5555-5DS1-2EX-006-f-2-2008-08-01"
        }
      ],
      "subtotal": {
        "amount": 9,
        "currency": "EUR"
      },
      "shippingAmount": {
        "amount": 3.5,
        "currency": "EUR"
      },
      "sellerFee": {
        "percentage": 5,
        "amount": {
          "amount": 0.45,
          "currency": "EUR"
        }
      },
      "payout": {
        "amount": {
          "amount": 12.05,
          "currency": "EUR"
        },
        "eligibleAt": "2026-06-21T09:12:00.000Z",
        "paidOutAt": null
      },
      "buyer": {
        "id": "665f3a2b1c8d4e9f7a6b5c4d",
        "username": "north_arena_tcg",
        "avatarUrl": "https://images.cardnexus.com/avatars/north_arena_tcg.png",
        "country": "GB",
        "type": "individual",
        "rating": {
          "average": 4.9,
          "count": 51
        },
        "reliability": null
      },
      "shippingAddress": {
        "recipientName": "Marie Dubois",
        "line1": "14 Rue des Lilas",
        "line2": null,
        "city": "Lyon",
        "state": null,
        "postalCode": "69003",
        "countryCode": "FR",
        "phone": null
      },
      "metadata": {
        "fulfillment_stage": "packed",
        "internal_order_ref": "SO-10432"
      }
    }
  ],
  "pagination": {
    "nextCursor": "b2Zmc2V0OjUw"
  }
}

Sales returned.