---
title: "List of all Partner-Coupons"
url: "https://developer-qual.migros.ch/apis/coupons-3/versions/b27797a2-ad08-41e0-8429-0f1aeab8826f/operations/listPartnerCoupons"
---

> Full API specification: https://developer-qual.migros.ch/apis/coupons-3/versions/b27797a2-ad08-41e0-8429-0f1aeab8826f.md

# List of all Partner-Coupons

`GET` `/migros/customers/coupons/v3/partnercoupons`

Operation ID: `listPartnerCoupons`

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.

## Query parameters

- `lang` (string, optional) - Override Accept-Language header

## Responses

- `200` - Array of partnercoupons
- `default` - Standard HTTP semantics (see above), no machine-interpretable body.

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Coupons
  version: 3.4.0
servers:
  - description: URL of upstream
    url: https://api-qual.migros.ch
paths:
  /migros/customers/coupons/v3/partnercoupons:
    get:
      description: >-
        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.
      operationId: listPartnerCoupons
      parameters:
        - $ref: "#/components/parameters/lang"
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  $ref: "#/components/schemas/Coupon"
                type: array
          description: Array of partnercoupons
        default:
          description: Standard HTTP semantics (see above), no machine-interpretable body.
      summary: List of all Partner-Coupons
      tags:
        - Coupon-Data
security:
  - Kong-Api-Key: []
  - Basic-Auth: []
components:
  parameters:
    lang:
      description: Override Accept-Language header
      in: query
      name: lang
      schema:
        enum:
          - de
          - fr
          - it
          - experimental_en
        type: string
  schemas:
    Coupon:
      description: Represents the coupon information based on MDB+.
      properties:
        campaign_colors:
          description: Optional special colors for special campaigns
          properties:
            dark:
              example: "#66601C"
              type: string
            light:
              example: "#EDEACD"
              type: string
          required:
            - dark
            - light
          type: object
        campaign_id:
          description: The ID of the campaign, if this coupon is part of a campaign.
          example: e58efb75-2327-4b98-aeb0-1f7d9a2f5f1e
          type: string
        customer_group:
          example: cumulus
          type: string
        digital:
          example: true
          type: boolean
        disclaimer:
          description: 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.
          type: string
        discount_amount:
          example: 5-fach Punkte
          type: string
        discount_amount_value:
          example: "5.0"
          type: string
        discount_type:
          example: mehrfach
          type: string
        distribution_channels:
          $ref: "#/components/schemas/DistributionChannels"
        end_date:
          example: 31.10.2024
          type: string
        fine_print:
          type: string
        gtin:
          description: GTIN (EAN) of Coupon. Some Partnercoupons do not have GTINs.
          example: "8888122276132945500263"
        id:
          description: The ID of the Coupon. This is the same as the M-Promo ID; ReTi and
            MDB+ call this Offer ID".
          example: "1871947"
          type: string
        image:
          $ref: "#/components/schemas/Image"
        image_inactive:
          $ref: "#/components/schemas/Image"
        language:
          example: de
          type: string
        links:
          $ref: "#/components/schemas/CouponLinks"
        matching_products:
          description: >-
            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.
          type: integer
        minimum_purchase:
          example: Mindesteinkauf CHF 14.90
          type: string
        minimum_purchase_value:
          example: 14.9
          format: float
          type: number
        name:
          example: Gesamtes Migros-Supermarkt-Sortiment
          type: string
        name_app:
          example: Gesamtes Migros-Supermarkt-Sortiment
          type: string
        name_web:
          example: Gesamtes Migros-Supermarkt-Sortiment
          type: string
        personal:
          example: true
          type: boolean
        previews:
          items:
            $ref: "#/components/schemas/Image"
          type: array
        promocode:
          description: Optional promotion code for Partnercoupons
          example: SommerSale23
          type: string
        promotion_number:
          example: C-ID 1871947
          type: string
        redeemable_area:
          example: Nur regional einlösbar
          type: string
        redeemable_at:
          example: Einlösbar in allen Migros-Filialen in der Schweiz gegen Vorweisen der
            Cumulus-Karte sowie auf Migros Online.
          type: string
        regions:
          description: List of IDs where this Coupon can be redeemed.
          example:
            - ONLINE_SHOP
            - GMAA
            - GMZH
          items:
            type: string
          type: array
        signet:
          $ref: "#/components/schemas/CouponSignet"
        signet_bonuscoupon:
          $ref: "#/components/schemas/Image"
        signet_inactive:
          $ref: "#/components/schemas/CouponSignet"
        start_date:
          type: string
        stationary_redeemable:
          example: false
          type: boolean
        subtitle:
          example: ""
          type: string
        type_id:
          example: "8"
          type: string
        variant:
          example: Rabattcoupon
          type: string
        whole_assortment:
          description: Indicates whether this Coupon is applicable to all products.
          type: boolean
      required:
        - gtin
        - id
        - language
        - name
      type: object
    DistributionChannels:
      description: The list of distribution channels (Micasa, Do It, SportX ...) this
        coupon is usable in.
      properties:
        channels:
          description: All the distribution channels.
          items:
            properties:
              filter:
                example: bikeworld
                type: string
              filter_id:
                example: "12"
                type: string
              id:
                example: bikeworld
                type: string
              logo:
                $ref: "#/components/schemas/Image"
              logo_inactive:
                $ref: "#/components/schemas/Image"
              logo_master:
                type: boolean
              name:
                example: Bike World
                type: string
            type: object
          type: array
        text:
          example: Einlösbar in allen Migros- und Fachmarkt-Filialen sowie auf Migros
            Online und den Online-Shops der Fachmärkte.
          type: string
      required:
        - channels
      type: object
    Image:
      description: 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
      type: string
    CouponLinks:
      description: Represents the links on a coupon based on MDB+.
      properties:
        note:
          description: Note about link
          example: Im Online-Shop einlösbar
          type: string
        onlineshop:
          description: Link information.
          properties:
            name:
              description: Human readable name of the third-party website (for example SportX,
                micasa, Migipedia).
              example: Onlineshop
              type: string
            type:
              description: Link type
              example: info
              type: string
            url:
              description: URL to a third-party desktop page of the product.
              example: https://www.micasa.ch/
              type: string
          type: object
      type: object
    CouponSignet:
      description: A coupon signet and its properties.
      properties:
        hex_color:
          description: The hexadecimal color code for this signet.
          example: "#003D8C"
          type: string
        logo:
          description: The logo only of the signet
          properties:
            name:
              description: Logo name, useful for example as alt attribute.
              type: string
            vector:
              description: URL of vector image (SVG).
              type: string
          type: object
        stack:
          description: An URL template to a raster/pixel image. Replace the placeholder
            {stack} with an available Rokka stack, e.g "original" to get a
            usable URL.
          example: https://image.migros.ch/coupons/{stack}/ebeaebd5907eeba6a7dab3b1776632f1d3436c81.png
          type: string
        vector:
          description: URL of vector image (SVG).
          example: https://image.migros.ch/coupons/original/be0c000a3088bac1c429d9dd3da16b3081482b7e.svg
          type: string
      type: object
  securitySchemes:
    Kong-Api-Key:
      description: Kong key-auth authentication
      in: header
      name: X-Api-Key
      type: apiKey
    Basic-Auth:
      description: Kong basic-auth authentication
      scheme: basic
      type: http
```