---
title: "Fetch data for a POS-Coupon"
url: "https://developer-qual.migros.ch/apis/coupons-3/versions/b27797a2-ad08-41e0-8429-0f1aeab8826f/operations/getPOSCoupon"
---

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

# Fetch data for a POS-Coupon

`GET` `/migros/customers/coupons/v3/poscoupons/{gtin}`

Operation ID: `getPOSCoupon`

Retrieve the data of a POS-Coupon. This endpoint is (only) used by the Avnata cash registers.

## Path parameters

- `gtin` (string, required) - GTIN (EAN) of Coupon. Its a string as GTINs often are longer than what integers can represent.

## Query parameters

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

## Responses

- `200` - POS-Coupon data
- `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/poscoupons/{gtin}:
    get:
      description: Retrieve the data of a POS-Coupon. This endpoint is (only) used by
        the Avnata cash registers.
      operationId: getPOSCoupon
      parameters:
        - $ref: "#/components/parameters/lang-without-en"
        - $ref: "#/components/parameters/gtin"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/POSCoupon"
          description: POS-Coupon data
          headers:
            X-Coupon-Count:
              description: Size of list in response body.
              schema:
                type: integer
        default:
          description: Standard HTTP semantics (see above), no machine-interpretable body.
      security:
        - Basic-Auth: []
      summary: Fetch data for a POS-Coupon
      tags:
        - Coupon-Data
security:
  - Basic-Auth: []
components:
  parameters:
    lang-without-en:
      description: Override Accept-Language header
      in: query
      name: lang
      schema:
        enum:
          - de
          - fr
          - it
        type: string
    gtin:
      description: GTIN (EAN) of Coupon. Its a string as GTINs often are longer than
        what integers can represent.
      in: path
      name: gtin
      required: true
      schema:
        pattern: ^\d+$
        type: string
  schemas:
    POSCoupon:
      description: Represents the POS-Coupon information.
      properties:
        disclaimer_rows:
          example:
            - Nur solange Vorrat.
            - Sortiment teilweise nur in grösseren Migros-
            - Filialen erhältlich.
          items:
            type: string
          type: array
        discount_amount:
          example: 40-fach Punkte
          type: string
        end_date:
          example: 31.10.2024
          type: string
        export_descr:
          example: PosCoupon 40-fach
          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
        language:
          example: de
          type: string
        minimum_purchase:
          example: Kein Mindesteinkauf
          type: string
        name_rows:
          example:
            - Alle frischen Bohnen
            - in Selbstbedienung
          items:
            type: string
          type: array
        pointfactor:
          example: "40.0"
          type: string
        pointfix:
          type: string
        promofactor:
          type: string
        promotion_number:
          example: C-ID 2060566
          type: string
        redeemable_area:
          type: string
        redeemable_at:
          example: Einlösbar in allen Migros-Filialen in der Schweiz gegen Vorweisen der
            Cumulus-Karte
          type: string
        reduction:
          type: string
        signet:
          properties:
            pos_id:
              example: 05_3_40_de
              type: string
          type: object
        start_date:
          type: string
        subtitle_rows:
          example:
            - (ohne Migros-Bio,
            - ohne Demeter)
          items:
            type: string
          type: array
        type_gk:
          example: "2453"
          type: string
        value:
          example: 40-fach Punkte mehrfach
          type: string
      required:
        - gtin
        - id
        - language
        - discount_amount
        - minimum_purchase
        - end_date
        - subtitle_rows
        - value
      type: object
  securitySchemes:
    Basic-Auth:
      description: Kong basic-auth authentication
      scheme: basic
      type: http
```