langstring
Override Accept-Language header
Allowed values:defritexperimental_en
Fetch Coupon by ID
This endpoint provides a single Coupon identified via its Coupon-ID i.e. the corresponding M-Promo-ID. Note that GTINs cannot be used to look up a single Coupon.
get
https://api-qual.migros.ch/migros/customers/coupons/v3/coupons/{id}
Query Parameters
Path Parameters
idintegerrequired
Coupon ID (the M-Promo ID, not the GTIN).
Example:234531
Response
application/json
Response
application/json
Array of all coupons
Coupon
Represents the coupon information based on MDB+.
campaign_colorsobject
Optional special colors for special campaigns
Show Child Parameters
campaign_idstring
The ID of the campaign, if this coupon is part of a campaign.
Example:e58efb75-2327-4b98-aeb0-1f7d9a2f5f1e
customer_groupstring
Example:cumulus
digitalboolean
Example:true
disclaimerstring
Terms and conditions.
Example:Ausgenommen sind Gebührensäcke, -marken, Vignetten, Depots, Serviceleistungen, E-Loading, iTunes/App-Karten, SIM-Karten, Gutscheine, Geschenkkarten, Geschenkboxen und alkoholische Getränke. Nur einmalig einlösbar in Verbindung mit der angegebenen Cumulus-Nummer.
discount_amountstring
Example:5-fach Punkte
discount_amount_valuestring
Example:5.0
discount_typestring
Example:mehrfach
distribution_channelsobject
The list of distribution channels (Micasa, Do It, SportX …) this coupon is usable in.
Show Child Parameters
end_datestring
Example:31.10.2024
fine_printstring
gtinrequired
GTIN (EAN) of Coupon. Some Partnercoupons do not have GTINs.
Example:8888122276132945500263
idstringrequired
The ID of the Coupon. This is the same as the M-Promo ID; ReTi and MDB+ call this Offer ID".
Example:1871947
imagestring
An Image URL template. Replace the placeholder {stack} with an available Rokka stack, e.g “original” to get a usable URL.
Example:https://image.migros.ch/coupons/{stack}/5263e8a6f3282b7f411ae5fce947d7acb65db939.png
image_inactivestring
An Image URL template. Replace the placeholder {stack} with an available Rokka stack, e.g “original” to get a usable URL.
Example:https://image.migros.ch/coupons/{stack}/5263e8a6f3282b7f411ae5fce947d7acb65db939.png
languagestringrequired
Example:de
linksobject
Represents the links on a coupon based on MDB+.
Show Child Parameters
matching_productsinteger
Number of products applicable to thos Coupon.
If this number is not know or the Coupon is applicable to all products this field is ommited.
minimum_purchasestring
Example:Mindesteinkauf CHF 14.90
minimum_purchase_valuenumber(float)
Example:14.9
namestringrequired
Example:Gesamtes Migros-Supermarkt-Sortiment
name_appstring
Example:Gesamtes Migros-Supermarkt-Sortiment
name_webstring
Example:Gesamtes Migros-Supermarkt-Sortiment
personalboolean
Example:true
previewsarray[string]
An Image URL template. Replace the placeholder {stack} with an available Rokka stack, e.g “original” to get a usable URL.
Example:https://image.migros.ch/coupons/{stack}/5263e8a6f3282b7f411ae5fce947d7acb65db939.png
promocodestring
Optional promotion code for Partnercoupons
Example:SommerSale23
promotion_numberstring
Example:C-ID 1871947
redeemable_areastring
Example:Nur regional einlösbar
redeemable_atstring
Example:Einlösbar in allen Migros-Filialen in der Schweiz gegen Vorweisen der Cumulus-Karte sowie auf Migros Online.
regionsarray[string]
List of IDs where this Coupon can be redeemed.
Example:["ONLINE_SHOP","GMAA","GMZH"]
signetobject
A coupon signet and its properties.
Show Child Parameters
signet_bonuscouponstring
An Image URL template. Replace the placeholder {stack} with an available Rokka stack, e.g “original” to get a usable URL.
Example:https://image.migros.ch/coupons/{stack}/5263e8a6f3282b7f411ae5fce947d7acb65db939.png
signet_inactiveobject
A coupon signet and its properties.
Show Child Parameters
start_datestring
stationary_redeemableboolean
Example:false
subtitlestring
Example:[ "" ]
type_idstring
Example:8
variantstring
Example:Rabattcoupon
whole_assortmentboolean
Indicates whether this Coupon is applicable to all products.
get/migros/customers/coupons/v3/coupons/{id}
Authentication
Path Parameters
Query Parameters
application/json
Match a set of product IDs against this Coupon
This endpoint allows to test a list of product IDs whether the product would be matched by this coupon or not.
Only Rabattcoupons and Bonuscoupons provide this functionality list, Partnercoupons will result in a 404 status code. Calling this endpoint on a Bonuscoupons is pointless as it matches the whole assortment (i.e. all products) by definition; but it’s possible.
Like in the …/products endpoint this endpoint operates with the IDs of actual, buyable products as well as the corresponding “Sammler” products.
The response contains those queried IDs that qualifiy for the Coupon.
post
https://api-qual.migros.ch/migros/customers/coupons/v3/coupons/{id}/matches
Path Parameters
idintegerrequired
Coupon ID (the M-Promo ID, not the GTIN).
Example:234531
Body
application/x-www-form-urlencoded
Body
application/x-www-form-urlencoded
Product IDs to check, provided as (multiple) id form parameter(s).
idarray[string]required
Example:166002100000
Response
application/json
Response
application/json
Array of those IDs that this Coupon applies to.
ProductList
ProductListarray[string]
List of product IDs matching a couopon.
post/migros/customers/coupons/v3/coupons/{id}/matches
Authentication
Path Parameters
Body
{
"id": [
"166002100000"
]
}
application/json
List product IDs matching a Coupon.
This endpoint provides the list of IDs of those products affected by the given Rabatt-Coupon. The list has no special sorting and might be a day outdated.
The list contains the IDs of actual, buyable products and the ID of the relevant “Sammler”-product.
Only Rabattcoupons and Bonuscoupons provide this article list, Partnercoupons will result in a 404 status code. As Bonuscoupons always apply to all products calling this endpoint with a Bonuscoupon is pointless, you just get back the 204 status described below.
The list is caped to 2000 elements in case more products match this coupon.
Some Coupons match the whole assortment. Instead of returning an arbitrarily caped list we return 204 and no body.
get
https://api-qual.migros.ch/migros/customers/coupons/v3/coupons/{id}/products
Path Parameters
idintegerrequired
Coupon ID (the M-Promo ID, not the GTIN).
Example:234531
Response
application/json
Response
application/json
Array of up to 2000 article IDs.
ProductList
ProductListarray[string]
List of product IDs matching a couopon.
get/migros/customers/coupons/v3/coupons/{id}/products
Authentication
Path Parameters
application/json
List of all Partner-Coupons
This endpoint provides a list of all Partnercoupons.
This list includes only Partnercoupons, normal Migros-Coupons and POS-Coupons are not part of this list.
get
https://api-qual.migros.ch/migros/customers/coupons/v3/partnercoupons
Query Parameters
langstring
Override Accept-Language header
Allowed values:defritexperimental_en
Response
application/json
Response
application/json
Array of partnercoupons
Represents the coupon information based on MDB+.
campaign_colorsobject
Optional special colors for special campaigns
Show Child Parameters
campaign_idstring
The ID of the campaign, if this coupon is part of a campaign.
Example:e58efb75-2327-4b98-aeb0-1f7d9a2f5f1e
customer_groupstring
Example:cumulus
digitalboolean
Example:true
disclaimerstring
Terms and conditions.
Example:Ausgenommen sind Gebührensäcke, -marken, Vignetten, Depots, Serviceleistungen, E-Loading, iTunes/App-Karten, SIM-Karten, Gutscheine, Geschenkkarten, Geschenkboxen und alkoholische Getränke. Nur einmalig einlösbar in Verbindung mit der angegebenen Cumulus-Nummer.
discount_amountstring
Example:5-fach Punkte
discount_amount_valuestring
Example:5.0
discount_typestring
Example:mehrfach
distribution_channelsobject
The list of distribution channels (Micasa, Do It, SportX …) this coupon is usable in.
Show Child Parameters
end_datestring
Example:31.10.2024
fine_printstring
gtinrequired
GTIN (EAN) of Coupon. Some Partnercoupons do not have GTINs.
Example:8888122276132945500263
idstringrequired
The ID of the Coupon. This is the same as the M-Promo ID; ReTi and MDB+ call this Offer ID".
Example:1871947
imagestring
An Image URL template. Replace the placeholder {stack} with an available Rokka stack, e.g “original” to get a usable URL.
Example:https://image.migros.ch/coupons/{stack}/5263e8a6f3282b7f411ae5fce947d7acb65db939.png
image_inactivestring
An Image URL template. Replace the placeholder {stack} with an available Rokka stack, e.g “original” to get a usable URL.
Example:https://image.migros.ch/coupons/{stack}/5263e8a6f3282b7f411ae5fce947d7acb65db939.png
languagestringrequired
Example:de
linksobject
Represents the links on a coupon based on MDB+.
Show Child Parameters
matching_productsinteger
Number of products applicable to thos Coupon.
If this number is not know or the Coupon is applicable to all products this field is ommited.
minimum_purchasestring
Example:Mindesteinkauf CHF 14.90
minimum_purchase_valuenumber(float)
Example:14.9
namestringrequired
Example:Gesamtes Migros-Supermarkt-Sortiment
name_appstring
Example:Gesamtes Migros-Supermarkt-Sortiment
name_webstring
Example:Gesamtes Migros-Supermarkt-Sortiment
personalboolean
Example:true
previewsarray[string]
An Image URL template. Replace the placeholder {stack} with an available Rokka stack, e.g “original” to get a usable URL.
Example:https://image.migros.ch/coupons/{stack}/5263e8a6f3282b7f411ae5fce947d7acb65db939.png
promocodestring
Optional promotion code for Partnercoupons
Example:SommerSale23
promotion_numberstring
Example:C-ID 1871947
redeemable_areastring
Example:Nur regional einlösbar
redeemable_atstring
Example:Einlösbar in allen Migros-Filialen in der Schweiz gegen Vorweisen der Cumulus-Karte sowie auf Migros Online.
regionsarray[string]
List of IDs where this Coupon can be redeemed.
Example:["ONLINE_SHOP","GMAA","GMZH"]
signetobject
A coupon signet and its properties.
Show Child Parameters
signet_bonuscouponstring
An Image URL template. Replace the placeholder {stack} with an available Rokka stack, e.g “original” to get a usable URL.
Example:https://image.migros.ch/coupons/{stack}/5263e8a6f3282b7f411ae5fce947d7acb65db939.png
signet_inactiveobject
A coupon signet and its properties.
Show Child Parameters
start_datestring
stationary_redeemableboolean
Example:false
subtitlestring
Example:[ "" ]
type_idstring
Example:8
variantstring
Example:Rabattcoupon
whole_assortmentboolean
Indicates whether this Coupon is applicable to all products.
get/migros/customers/coupons/v3/partnercoupons
Authentication
Query Parameters
application/json
Fetch data for a POS-Coupon
Retrieve the data of a POS-Coupon. This endpoint is (only) used by the Avnata cash registers.
get
https://api-qual.migros.ch/migros/customers/coupons/v3/poscoupons/{gtin}
Query Parameters
langstring
Override Accept-Language header
Allowed values:defrit
Path Parameters
gtinstringrequired
GTIN (EAN) of Coupon. Its a string as GTINs often are longer than what integers can represent.
Match pattern:^\d+$
Response
application/json
Response
application/json
POS-Coupon data
POSCoupon
Represents the POS-Coupon information.
disclaimer_rowsarray[string]
Example:["Nur solange Vorrat.","Sortiment teilweise nur in grösseren Migros-","Filialen erhältlich."]
discount_amountstringrequired
Example:40-fach Punkte
end_datestringrequired
Example:31.10.2024
export_descrstring
Example:PosCoupon 40-fach
gtinrequired
GTIN (EAN) of Coupon. Some Partnercoupons do not have GTINs.
Example:8888122276132945500263
idstringrequired
The ID of the Coupon. This is the same as the M-Promo ID; ReTi and MDB+ call this Offer ID".
Example:1871947
languagestringrequired
Example:de
minimum_purchasestringrequired
Example:Kein Mindesteinkauf
name_rowsarray[string]
Example:["Alle frischen Bohnen","in Selbstbedienung"]
pointfactorstring
Example:40.0
pointfixstring
promofactorstring
promotion_numberstring
Example:C-ID 2060566
redeemable_areastring
redeemable_atstring
Example:Einlösbar in allen Migros-Filialen in der Schweiz gegen Vorweisen der Cumulus-Karte
reductionstring
signetobject
Show Child Parameters
start_datestring
subtitle_rowsarray[string]required
Example:["(ohne Migros-Bio,","ohne Demeter)"]
type_gkstring
Example:2453
valuestringrequired
Example:40-fach Punkte mehrfach
get/migros/customers/coupons/v3/poscoupons/{gtin}
Authentication
Path Parameters
Query Parameters
application/json