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
- Type: stringenumperiod
The window, in your report time zone.
last_N_daysends today. Defaultlast_30_days.customneedsfromandto.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
fromandto, both included.
- last
- Type: stringfrom
First day of a
customwindow, inclusive. - Type: stringto
Last day of a
customwindow, inclusive. Not beforefrom. - Type: stringenuminterval
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.
- none
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
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"
}
}
]
}