Report your sales over a period

​

Returns your sales over a period: the number of orders and cards, the items sold, the shipping you collected, refunds, seller fees and the net, in your selling currency, with an optional series by day, week or month.

A sale counts when it is not cancelled and not undone by a full refund or a return; orders still in progress count and drop out if they end cancelled. A sale is dated by the day it was placed, in your report time zone, which period.timeZone echoes together with the resolved dates. Seller fees are computed as on the monthly fee statement, so the two match only approximately: statements select and date orders differently.

Sales whose currency differs from your current selling currency are left out of the amounts and counted in excluded.otherCurrencyOrders.

409 NOT_A_SELLER when the account has no seller profile, 400 INVALID_PERIOD for a custom window without both dates or with to before from.

Requires the sales:read scope.

Query Parameters

  • The window, in your report time zone. last_N_days ends today. Default last_30_days. custom needs from and to.

    values
    • last_7_days

      The last 7 days, ending today.

    • last_30_days

      The last 30 days, ending today.

    • last_90_days

      The last 90 days, ending today.

    • this_month

      From the first of this month to today.

    • last_month

      The whole previous month.

    • this_year

      From 1 January to today.

    • last_year

      The whole previous year.

    • custom

      The days between from and to, both included.

  • First day of a custom window, inclusive.

  • Last day of a custom window, inclusive. Not before from.

  • Spacing of the series. none (default) returns totals only. Weeks start on Monday; the first and last bucket are cut to the window.

    values
    • none

      Totals only, no series.

    • day

      One row per day.

    • week

      One row per week, weeks starting on Monday.

    • month

      One row per month.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/sales/report
curl 'https://public-api.cardnexus.com/v1/sales/report?period=last_30_days&interval=none' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "currency": "EUR",
  "period": {
    "from": "2026-09-01",
    "to": "2026-09-30",
    "timeZone": "Europe/Paris"
  },
  "interval": "week",
  "totals": {
    "orders": 143,
    "cards": 612,
    "itemSales": {
      "amount": 3920.4,
      "currency": "EUR"
    },
    "shipping": {
      "amount": 214.5,
      "currency": "EUR"
    },
    "revenue": {
      "amount": 4134.9,
      "currency": "EUR"
    },
    "refunded": {
      "amount": 18,
      "currency": "EUR"
    },
    "sellerFees": {
      "amount": 206.74,
      "currency": "EUR"
    },
    "net": {
      "amount": 3910.16,
      "currency": "EUR"
    },
    "cancelledOrders": 6
  },
  "series": [
    {
      "date": "2026-09-01",
      "orders": 31,
      "cards": 140,
      "revenue": {
        "amount": 902.3,
        "currency": "EUR"
      },
      "refunded": {
        "amount": 0,
        "currency": "EUR"
      },
      "sellerFees": {
        "amount": 45.1,
        "currency": "EUR"
      },
      "net": {
        "amount": 857.2,
        "currency": "EUR"
      }
    }
  ]
}