---
title: "Deactivate a Coupon"
url: "https://developer-qual.migros.ch/apis/coupons-3/versions/b27797a2-ad08-41e0-8429-0f1aeab8826f/operations/deactivateCouponPublic"
---

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

# Deactivate a Coupon

`POST` `/migros/customers/publiccoupons/v3/users/{cumulus}/coupons/{gtin}:deactivate`

Operation ID: `deactivateCouponPublic`

Only non-redeem Coupons can be deactivated. It's okay to deactivate an already inactive Coupon. **Note**: The parameters can be sent as query parameters in the URL or as application/x-www-form-urlencoded in the request body (or any combination, it just doesn't matter.)

## Path parameters

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

## Responses

- `204` - Successfully deactivated
- `409` - Maximum number of simultaneous active Coupons was exceeded. No need to retry the operation you get the same result over and over until you deactivate or redeem any other Coupon.
- `default` - Standard HTTP semantics, 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/publiccoupons/v3/users/{cumulus}/coupons/{gtin}:deactivate:
    post:
      description: >-
        Only non-redeem Coupons can be deactivated. It's okay to deactivate an
        already inactive Coupon.


        **Note**: The parameters can be sent as query parameters in the URL or
        as application/x-www-form-urlencoded in the request body (or any
        combination, it just doesn't matter.)
      operationId: deactivateCouponPublic
      parameters:
        - $ref: "#/components/parameters/cumulus"
        - $ref: "#/components/parameters/gtin"
      responses:
        "204":
          description: Successfully deactivated
        "409":
          $ref: "#/components/responses/409"
        default:
          description: Standard HTTP semantics, no machine-interpretable body.
      summary: Deactivate a Coupon
      tags:
        - Lekker
security:
  - Kong-Api-Key: []
  - Basic-Auth: []
components:
  parameters:
    cumulus:
      description: Cumulus number.
      example: "2099123456789"
      in: path
      name: cumulus
      required: true
      schema:
        maxLength: 13
        minLength: 13
        pattern: ^\d{13}$
        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
  responses:
    "409":
      description: Maximum number of simultaneous active Coupons was exceeded. No need
        to retry the operation you get the same result over and over until you
        deactivate or redeem any other Coupon.
  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
```