---
title: "Returns information about a single label by ID or slug."
url: "https://developer-qual.migros.ch/apis/labels-8/versions/0e6de93c-9b6f-4b5c-b003-c0de2deadada/operations/getLabel"
---

> Full API specification: https://developer-qual.migros.ch/apis/labels-8/versions/0e6de93c-9b6f-4b5c-b003-c0de2deadada.md

# Returns information about a single label by ID or slug.

`GET` `/migros/products/v8/labels/{id}`

Operation ID: `getLabel`

Returns information about a single label by ID or slug.

## Path parameters

- `id` (string, required) - Resource ID.

## Query parameters

- `lang` (string, optional) - The language to be used. Possible values: `de`, `fr`, `it`, `en`. The language may also be set via HTTP header, e.g. `Accept-Language: de` header.

## Responses

- `200` - Returned when successful
- `404` - Returned when the requested resource could not be not found.

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Labels
  version: "8"
servers:
  - description: Public Kong Gateway URL
    url: https://api-qual.migros.ch
paths:
  /migros/products/v8/labels/{id}:
    get:
      description: Returns information about a single label by ID or slug.
      operationId: getLabel
      parameters:
        - description: Resource ID.
          in: path
          name: id
          required: true
          schema:
            type: string
        - description: "The language to be used. Possible values: `de`, `fr`, `it`, `en`.
            The language may also be set via HTTP header, e.g. `Accept-Language:
            de` header."
          in: query
          name: lang
          required: false
          schema:
            default: de
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Label"
          description: Returned when successful
        "404":
          $ref: "#/components/responses/404"
      summary: Returns information about a single label by ID or slug.
      tags:
        - Labels
security:
  - Kong-Api-Key: []
  - basicAuth: []
components:
  schemas:
    Label:
      description: Represents the Label information in the Product.
      properties:
        description:
          description: The long description of the label (can contain HTML).
          nullable: true
          type: string
        id:
          description: ID of the label.
          type: string
        image:
          description: Image of the label.
          nullable: true
          oneOf:
            - $ref: "#/components/schemas/Image"
        links:
          additionalProperties:
            $ref: "#/components/schemas/Link"
          description: Collection of links indexed by string identifier.
          type: object
        name:
          description: Name of the label.
          type: string
        position_for_product_title:
          description: Indicates placement of the short name label in product title
          nullable: true
          type: string
        short_name_for_product_title:
          description: Shorter label variant of the product title
          nullable: true
          type: string
        slug:
          description: Unique user-friendly ID.
          type: string
      required:
        - id
        - name
        - slug
      type: object
    Image:
      description: An image and its properties.
      properties:
        original:
          description: Full size image.
          type: string
        stack:
          description: Image URL with a placeholder for a Rokka {stack}.
          type: string
      type: object
    Link:
      properties:
        url:
          description: URL to a third-party desktop page of the product.
          type: string
      type: object
  responses:
    "404":
      description: Returned when the requested resource could not be not found.
  securitySchemes:
    Kong-Api-Key:
      description: Kong key-auth authentication
      in: header
      name: X-Api-Key
      type: apiKey
    basicAuth:
      scheme: basic
      type: http
```