Layout-API

Augmented warranties

Lists warranties for a specific Cumulus number between two dates.

The returned data is not just the raw data from the archived warranty but is augmented/extended by looking up the product in the M-API. If the product is not found in the M-API (for whatever reason) the original data is returned.

get
https://api-qual.migros.ch/migros/customers/warranties/v1/xlist/{cumulus}

Query Parameters

fromstring(date)

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

tostring(date)

end date of list; if omited or empty the current date is used

langstringrequired

Target language to use for article description.

Allowed values:defrit

storeTypestring

Show only warranties issued in a store of this type. SMVM is M or MM or MMM.

Allowed values:MMMMMMSMVMMELDGMICSXX

Path Parameters

cumulusintegerrequired

Cumulus Number

>= 2098000000000<= 2099999999999

Example:2099123456789

Response

200 application/json

list of augmented warranties

XWarrantyListResponse

articleDescriptionstringrequired

Article description.

Example:MediaPadT5 10.1 WiFi s

articleImagestring

URL of image

Example:http://image.migros.ch/{stack}foo/bar.jpg

articleLinkstring

URL of article in shop.

Example:https://produkte.migros.ch/bellcolor-kreidestift-3-stk

articleNumberstringrequired

Unique article identifer. Product-ID.

Example:798458800000

articlePricenumberrequired

Full article price in CHF without reductions in CHF.

Example:274.95

buyDateinteger

Buy-date as YYYYMMDD

Example:20220124

manualsarray[object]

List of user manuals

Show Child Parameters
serviceLinkstring

URL to migros.service.

Example:https://migros-service.ch/foo/bar

storeIdstringrequired

Unique store identifier. Filial-ID.

Example:0150475

storeNamestring

Name of store

Example:M Gränichen

storeTypestring

Type of the store

Example:MEL

warrantyDurationintegerrequired

Complete length of the warranty duration in months.

Example:24

warrantyIdstringrequired

Warranty identifier.

Example:20220124_174650_0045160_046_203_0

warrantyUntilstringrequired

Exact date when the warranty will expire. Provided in YYYYMMDD.

Example:20210927

get/migros/customers/warranties/v1/xlist/{cumulus}
 
200 application/json

Audit

Lookup redemtion of UCBs

Check if a Cumulus number redeemed some UCBs returning details about when and where they got redeemed.

get
https://api-qual.migros.ch/migros/customers/receipts/v1/ucblookup/{cumulus}

Query Parameters

ucbstringrequired

ID of the UCB(s) to look up

Path Parameters

cumulusintegerrequired

Cumulus Number

>= 2098000000000<= 2099999999999

Example:2099123456789

Response

200 application/json

JSON with list of purchases.

ucblookupResponse

ucblookupResponseobject

Map of those UCBs that where redeemed by this cumulus number.

get/migros/customers/receipts/v1/ucblookup/{cumulus}
 
200 application/json

CollectionPeriodResponse

array
dateFromstringrequired
dateTostringrequired
flagnumberrequired

1: Accountstatement available for this period. 0: Accountstatemen not yet available.

periodIdnumberrequired

PurchaseResponse

array
itemsarray[object]
Show Child Parameters
pointsnumber

Cumulus points obtained for this purchase.

Example:48

storeIDstring

ID of the store. Filial-ID

Example:0036713

storeNamestring

Name of the store

Example:D + G Wynecenter

timestampstring

Human readable time stamp of purchase in local time zone

Example:30.03.2013 10:15:48

totalCHFnumber

Total amount of the receipt in CHF (might be different from the sum of items.)

Example:24

trxIDstring

Transaction ID of receipt

Example:20220124_174650_0045160_046_203