---
title: "Retrieve a store by id."
url: "https://developer-qual.migros.ch/apis/stores-api-1/versions/d092d138-22ea-4d50-9f9f-f4bbba8fa18e/paths/migros-sales-branches-v1-stores-id/get"
---

> Full API specification: https://developer-qual.migros.ch/apis/stores-api-1/versions/d092d138-22ea-4d50-9f9f-f4bbba8fa18e.md

# Retrieve a store by id.

`GET` `/migros/sales/branches/v1/stores/{id}`

Retrieve a store by id.

## Path parameters

- `id` (string, required)

## Query parameters

- `verbosity` (string, optional) - Determines which fields of the store or market objects should be returned
- `computed_opening_hours` (object, optional) - Computed opening hours. Must be an object with start and end properties. Start and end must be valid date strings in the format YYYYMMDD

## Header parameters

- `Accept-Language` (string, optional) - The language of the results.

## Responses

- `200` - Store.
- `400` - Bad Request
- `404` - Not Found

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Stores API
  version: "1.0"
servers:
  - url: https://test-stores-api.intern.migros.net
paths:
  /migros/sales/branches/v1/stores/{id}:
    get:
      description: Retrieve a store by id.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
        - description: Determines which fields of the store or market objects should be
            returned
          in: query
          name: verbosity
          required: false
          schema:
            $ref: "#/components/schemas/verbosity"
        - description: Computed opening hours. Must be an object with start and end
            properties. Start and end must be valid date strings in the format
            YYYYMMDD
          in: query
          name: computed_opening_hours
          required: false
          schema:
            $ref: "#/components/schemas/computedOpeningHours"
          style: deepObject
        - description: The language of the results.
          in: header
          name: Accept-Language
          required: false
          schema:
            $ref: "#/components/schemas/language"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Store"
          description: Store.
        "400":
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      message:
                        type: string
                    required:
                      - message
                    type: object
                required:
                  - error
                type: object
          description: Bad Request
        "404":
          description: Not Found
      security:
        - apikey: []
      summary: Retrieve a store by id.
      tags:
        - cgd
security:
  - apikey: []
