---
title: "Get a single type of gift card (language-dependent)"
url: "https://developer-qual.migros.ch/apis/gift-cards-8/versions/b5f9bbcd-ab06-4dcd-a09c-7fc0b4a1baf0/operations/get-giftcard"
---

> Full API specification: https://developer-qual.migros.ch/apis/gift-cards-8/versions/b5f9bbcd-ab06-4dcd-a09c-7fc0b4a1baf0.md

# Get a single type of gift card (language-dependent)

`GET` `/migros/customers/payment-methods/v1/giftcards/{id}`

Operation ID: `get-giftcard`

Get information about a single type of gift card by ID. Specify language via Accept-Language header.

## Path parameters

- `id` (string, required) - Gift card ID

## Query parameters

- `lang` (string, optional) - Defines the language (de/fr/it/en) for this request as query parameter. Either use the query param "lang" or header "Accept-Language", not both.

## Header parameters

- `Accept-Language` (string, optional) - Defines the language (de/fr/it/en) for this request as request header. Either use the query param "lang" or header "Accept-Language", not both.

## Responses

- `200` - Returned when successful

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Gift Cards
  version: "8"
servers:
  - description: URL of upstream
    url: https://api-qual.migros.ch
paths:
  /migros/customers/payment-methods/v1/giftcards/{id}:
    get:
      description: |-
        Get information about a single type of gift card by ID.

        Specify language via Accept-Language header.
      operationId: get-giftcard
      parameters:
        - description: Gift card ID
          in: path
          name: id
          required: true
          schema:
            type: string
        - $ref: "#/components/parameters/lang"
        - $ref: "#/components/parameters/Accept-Language"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GiftCard"
          description: Returned when successful
      summary: Get a single type of gift card (language-dependent)
      tags:
        - Gift Cards
security:
  - Kong-Api-Key: []
    basicAuth: []
components:
  parameters:
    lang:
      description: Defines the language (de/fr/it/en) for this request as query
        parameter. Either use the query param "lang" or header
        "Accept-Language", not both.
      in: query
      name: lang
      schema:
        default: de
        enum:
          - de
          - fr
          - it
          - en
        type: string
    Accept-Language:
      description: Defines the language (de/fr/it/en) for this request as request
        header. Either use the query param "lang" or header "Accept-Language",
        not both.
      in: header
      name: Accept-Language
      schema:
        default: de
        enum:
          - de
          - fr
          - it
          - en
        type: string
  schemas:
    GiftCard:
      description: Represents a gift card in the API.
      properties:
        classifications:
          description: Collection of classification instances.
          items:
            $ref: "#/components/schemas/Classification"
          type: array
        digital:
          description: Is this a digital gift card or not.
          type: boolean
        disclaimer:
          description: Terms and conditions.
          nullable: true
          type: string
        hint:
          nullable: true
          type: string
        id:
          description: ID of the gift card.
          type: string
        image:
          nullable: true
          oneOf:
            - $ref: "#/components/schemas/Image"
        name:
          type: string
      required:
        - id
        - name
      type: object
    Classification:
      description: Represents a gift card classification.
      properties:
        category_code:
          type: string
        label:
          nullable: true
          type: string
        label_code:
          description: Position in the category.
          type: string
        position_in_category:
          type: integer
        value:
          description: Value of the classification.
          nullable: true
          type: string
        value_code:
          description: Value code of the classification.
          nullable: true
          type: string
      required:
        - label_code
      type: object
    Image:
      description: An image and its properties.
      properties:
        code:
          deprecated: true
          description: Code for the image, useful for pictograms.
          nullable: true
          type: string
        custom:
          deprecated: true
          description: Image URL with placeholders for {width} and {height}.
          type: string
        description:
          deprecated: true
          description: Image description, useful for example as alt attribute.
          nullable: true
          type: string
        end_date:
          deprecated: true
          description: End date of the validity.
          format: date-time
          nullable: true
          type: string
        hash:
          deprecated: true
          description: Sha1 hash of original image.
          nullable: true
          type: string
        original:
          deprecated: true
          description: Full size image.
          type: string
        source:
          deprecated: true
          description: Source where the image comes from originally.
          nullable: true
          type: string
        stack:
          deprecated: true
          description: Image URL with a placeholder for a Rokka {stack}.
          type: string
        start_date:
          deprecated: true
          description: Start date of the validity.
          format: date-time
          nullable: true
          type: string
        tags:
          deprecated: true
          items:
            type: string
          type: array
      type: object
  securitySchemes:
    Kong-Api-Key:
      description: Kong key-auth authentication
      in: header
      name: X-Api-Key
      type: apiKey
    basicAuth:
      scheme: basic
      type: http
```