---
title: "Returns the cooperative purchase price of products."
url: "https://developer-qual.migros.ch/apis/products-related-8/versions/051741b6-0319-4b5e-b1f1-6bdbc778acb6/operations/get-purchase-prices"
---

> Full API specification: https://developer-qual.migros.ch/apis/products-related-8/versions/051741b6-0319-4b5e-b1f1-6bdbc778acb6.md

# Returns the cooperative purchase price of products.

`GET` `/migros/products/v8/products/purchase-price`

Operation ID: `get-purchase-prices`

Returns the cooperative purchase price of products.

## Query parameters

- `ids` (string, optional) - A comma separated list of product ids.
- `glns` (string, optional) - A comma separated list of Global-Location-Numbers (GLNs) from SAP (also referred as 'sndlad').
- `limit` (integer, optional) - Maximum number of results (max 2000).
- `offset` (integer, optional) - Result set offset.
- `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
- `400` - If the request parameters are invalid.
- `502` - Returned when the upstream server request failed

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Products Related
  version: "8"
servers:
  - description: Public Kong Gateway URL
    url: https://api-qual.migros.ch
paths:
  /migros/products/v8/products/purchase-price:
    get:
      description: Returns the cooperative purchase price of products.
      operationId: get-purchase-prices
      parameters:
        - description: A comma separated list of product ids.
          in: query
          name: ids
          schema:
            type: string
        - description: A comma separated list of Global-Location-Numbers (GLNs) from SAP
            (also referred as 'sndlad').
          in: query
          name: glns
          schema:
            type: string
        - $ref: "#/components/parameters/limit"
        - $ref: "#/components/parameters/offset"
        - $ref: "#/components/parameters/lang"
        - $ref: "#/components/parameters/Accept-Language"
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PurchasePriceCollection"
          description: Returned when successful
        "400":
          $ref: "#/components/responses/400"
        "502":
          description: Returned when the upstream server request failed
      summary: Returns the cooperative purchase price of products.
      tags:
        - Products Related
security:
  - Kong-Api-Key: []
    basicAuth: []
components:
  parameters:
    limit:
      description: Maximum number of results (max 2000).
      in: query
      name: limit
      required: false
      schema:
        default: 10
        maximum: 2000
        minimum: 0
        type: integer
    offset:
      description: Result set offset.
      in: query
      name: offset
      required: false
      schema:
        default: 0
        minimum: 0
        type: integer
    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:
    PurchasePriceCollection:
      allOf:
        - $ref: "#/components/schemas/AbstractCollection"
        - properties:
            items:
              items:
                $ref: "#/components/schemas/PurchasePrice"
              type: array
          type: object
      required:
        - items
      type: object
    AbstractCollection:
      description: A generic collection of elements.
    PurchasePrice:
      properties:
        cooperative:
          example: GMZH
          nullable: true
          type: string
        currency:
          example: CHF
          type: string
        gln:
          description: Global Location Number (GLN).
          example: "7624400080108"
          type: string
        gln_description:
          example: MIGROS-GEN.BUND
          type: string
        gln_mgb_partner_id:
          example: "2028019"
          type: string
        price:
          example: 3.23
          format: float
          type: number
        product_id:
          example: "106282900000"
          type: string
        supplier:
          example: "0092103183"
          nullable: true
          type: string
        unit:
          example: PCE
          type: string
        valid_from:
          example: 2020-03-01
          format: date
          type: string
        valid_to:
          example: 9999-12-31
          format: date
          type: string
      type: object
  responses:
    "400":
      description: If the request parameters are invalid.
  securitySchemes:
    Kong-Api-Key:
      description: Kong key-auth authentication
      in: header
      name: X-Api-Key
      type: apiKey
    basicAuth:
      scheme: basic
      type: http
```