Lists receipts and received Cumulus points for a specific Cumulus number between two dates. The returned data contains only summary data of the receipt and omits articles, payments and other variable size details.
If a record has hasDetail == 1 this record represents a real receipt and the transactionId can be used to retrieve the rendered receipts via the …/v1/details/… endpoint.
If a record has hasDetail == 0 this record represents only the credit entry of Cumulus-Points, typically from a Migros-Partner or Mitarbeiterpunkte. In this case you cannot access the receipts details as there are no details.
start date
If omited it defaults to “yesterday one year ago”, i.e. one whole year of data is returned or analyzed.
Example:2021-03-17
end date of list; if omited or empty the current date is used
Sort list by date of purchase or total CHF.
Allowed values:datetotal
Default:date
Example:total
Cumulus Number
>= 2098000000000<= 2099999999999
Example:2099123456789
list of transactions
Rewarded Cumulus points.
Example:319.7
0: This is a syntetic pseudo-transaction that just list Partner- or Mitarbeiter-Punkte. Trying to retrieve details will fail always in this case.
1: Actual receipt available via detail/{cumulus}/{transactionId}.
Example:1
Filial-ID
Example:0090390
Filialname
Example:M Wittenbach
Total purchase value in CHF.
Example:159.85
ID to retrieve actual receipt if hasDetail==1 If hasDetail = 0 this ID is just a dummy and cannot be used to retrieve the (non-existing) details.
Note: if hasDetail = 0 the transactionId might be empty (i.e. “”).
Example:20220611_092739_0090390_003_9
Date of purchase in the form YYYYMMDD.
Example:20220611
Time of purchase (local time of store) in the form hhmmss.
Example:092739
Kept for backwards compatibility. You are not supposed to use or interpret this field.
Returns the product IDs of the real (i.e. VAT-ID neither 0 nor 9) articles bought in this purchase.
Cumulus Number
>= 2098000000000<= 2099999999999
Example:2099123456789
Transaction ID of the receipt: Either as returned from a call to one of the receipt/warranty list routes or of the form trxDate_trxTime_storeID_workstationNumber_sequenceNumber. If you have to use the second form: Consult with a human.
If the list endpoint declares hasDetail = 0 then this transaction has no attached detail data. Trying to retrieve detail data for a transaction that has no detail data results in an error (400 or 404) so don’t even try: It’ll never work.
Example:2024-12-31
Array of product IDs.
Retrieve all purchases made in the given time period for a given Cumulus number. Only ‘real’ products are returned.
start date
If omited it defaults to “yesterday one year ago”, i.e. one whole year of data is returned or analyzed.
Example:2021-03-17
end date of list; if omited or empty the current date is used
Option product ID selecting only those purchases that contain this product.
Cumulus Number
>= 2098000000000<= 2099999999999
Example:2099123456789
JSON with list of purchases.
Cumulus points obtained for this purchase.
Example:48
ID of the store. Filial-ID
Example:0036713
Name of the store
Example:D + G Wynecenter
Human readable time stamp of purchase in local time zone
Example:30.03.2013 10:15:48
Total amount of the receipt in CHF (might be different from the sum of items.)
Example:24
Transaction ID of receipt
Example:20220124_174650_0045160_046_203
Number of warranties issued between from and today.
start date
If omited it defaults to “3 years and 2 months ago”.
Example:2019-03-17
Cumulus Number
>= 2098000000000<= 2099999999999
Example:2099123456789
The number of all warranties and the still valid ones.