---
title: "Get a single label."
url: "https://developer-qual.migros.ch/apis/odin-1/versions/ea750027-e89a-4267-ace5-9e2cc74dc68b/operations/get-single-migrolino-label"
---

> Full API specification: https://developer-qual.migros.ch/apis/odin-1/versions/ea750027-e89a-4267-ace5-9e2cc74dc68b.md

# Get a single label.

`GET` `/migrolino/products/odin/v1/label/{labelID}`

Operation ID: `get-single-migrolino-label`

Gets a label by it's label ID.

## Path parameters

- `labelID` (string, required) - ID of the label

## Responses

- `200` - Returns a single label
- `404` - Does not find the product.

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Odin
  version: 1.0.0
servers:
  - description: URL of upstream
    url: https://api-qual.migros.ch
paths:
  /migrolino/products/odin/v1/label/{labelID}:
    get:
      description: Gets a label by it's label ID.
      operationId: get-single-migrolino-label
      parameters:
        - $ref: "#/components/parameters/labelID"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/LabelResponse"
          description: Returns a single label
        "404":
          content:
            text/plain:
              example: Product not found for the given GTIN.
          description: Does not find the product.
      summary: Get a single label.
      tags:
        - ESL-Migrolino
security:
  - Kong-Api-Key: []
components:
  parameters:
    labelID:
      description: ID of the label
      in: path
      name: labelID
      required: true
      schema:
        example: 0BC62A0BB696
        type: string
  schemas:
    LabelResponse:
      description: A label represents the meta data object to link a store, product
        and a label together. TODO maybe add @product
      properties:
        labelID:
          description: Is the label unique identifier
          maxLength: 12
          minLength: 12
          type: string
        product:
          allOf:
            - $ref: "#/components/schemas/ProductResponse"
            - description: On a linked Migrolino label, we also return its product.
          nullable: true
        productID:
          description: Is the SAP ID of a product. Note - Not a GTIN.
          maxLength: 12
          minLength: 12
          type: string
        storeID:
          description: Is the migros default way of identifiying stores. Note - Consists
            of 7 digits
          maxLength: 7
          minLength: 7
          type: string
      required:
        - labelID
        - productID
        - storeID
        - product
      type: object
    ProductResponse:
      description: Detailed information about a product.
      properties:
        alternative_gtins:
          description: Alternative GTINs for the product.
          items:
            type: string
          type: array
        base_unit_type:
          description: The base unit type (e.g., CU).
          type: string
        boss_number:
          description: The BOSS number of the product.
          type: string
        brand_code:
          description: The brand code.
          type: string
        brand_name:
          description: The brand name.
          type: string
        brand_type:
          description: The type of brand (e.g., Eigenmarke).
          type: string
        days_until_expiration:
          description: The number of days until the product expires.
          type: integer
        gtin:
          description: The primary GTIN of the product.
          type: string
        id:
          description: ID of the product.
          type: string
        max_order_quantity:
          description: The maximum order quantity for the product.
          type: integer
        name:
          description: Full name of the product.
          type: string
        name_part1:
          description: The first part of the product name.
          type: string
        name_part2:
          description: The second part of the product name.
          type: string
        name_part3:
          description: The third part of the product name.
          type: string
        origin_country_code1:
          description: The primary origin country code.
          type: string
        package:
          description: Information about the product's package.
          properties:
            content:
              description: The content amount of the package.
              type: number
            content_unit_code:
              description: The unit code for the content (e.g., ML).
              type: string
            net_weight:
              description: The net weight of the package.
              type: number
            net_weight_unit_code:
              description: The unit code for the net weight (e.g., KG).
              type: string
          type: object
        prices:
          description: Pricing information for the product across different retailers.
          properties:
            gooods_migrolino_price:
              description: Price at Gooods Migrolino.
              type: number
            migrolino_price:
              description: Price at Migrolino.
              type: number
            mio_shell_price:
              description: Price at Mio Shell.
              type: number
            mio_socar_price:
              description: Price at Mio Socar.
              type: number
            piccadilly_price:
              description: Price at Piccadilly.
              type: number
            shell_price:
              description: Price at Shell.
              type: number
            socar_price:
              description: Price at Socar.
              type: number
          type: object
        product_group_name:
          description: The product group name.
          type: string
        product_group_number:
          description: The product group number.
          type: string
        product_image:
          description: The product image of the product encoded in Base64
          type: string
        sap_creation_date:
          description: The SAP creation date of the product.
          format: date-time
          type: string
        short_name:
          description: Shortened name of the product.
          type: string
        status_name:
          description: The status of the product (e.g., active).
          type: string
        tax_class:
          description: The tax class of the product.
          type: integer
        tax_rate:
          description: The tax rate applicable to the product.
          format: float
          type: number
        transport_unit_type:
          description: The transport unit type (e.g., TU).
          type: string
      type: object
  securitySchemes:
    Kong-Api-Key:
      description: Kong key-auth authentication
      in: header
      name: X-Api-Key
      type: apiKey
```