---
title: "Rendered warranty"
url: "https://developer-qual.migros.ch/apis/layout-api-1/versions/fcc71337-b27c-4bc7-8aea-a50107bf562d/operations/warrantyDetail"
---

> Full API specification: https://developer-qual.migros.ch/apis/layout-api-1/versions/fcc71337-b27c-4bc7-8aea-a50107bf562d.md

# Rendered warranty

`GET` `/migros/customers/warranties/v1/detail/{cumulus}/{warrantyId}`

Operation ID: `warrantyDetail`

Render a warranty (Garantieschein) as HTML, PDF or JSON. You can also provide the format as a filename extension like in ...v3/{cumulus}/warranty/detail/{warrantyId}.[pdf|html|json] . All information is formated like specified for digital view.

## Path parameters

- `cumulus` (integer, required) - Cumulus Number
- `warrantyId` (string, required) - warrantyId of the warrranty as returned from the .../warranty/list or .../warranty/xlist endpoints.

## Responses

- `200` - Warranty as HTML, PDF or JSON

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Layout-API
  version: 1.3.0
servers:
  - description: URL of upstream
    url: https://api-qual.migros.ch
paths:
  /migros/customers/warranties/v1/detail/{cumulus}/{warrantyId}:
    get:
      description: >-
        Render a warranty (Garantieschein) as HTML, PDF or JSON.


        You can also provide the format as a filename extension like in
        ...v3/{cumulus}/warranty/detail/{warrantyId}.[pdf|html|json] . All
        information is formated like specified for digital view.
      operationId: warrantyDetail
      parameters:
        - $ref: "#/components/parameters/cumulus"
        - description: warrantyId of the warrranty as returned from the .../warranty/list
            or .../warranty/xlist endpoints.
          in: path
          name: warrantyId
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/WarrantyDetailResponse"
            application/pdf:
              schema:
                type: string
            text/html:
              schema:
                type: string
          description: Warranty as HTML, PDF or JSON
      summary: Rendered warranty
      tags:
        - Warranty
security:
  - Kong-Api-Key: []
components:
  parameters:
    cumulus:
      description: Cumulus Number
      example: 2099123456789
      in: path
      name: cumulus
      required: true
      schema:
        maximum: 2099999999999
        minimum: 2098000000000
        type: integer
  schemas:
    WarrantyDetailResponse:
      properties:
        articleDescription:
          description: Article description.
          example: MediaPadT5 10.1 WiFi s
          type: string
        articleNumber:
          description: Unique article identifer. Product-ID.
          example: "798458800000"
          type: string
        articlePrice:
          description: Full article price without reductions in CHF.
          example: 274
          type: number
        articlePriceNetto:
          description: Article price after reductions in CHF.
          example: 229
          type: number
        articleReduction:
          description: Article price reduction in CHF.
          example: -45
          type: number
        buyTime:
          description: Time on which the article which issues a warranty has been
            acquired. Provided in MMHHSS.
          example: "110457"
          type: string
        cashier:
          description: Cashier number which can be back referenced to the real person.
          example: "0533572"
          type: string
        cooperative:
          description: Cooperative ID (Genossenschaft). Online purchases are listed as
            cooperative 202.
          example: MEL Rothenburg
          type: string
        cumulus:
          description: Cumulus number of the customer.
          example: "2099318037622"
          type: string
        cumulusPointsTotal:
          description: Cumulus total acquired including this transaction.
          example: 1000
          type: number
        cumulusPointsTotalDate:
          description: Date of the latest transaction. Usually the same as buyDate.
            Provided in YYYYMMDD.
          example: 20190927
          type: integer
        storeId:
          description: Unique store identifier. Filial-ID
          example: "0150475"
          type: string
        storeLang:
          description: Language of the store in which the warranty has been acquired. The
            warranty will be computed in the given store lang.
          enum:
            - DE
            - FR
            - IT
          example: DE
          type: string
        storeName:
          description: Name of the store.
          example: MEL Limmatplatz
          type: string
        terminal:
          description: Terminal number which was used to issue the transaction. Real
            "Kasse".
          example: "042"
          type: string
        transactionDate:
          description: Date on which the article warranty has been computed. Pretty much
            going to be the same as buyDate. Provided in YYYYMMDD.
          example: 20190927
          type: integer
        transactionNumber:
          description: Transaction number of the purchase itself. If you bought different
            articles with warranties in the same transaction, this number will
            stay the same.
          example: 20220124_174650_0045160_046_203
          type: string
        trxNum:
          description: Misc number which will be shown on the warranty footer.
          example: "0025"
          type: string
        warranty:
          description: Displayed number of the warranty, this is not an unique identifier.
          example: 0150475 042002501
          type: string
        warrantyDuration:
          description: Complete length of the warranty duration in months.
          example: 24
          type: integer
        warrantyId:
          description: Warranty unique identifier.
          example: 20220124_174650_0045160_046_203_0
          type: string
        warrantyUntil:
          description: Exact date when the warranty will expire. Provided in YYYYMMDD.
          example: 20210921
          type: integer
      required:
        - articleDescription
        - articleNumber
        - articlePrice
        - articlePriceNetto
        - articleReduction
        - buyTime
        - cashier
        - cooperative
        - cumulus
        - cumulusPointsTotal
        - storeId
        - storeLang
        - storeName
        - terminal
        - transactionDate
        - transactionNumber
        - trxNum
        - warranty
        - warrantyDuration
        - warrantyId
        - warrantyUntil
      type: object
  securitySchemes:
    Kong-Api-Key:
      description: Kong key-auth authentication
      in: header
      name: X-Api-Key
      type: apiKey
```