---
title: "Returns the associated city and Migros cooperative for a single ZIP code in the specified country."
url: "https://developer-qual.migros.ch/apis/cooperatives-8/versions/f857e568-6a4c-420a-9cd1-c4f6093497f5/operations/get-cooperatives-by-country-and-zip"
---

> Full API specification: https://developer-qual.migros.ch/apis/cooperatives-8/versions/f857e568-6a4c-420a-9cd1-c4f6093497f5.md

# Returns the associated city and Migros cooperative for a single ZIP code in the specified country.

`GET` `/migros/products/v8/cooperatives/{country}/{zip}`

Operation ID: `get-cooperatives-by-country-and-zip`

Returns the associated city and Migros cooperative for a single ZIP code in the specified country.

## Path parameters

- `country` (string, required) - Country code, for example CH, DE etc (note that places in 'Fürstentum Liechtenstein' are found under CH, not FL)
- `zip` (string, required)

## 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
- `404` - Returned when the requested resource could not be not found.

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Cooperatives
  version: "8"
servers:
  - description: Public Kong Gateway URL
    url: https://api-qual.migros.ch
paths:
  /migros/products/v8/cooperatives/{country}/{zip}:
    get:
      description: Returns the associated city and Migros cooperative for a single ZIP
        code in the specified country.
      operationId: get-cooperatives-by-country-and-zip
      parameters:
        - description: Country code, for example CH, DE etc (note that places in
            'Fürstentum Liechtenstein' are found under CH, not FL)
          in: path
          name: country
          required: true
          schema:
            type: string
        - in: path
          name: zip
          required: true
          schema:
            type: string
        - $ref: "#/components/parameters/lang"
        - $ref: "#/components/parameters/Accept-Language"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Zip"
          description: Returned when successful
        "404":
          $ref: "#/components/responses/404"
      summary: Returns the associated city and Migros cooperative for a single ZIP
        code in the specified country.
      tags:
        - Cooperatives
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:
    Zip:
      description: Zip info, with city and cooperative mapping.
      properties:
        adr_regions:
          items:
            $ref: "#/components/schemas/ZipAdrRegion"
          nullable: true
          type: array
        city:
          type: string
        city_names:
          description: Names of this city in all languages.
          items:
            type: string
          nullable: true
          type: array
        cooperative:
          description: Shortname of cooperative.
          type: string
        cooperative_email:
          nullable: true
          type: string
        cooperative_homepage:
          nullable: true
          type: string
        country:
          description: The country code of this Zip (e.g. CH, FL, DE, FR, IT, AT)
          type: string
        state:
          description: State/canton name (*not* the country).
          type: string
        zip:
          type: string
      required:
        - zip
        - city
        - cooperative
      type: object
    ZipAdrRegion:
      description: '"Aus der Region, für die Region" info for zip.'
      properties:
        language:
          enum:
            - de
            - fr
            - it
          type: string
        name:
          description: Language of the region.
          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
```