---
url: "https://developer.migros.ch/apis/stores-api-1/versions/ac41d15e-28a9-459f-b6e0-277ae334d939"
---

OpenAPI specification document.

```json
{"components":{"parameters":{},"schemas":{"Aggregation":{"properties":{"buckets":{"items":{"properties":{"count":{"type":"number"},"name":{"type":"string"},"term":{"type":"string"}},"required":["term","count","name"],"type":"object"},"type":"array"},"name":{"type":"string"},"other_count":{"type":"number"}},"required":["name","other_count","buckets"],"type":"object"},"AggregationWithKeys":{"properties":{"buckets":{"items":{"properties":{"count":{"type":"number"},"name":{"type":"string"},"term":{"properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"type":"object"}},"required":["term","count","name"],"type":"object"},"type":"array"},"name":{"type":"string"},"other_count":{"type":"number"}},"required":["name","other_count","buckets"],"type":"object"},"Aggregations":{"properties":{"assortments":{"$ref":"#/components/schemas/Aggregation"},"cooperatives":{"$ref":"#/components/schemas/Aggregation"},"counter_type":{"$ref":"#/components/schemas/Aggregation"},"daily_type":{"$ref":"#/components/schemas/Aggregation"},"markets":{"$ref":"#/components/schemas/Aggregation"},"offer_groups":{"$ref":"#/components/schemas/Aggregation"},"offers":{"$ref":"#/components/schemas/Aggregation"},"open_on":{"$ref":"#/components/schemas/AggregationWithKeys"},"packet_sizes":{"$ref":"#/components/schemas/Aggregation"},"pickmup_type":{"$ref":"#/components/schemas/Aggregation"},"promoted":{"$ref":"#/components/schemas/Aggregation"},"return_option":{"$ref":"#/components/schemas/Aggregation"},"services":{"$ref":"#/components/schemas/Aggregation"},"size":{"$ref":"#/components/schemas/Aggregation"},"stores":{"$ref":"#/components/schemas/Aggregation"},"sub_type":{"$ref":"#/components/schemas/Aggregation"},"supported_stores":{"$ref":"#/components/schemas/Aggregation"},"type":{"$ref":"#/components/schemas/Aggregation"}},"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"},"InvertedMarket":{"allOf":[{"$ref":"#/components/schemas/Market"},{"properties":{"store":{"$ref":"#/components/schemas/InvertedStore"}},"required":["store"],"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"},"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"},"Store":{"allOf":[{"$ref":"#/components/schemas/InvertedStore"},{"properties":{"markets":{"items":{"$ref":"#/components/schemas/Market"},"type":"array"}},"required":["markets"],"type":"object"}]},"aggregation_groups":{"type":"string"},"aggregation_options":{"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"},"limit":{"example":1,"maximum":10000,"minimum":0,"nullable":true,"type":"number"},"location_distance":{"nullable":true,"type":"number"},"location_distance_unit":{"enum":["cm","m","km"],"type":"string"},"location_reference":{"type":"string"},"marketFilters":{"anyOf":[{"additionalProperties":false,"properties":{"assortments":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"cooperatives":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"market_sub_types":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"markets":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"open_on":{"anyOf":[{"pattern":"^\\d{8}$|^\\d{2}:\\d{2}$|^\\d{8}T\\d{2}:\\d{2}$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day\\d{2}:\\d{2}$|^anytime(\\d{8})?$|^always$","type":"string"},{"items":{"anyOf":[{"pattern":"^\\d{8}$|^\\d{2}:\\d{2}$|^\\d{8}T\\d{2}:\\d{2}$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day\\d{2}:\\d{2}$|^anytime(\\d{8})?$|^always$","type":"string"},{"items":{"pattern":"^\\d{8}$|^\\d{2}:\\d{2}$|^\\d{8}T\\d{2}:\\d{2}$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day\\d{2}:\\d{2}$|^anytime(\\d{8})?$|^always$","type":"string"},"type":"array"}]},"type":"array"}]},"services":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"},{"additionalProperties":false,"properties":{"boss_numbers":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"code":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"counter_type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"daily_type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"market_type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"name":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"offer_groups":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"offers":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"packet_sizes":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"pickmup_type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"pickmup_type_name":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"pickup_location_id":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"promoted":{"type":"boolean"},"promoted_group":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"return_option":{"type":"boolean"},"size":{"type":"number"},"sub_type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"supported_stores":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]}},"type":"object"}]},"stores":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]}},"type":"object"},{"items":{"additionalProperties":false,"properties":{"assortments":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"cooperatives":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"market_sub_types":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"markets":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"open_on":{"anyOf":[{"pattern":"^\\d{8}$|^\\d{2}:\\d{2}$|^\\d{8}T\\d{2}:\\d{2}$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day\\d{2}:\\d{2}$|^anytime(\\d{8})?$|^always$","type":"string"},{"items":{"anyOf":[{"pattern":"^\\d{8}$|^\\d{2}:\\d{2}$|^\\d{8}T\\d{2}:\\d{2}$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day\\d{2}:\\d{2}$|^anytime(\\d{8})?$|^always$","type":"string"},{"items":{"pattern":"^\\d{8}$|^\\d{2}:\\d{2}$|^\\d{8}T\\d{2}:\\d{2}$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day$|^((mon)|(tues)|(wednes)|(thurs)|(fri)|(satur)|(sun))day\\d{2}:\\d{2}$|^anytime(\\d{8})?$|^always$","type":"string"},"type":"array"}]},"type":"array"}]},"services":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"},{"additionalProperties":false,"properties":{"boss_numbers":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"code":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"counter_type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"daily_type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"market_type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"name":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"offer_groups":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"offers":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"packet_sizes":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"pickmup_type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"pickmup_type_name":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"pickup_location_id":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"promoted":{"type":"boolean"},"promoted_group":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"return_option":{"type":"boolean"},"size":{"type":"number"},"sub_type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"supported_stores":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]},"type":{"anyOf":[{"type":"string"},{"items":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"array"}]}},"type":"object"}]},"stores":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]}},"type":"object"},"type":"array"}],"example":{"markets":["super","obi"]}},"marketIds":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"default":[],"description":"Array of market IDs or slugs","example":["0090320_super","migros-supermarkt-abtwil-saentispark"]},"marketTypes":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"default":[],"deprecated":true},"offset":{"example":0,"maximum":10000,"minimum":0,"nullable":true,"type":"number"},"sapIds":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"default":[],"example":""},"storeFilters":{"type":"string"},"storeIds":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"default":[]},"storeTypes":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"default":[],"deprecated":true},"storesSort":{"default":"name","description":"Sort the results by the given field.","enum":["name","search","nearby"],"example":"name","type":"string"},"verbosity":{"enum":["id","store","detail"],"type":"string"}},"securitySchemes":{"apikey":{"in":"header","name":"X-Api-Key","type":"apiKey"}}},"info":{"contact":{"email":"shared-components@mgb.ch","name":"MGB-UDP-MSRC+","url":"https://teams.microsoft.com/l/channel/19%3a0d8630131e174b7090ab8f90c963b379%40thread.tacv2/General?groupId=3551bc89-74ed-4113-98ec-18bc16047b9f&tenantId=35aa8c5b-ac0a-4b15-9788-ff6dfa22901f"},"description":"This API is used to query the Stores REST API.\n- [Documentation and System Architecture Wiki](https://wiki.migros.net/pages/viewpage.action?pageId=215946771)","title":"Stores API","version":"1.0"},"openapi":"3.0.1","paths":{"/migros/sales/branches/v1/markets":{"get":{"description":"Retrieve a list of markets with given verbosity.","parameters":[{"in":"query","name":"ids","required":false,"schema":{"$ref":"#/components/schemas/marketIds"}},{"in":"query","name":"sap_ids","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/sapIds"},{"description":"Array of SAP IDs","example":["4213","5413"]}]}},{"in":"query","name":"search","required":false,"schema":{"type":"string"}},{"in":"query","name":"sort","required":false,"schema":{"default":"name","type":"string"}},{"in":"query","name":"order","required":false,"schema":{"enum":["asc","desc"],"type":"string"}},{"in":"query","name":"verbosity","required":false,"schema":{"enum":["id","detail"],"type":"string"}},{"description":"Aggregation options to apply for the given aggregations.","in":"query","name":"aggregation_options","required":false,"schema":{"$ref":"#/components/schemas/aggregation_options"},"style":"deepObject"},{"in":"query","name":"limit","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/limit"},{"description":"Limit the number of results.","example":10}]}},{"in":"query","name":"offset","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/offset"},{"description":"Offset the number of results"}]}},{"in":"query","name":"location_reference","required":false,"schema":{"type":"string"}},{"in":"query","name":"location_distance","required":false,"schema":{"nullable":true,"type":"number"}},{"in":"query","name":"location_distance_unit","required":false,"schema":{"enum":["cm","m","km"],"type":"string"}},{"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":"Filters to apply to the markets","in":"query","name":"filters","required":false,"schema":{"$ref":"#/components/schemas/marketFilters"},"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":{"properties":{"markets":{"items":{"$ref":"#/components/schemas/Market"},"type":"array"},"total_hits":{"type":"number"}},"required":["markets","total_hits"],"type":"object"}}},"description":"List of markets."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"properties":{"message":{"type":"string"}},"required":["message"],"type":"object"}},"required":["error"],"type":"object"}}},"description":"Bad Request"}},"security":[{"apikey":[]}],"summary":"Retrieve a list of markets with given verbosity.","tags":["cgd"]}},"/migros/sales/branches/v1/markets/{id}":{"get":{"description":"Retrieve a market by id.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"verbosity","required":false,"schema":{"enum":["id","detail"],"type":"string"}},{"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/InvertedMarket"}}},"description":"A single market."},"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 market by id.","tags":["cgd"]}},"/migros/sales/branches/v1/stores":{"get":{"description":"Retrieve a list of stores with given verbosity.","parameters":[{"description":"Determines which stores should be returned by id or slug. Cannot be used together with store_types. !ATTENTION! If you set limit and/or offset the result is sorted and ordered by given parameters sort and order or their default values. For example: `ids=aarau-igelweid` or `ids[]=aarau-igelweid&ids[]=0150079`","in":"query","name":"ids","required":false,"schema":{"$ref":"#/components/schemas/storeIds"}},{"description":"Determines which stores should be returned by sap_id. !ATTENTION! If you set limit and/or offset the result is sorted and ordered by given parameters sort and order or their default values. For example: `sap_ids=4213` or `sap_ids[]=4213&sap_ids[]=5413`","in":"query","name":"sap_ids","required":false,"schema":{"$ref":"#/components/schemas/sapIds"}},{"description":"Determines which store types should be returned. Cannot be used together with ids. DEPRECATED, use filters instead.","in":"query","name":"store_types","required":false,"schema":{"$ref":"#/components/schemas/storeTypes"}},{"description":"Determines which market types should be returned. DEPRECATED, use filters instead.","in":"query","name":"market_types","required":false,"schema":{"$ref":"#/components/schemas/marketTypes"}},{"in":"query","name":"search","required":false,"schema":{"type":"string"}},{"in":"query","name":"sort","required":false,"schema":{"$ref":"#/components/schemas/storesSort"}},{"in":"query","name":"order","required":false,"schema":{"enum":["asc","desc"],"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":"Limit the number of results.","in":"query","name":"limit","required":false,"schema":{"$ref":"#/components/schemas/limit"}},{"description":"Offset the number of results.","in":"query","name":"offset","required":false,"schema":{"$ref":"#/components/schemas/offset"}},{"description":"Selected filter terms.\n\nAll filters with type AndOrFilter (see the parameter model) can be used in 3 different ways:\n\n1. Just a string. For example, filters[markets]=super returns all stores with one or\nmore markets of type super\n2. An array of strings. The elements are connected by AND. For example:\n`filters[markets][]=super&filters[markets][]=alna` returns all stores with markets of type super and type alna\n3. An array containing strings and/or sub-arrays of strings - the elements are connected\nby AND, and the sub-elements by OR. For example, `filters[markets][0][]=super&filters[markets][0][]=alna&\nfilters[market][1]=spx` returns all stores with either a market of type super or alna, and a market of type spx\n\nThe services filter can be used in 4 different ways:\n1. Just a string. The string is then interpreted as service type. For example `filters[services]=pickmup`\nreturns all stores with a market with service pickmup\n2. An array of strings. Same behavior as AndOrFilters.\n3. An array containing strings and/or sub-arrays of strings. Same behavior as AndOrFilters for service types.\nFor example `filters[services][0][]=spx&filters[services][0][]=bikeworld&filters[services][1]=pickmup`\nreturns all stores with a market with a service with type pickmup and a service with type bikeworld or spx.\n4. An object with various keys (see the parameter model) and logic. For example\n`filters[services][type]=pickmup` is equivalent to `filters[services]=pickmup` but allows, additionally to\nadd other service filters, e.g. `filters[services][type]=pickmup&filters[services][promoted]=true`. Each of\nthese service filters is an AndOrFilter, meaning you can use an array with arrays to combine AND and OR\nfilters, e.g. `filters[services][type][0]=pickmup&filters[services][type][1][]=bank&\nfilters[services][type][1][]=subito` means store has a market that has a service of type pickmup and a service of type bank or subito.","in":"query","name":"filters","required":false,"schema":{"$ref":"#/components/schemas/storeFilters"},"style":"deepObject"},{"description":"Deprecated parameter to apply filters to the stores. Use filters instead.","in":"query","name":"aggregations","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/storeFilters"},{"deprecated":true}]},"style":"deepObject"},{"description":"Aggregation groups to get aggregations for with size (empty string or 0 = all).(e.g. `aggregation_groups[assortments][_size]=0`)","in":"query","name":"aggregation_groups","required":false,"schema":{"$ref":"#/components/schemas/aggregation_groups"},"style":"deepObject"},{"description":"Aggregation options to apply for the given aggregations.","in":"query","name":"aggregation_options","required":false,"schema":{"$ref":"#/components/schemas/aggregation_options"},"style":"deepObject"},{"description":"Geo reference location as string \"latitude,longitude\".","in":"query","name":"location_reference","required":false,"schema":{"$ref":"#/components/schemas/location_reference"}},{"description":"Distance in kilometers, meters or centimeters from the location reference.","in":"query","name":"location_distance","required":false,"schema":{"$ref":"#/components/schemas/location_distance"}},{"description":"Unit of the distance from the location reference (defaults to \"m\" if location_distance is set).","in":"query","name":"location_distance_unit","required":false,"schema":{"$ref":"#/components/schemas/location_distance_unit"}},{"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":{"properties":{"aggregations":{"$ref":"#/components/schemas/Aggregations"},"stores":{"items":{"$ref":"#/components/schemas/Store"},"type":"array"},"total_hits":{"type":"number"}},"required":["stores","total_hits","aggregations"],"type":"object"}}},"description":"List of stores."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"properties":{"message":{"type":"string"}},"required":["message"],"type":"object"}},"required":["error"],"type":"object"}}},"description":"Bad Request"}},"security":[{"apikey":[]}],"summary":"Retrieve a list of stores with given verbosity.","tags":["cgd"]}},"/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"]}}},"servers":[{"url":"https://stores-api.intern.migros.net"}],"tags":[{"description":"MSRC+ API","name":"msrc"}],"x-company":"migros","x-edm-domain":"sales","x-headmatter":{"readable_by":"*"},"x-leanix-id":"6ae4b52f-febf-4425-a1ba-47c5b7302420"}
```