components:
  schemas:
    verbosity:
      enum:
        - id
        - store
        - detail
      type: string
    computedOpeningHours:
      additionalProperties: false
      example:
        end: "20260930"
        start: "20260923"
      properties:
        end:
          type: string
        start:
          type: string
      required:
        - start
        - end
      type: object
    language:
      default: de
      enum:
        - de
        - fr
        - it
      example: de
      type: string
    Store:
      allOf:
        - $ref: "#/components/schemas/InvertedStore"
        - properties:
            markets:
              items:
                $ref: "#/components/schemas/Market"
              type: array
          required:
            - markets
          type: object
    InvertedStore:
      properties:
        additional_ids:
          items:
            type: string
          nullable: true
          type: array
        additional_slugs:
          items:
            type: string
          type: array
        cooperative:
          nullable: true
          properties:
            id:
              type: string
            name:
              type: string
            url:
              type: string
          required:
            - id
            - name
            - url
          type: object
        id:
          type: string
        language:
          type: string
        localized_slugs:
          properties:
            de:
              nullable: true
              type: string
            fr:
              nullable: true
              type: string
            it:
              nullable: true
              type: string
          type: object
        location:
          properties:
            address:
              type: string
            address2:
              type: string
            city:
              type: string
            country:
              type: string
            geo:
              properties:
                lat:
                  type: number
                lon:
                  type: number
              required:
                - lat
                - lon
              type: object
            geo_distance:
              properties:
                linear:
                  type: number
                unit:
                  type: string
              required:
                - linear
                - unit
              type: object
            zip:
              type: string
          required:
            - address
            - address2
            - zip
            - city
            - country
            - geo
          type: object
        logo:
          properties:
            alt_text:
              properties:
                de:
                  nullable: true
                  type: string
                fr:
                  nullable: true
                  type: string
                it:
                  nullable: true
                  type: string
              type: object
            custom:
              nullable: true
              type: string
            large:
              nullable: true
              type: string
            medium:
              nullable: true
              type: string
            original:
              nullable: true
              type: string
            small:
              nullable: true
              type: string
            stack:
              nullable: true
              type: string
          required:
            - custom
            - large
            - medium
            - original
            - small
            - stack
          type: object
        name:
          type: string
        phone:
          nullable: true
          type: string
        region:
          type: string
        slug:
          type: string
        type:
          type: string
        types:
          items:
            type: string
          type: array
      required:
        - id
        - additional_ids
        - type
        - name
        - phone
        - slug
        - localized_slugs
        - additional_slugs
        - language
        - region
        - logo
        - cooperative
        - location
      type: object
    Market:
      properties:
        additional_slugs:
          items:
            type: string
          nullable: true
          type: array
        admin_x_kst:
          nullable: true
          type: string
        all_types:
          items:
            type: string
          type: array
        assortments:
          items:
            properties:
              id:
                type: string
              name:
                type: string
            required:
              - id
              - name
            type: object
          type: array
        closing_date:
          anyOf:
            - type: string
            - type: string
            - nullable: true
        computed_opening_hours:
          items:
            $ref: "#/components/schemas/ComputedOpeningHoursResponse"
          nullable: true
          type: array
        cooperative:
          nullable: true
          properties:
            id:
              type: string
            name:
              type: string
            url:
              type: string
          required:
            - id
            - name
            - url
          type: object
        cost_center:
          type: string
        email:
          nullable: true
          type: string
        facebook_id:
          nullable: true
          type: string
        full_name:
          type: string
        hint:
          nullable: true
          type: string
        id:
          type: string
        image:
          properties:
            alt_text:
              properties:
                de:
                  nullable: true
                  type: string
                fr:
                  nullable: true
                  type: string
                it:
                  nullable: true
                  type: string
              type: object
            custom:
              nullable: true
              type: string
            large:
              nullable: true
              type: string
            medium:
              nullable: true
              type: string
            original:
              nullable: true
              type: string
            small:
              nullable: true
              type: string
            stack:
              nullable: true
              type: string
          required:
            - custom
            - large
            - medium
            - original
            - small
            - stack
          type: object
        links:
          items:
            properties:
              code:
                type: string
              label:
                type: string
              text:
                type: string
              url:
                type: string
            required:
              - code
              - text
              - url
            type: object
          type: array
        localized_slugs:
          properties:
            de:
              nullable: true
              type: string
            fr:
              nullable: true
              type: string
            it:
              nullable: true
              type: string
          type: object
        logo:
          properties:
            alt_text:
              properties:
                de:
                  nullable: true
                  type: string
                fr:
                  nullable: true
                  type: string
                it:
                  nullable: true
                  type: string
              type: object
            custom:
              nullable: true
              type: string
            large:
              nullable: true
              type: string
            medium:
              nullable: true
              type: string
            original:
              nullable: true
              type: string
            small:
              nullable: true
              type: string
            stack:
              nullable: true
              type: string
          required:
            - custom
            - large
            - medium
            - original
            - small
            - stack
          type: object
        logo_minimal:
          properties:
            alt_text:
              properties:
                de:
                  nullable: true
                  type: string
                fr:
                  nullable: true
                  type: string
                it:
                  nullable: true
                  type: string
              type: object
            custom:
              nullable: true
              type: string
            large:
              nullable: true
              type: string
            medium:
              nullable: true
              type: string
            original:
              nullable: true
              type: string
            small:
              nullable: true
              type: string
            stack:
              nullable: true
              type: string
          required:
            - custom
            - large
            - medium
            - original
            - small
            - stack
          type: object
        logo_square:
          properties:
            alt_text:
              properties:
                de:
                  nullable: true
                  type: string
                fr:
                  nullable: true
                  type: string
                it:
                  nullable: true
                  type: string
              type: object
            custom:
              nullable: true
              type: string
            large:
              nullable: true
              type: string
            medium:
              nullable: true
              type: string
            original:
              nullable: true
              type: string
            small:
              nullable: true
              type: string
            stack:
              nullable: true
              type: string
          required:
            - custom
            - large
            - medium
            - original
            - small
            - stack
          type: object
        managers:
          items:
            properties:
              firstname:
                type: string
              image:
                properties:
                  alt_text:
                    properties:
                      de:
                        nullable: true
                        type: string
                      fr:
                        nullable: true
                        type: string
                      it:
                        nullable: true
                        type: string
                    type: object
                  custom:
                    nullable: true
                    type: string
                  large:
                    nullable: true
                    type: string
                  medium:
                    nullable: true
                    type: string
                  original:
                    nullable: true
                    type: string
                  small:
                    nullable: true
                    type: string
                  stack:
                    nullable: true
                    type: string
                required:
                  - custom
                  - large
                  - medium
                  - original
                  - small
                  - stack
                type: object
              lastname:
                type: string
            required:
              - firstname
              - lastname
              - image
            type: object
          type: array
        media:
          items:
            properties:
              image:
                nullable: true
                properties:
                  alt_text:
                    properties:
                      de:
                        nullable: true
                        type: string
                      fr:
                        nullable: true
                        type: string
                      it:
                        nullable: true
                        type: string
                    type: object
                  custom:
                    nullable: true
                    type: string
                  large:
                    nullable: true
                    type: string
                  medium:
                    nullable: true
                    type: string
                  original:
                    nullable: true
                    type: string
                  small:
                    nullable: true
                    type: string
                  stack:
                    nullable: true
                    type: string
                required:
                  - custom
                  - large
                  - medium
                  - original
                  - small
                  - stack
                type: object
              source:
                nullable: true
                type: string
              type:
                type: string
              url:
                nullable: true
                type: string
            required:
              - type
              - url
              - source
              - image
            type: object
          type: array
        mpv_vertriebstyp_id:
          nullable: true
          type: string
        name:
          type: string
        opening_date:
          anyOf:
            - type: string
            - type: string
            - nullable: true
        opening_hours:
          items:
            properties:
              active:
                type: boolean
              date_from:
                type: string
              date_to:
                nullable: true
                type: string
              opening_hours:
                items:
                  $ref: "#/components/schemas/OpeningHours"
                type: array
            required:
              - opening_hours
              - active
              - date_to
              - date_from
            type: object
          type: array
        phone:
          nullable: true
          type: string
        prefixed_phone:
          nullable: true
          type: string
        sap_id:
          nullable: true
          type: string
        services:
          items:
            $ref: "#/components/schemas/Service"
          type: array
        slug:
          type: string
        source:
          type: string
        special_day_schedules:
          items:
            $ref: "#/components/schemas/SpecialDaySchedule"
          type: array
        sub_types:
          items:
            type: string
          type: array
        type:
          type: string
        visit_frequencies:
          items:
            properties:
              day_of_week:
                type: number
              hours:
                items:
                  properties:
                    hour:
                      type: number
                    percentage:
                      type: number
                  required:
                    - hour
                    - percentage
                  type: object
                type: array
            required:
              - day_of_week
              - hours
            type: object
          nullable: true
          type: array
        weblink:
          nullable: true
          properties:
            text:
              type: string
            url:
              type: string
          required:
            - text
            - url
          type: object
        x_kst:
          nullable: true
          type: string
        x_kst_gueltigab:
          nullable: true
          type: string
      required:
        - id
        - cooperative
        - localized_slugs
        - cost_center
        - assortments
        - type
        - all_types
        - sub_types
        - name
        - full_name
        - slug
        - additional_slugs
        - phone
        - prefixed_phone
        - email
        - facebook_id
        - visit_frequencies
        - hint
        - opening_hours
        - computed_opening_hours
        - special_day_schedules
        - opening_date
        - closing_date
        - services
        - logo
        - logo_minimal
        - logo_square
        - media
        - weblink
        - links
        - managers
        - mpv_vertriebstyp_id
        - x_kst
        - x_kst_gueltigab
        - admin_x_kst
      type: object
    ComputedOpeningHoursResponse:
      properties:
        date:
          type: string
        day_of_week:
          type: number
        message:
          type: string
        on_request1:
          type: boolean
        on_request2:
          type: boolean
        open:
          type: boolean
        special_schedule:
          type: boolean
        time_close1:
          nullable: true
          type: string
        time_close2:
          nullable: true
          type: string
        time_open1:
          nullable: true
          type: string
        time_open2:
          nullable: true
          type: string
      required:
        - date
        - time_open1
        - time_close1
        - time_open2
        - time_close2
        - message
        - special_schedule
        - day_of_week
        - open
      type: object
    OpeningHours:
      properties:
        day_of_week:
          type: number
        on_request1:
          nullable: true
          type: boolean
        on_request2:
          nullable: true
          type: boolean
        time_close1:
          nullable: true
          type: string
        time_close2:
          nullable: true
          type: string
        time_open1:
          nullable: true
          type: string
        time_open2:
          nullable: true
          type: string
      required:
        - day_of_week
        - time_open1
        - time_close1
        - time_open2
        - time_close2
      type: object
    Service:
      properties:
        bcnr:
          type: string
        boss_numbers:
          items:
            type: string
          nullable: true
          type: array
        code:
          type: string
        counter_type:
          type: string
        daily_type:
          type: string
        hint:
          type: string
        link:
          type: string
        link_text:
          type: string
        logo:
          properties:
            alt_text:
              properties:
                de:
                  nullable: true
                  type: string
                fr:
                  nullable: true
                  type: string
                it:
                  nullable: true
                  type: string
              type: object
            custom:
              nullable: true
              type: string
            large:
              nullable: true
              type: string
            medium:
              nullable: true
              type: string
            original:
              nullable: true
              type: string
            small:
              nullable: true
              type: string
            stack:
              nullable: true
              type: string
          required:
            - custom
            - large
            - medium
            - original
            - small
            - stack
          type: object
        market_type:
          type: string
        name:
          type: string
        offer_groups:
          items:
            anyOf:
              - type: string
              - properties:
                  id:
                    type: string
                  name:
                    type: string
                  offers:
                    items:
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                      required:
                        - id
                        - name
                      type: object
                    type: array
                required:
                  - id
                  - name
                  - offers
                type: object
          type: array
        packet_sizes:
          items:
            type: string
          type: array
        pcnr:
          type: string
        pickmup_type:
          type: string
        pickmup_type_name:
          type: string
        pickup_location_id:
          type: string
        postal_address1:
          type: string
        postal_address2:
          type: string
        postal_address3:
          type: string
        promoted:
          type: boolean
        promoted_group:
          type: string
        return_option:
          type: boolean
        size:
          type: number
        sub_type:
          type: string
        subito_types:
          items:
            type: string
          type: array
        supported_stores:
          items:
            type: string
          type: array
        swift:
          type: string
        text:
          type: string
        title:
          type: string
        type:
          type: string
      required:
        - type
        - sub_type
      type: object
    SpecialDaySchedule:
      properties:
        date_from:
          type: string
        date_to:
          type: string
        holiday:
          nullable: true
          type: string
        just_message:
          nullable: true
          type: boolean
        message:
          nullable: true
          type: string
        open:
          type: boolean
        time_close1:
          nullable: true
          type: string
        time_close2:
          nullable: true
          type: string
        time_open1:
          nullable: true
          type: string
        time_open2:
          nullable: true
          type: string
      required:
        - date_from
        - date_to
        - open
        - time_open1
        - time_close1
        - time_open2
        - time_close2
        - message
        - just_message
        - holiday
      type: object
  securitySchemes:
    apikey:
      in: header
      name: X-Api-Key
      type: apiKey
```