Accessing Prices

In order to access Prices available to you, you can use any of the following endpoints:

Endpoint	Description
GET /skus/{sku_id}/prices (opens new window)	Returns a list of all prices for the given SKU
GET /prices/{price_id} (opens new window)	Returns the price with the provided price_id

❗️ Important Note
Prices retrieved using these endpoints are not static, because pricing can change based on many factors including region, date/time, quantity, and so on. Learn more on how to properly determine prices here: Determine Prices (opens new window)

Price attributes explained

Whenever you retrieve a Price within any of the procurement API responses, there are certain attributes that you need to understand to properly work with the response. These are:

Attribute	Description
minimum_order_quantity	The minimum amount of the associated SKU that needs to be ordered for this price to be valid.
maximum_order_quantity	The maximum amount of the associated SKU that can be ordered for this price to be valid. null by default
price	The actual price per SKU
valid_from valid_until	Defines the validity date-range in which this specific Price is valid for you. Once the valid_until date has been reached, you will now longer be able to retrieve this price. Both values can be null. If valid_from is null it means that this price is immediately valid. If valid_until is null it means that the price is indefinitely valid. Please note: Prices that are not valid for you will not be returned by the API. SKUs without valid prices incl. their variants and articles will also not be returned!

API Example

Example Request

GET /skus/0e1b07d5-6abc-4643-af1d-392129d40ef1/prices

Example Response

[
  {
    "id": "7d1b8b81-c3ef-4fe1-bd49-2292eb253437",
    "kind": "static",
    "minimum_order_quantity": 108000,
    "order_number": "gloss-0001",
    "price": "0.01908",
    "valid_from": "2020-11-18T14:55:06.467Z",
    "valid_until": null,
    "sales_group_id": "ca4bcc38-2886-4ad9-b157-9b02e00ab521",
    "sales_group": {
      "id": "ca4bcc38-2886-4ad9-b157-9b02e00ab521",
      "name": "Bounty Soap Default Sales Group",
      "links": [
        {
          "rel": "self",
          "href": "/consumers/api/v1/sales_groups/ca4bcc38-2886-4ad9-b157-9b02e00ab521"
        }
      ]
    },
    "created_at": "2020-11-18T14:55:09.400Z",
    "updated_at": "2020-11-18T14:55:09.400Z"
  },
  {
    "id": "c1340152-997d-47ae-a3fb-7fd8a716f5c2",
    "kind": "static",
    "minimum_order_quantity": 108000,
    "order_number": "gloss-002",
    "price": "0.01908",
    "valid_from": "2020-11-18T15:01:50.319Z",
    "valid_until": null,
    "sales_group_id": "ca4bcc38-2886-4ad9-b157-9b02e00ab521",
    "sales_group": {
      "id": "ca4bcc38-2886-4ad9-b157-9b02e00ab521",
      "name": "Bounty Soap Default Sales Group",
      "links": [
        {
          "rel": "self",
          "href": "/consumers/api/v1/sales_groups/ca4bcc38-2886-4ad9-b157-9b02e00ab521"
        }
      ]
    },
    "created_at": "2020-11-18T15:01:53.158Z",
    "updated_at": "2020-11-18T15:01:53.158Z"
  }
]