Skip to content
MalovexMalovexMalovex Docs

Prices Endpoint

The prices endpoint returns the computed selling prices for a single product — one entry per customer group, in the store’s currency. It’s a lightweight call for when you only need pricing, not the whole product.

All requests require a bearer token. See Authentication.

Retrieve a product’s prices

Section titled “Retrieve a product’s prices”
GET /v1/products/{id}/prices

Query parameters

Section titled “Query parameters”
Parameter Type Default Description
store string default store Slug of the store to price for. Omit to use your default store.

Example request

Section titled “Example request”
Terminal window
curl "https://api.malovex.com/v1/products/1/prices?store=eu-store" \
  -H "Authorization: Bearer mlx_xxx"

Example response

Section titled “Example response”
{
  "product_id": 1,
  "store": "eu-store",
  "prices": [
    {
      "customer_group_id": 1,
      "customer_group": "Retail",
      "base_cost": 42.00,
      "computed_price": 59.99,
      "currency": "EUR",
      "applied_rule_id": 7
    },
    {
      "customer_group_id": 2,
      "customer_group": "Wholesale",
      "base_cost": 42.00,
      "computed_price": 49.99,
      "currency": "EUR",
      "applied_rule_id": 8
    }
  ]
}

A request for a product that isn’t in your catalog returns 404.

The price object

Section titled “The price object”

Each entry in prices represents one customer group:

Field Type Description
customer_group_id integer The customer group’s ID.
customer_group string The customer group’s name.
base_cost number The supplier cost the price was built from (the price basis).
computed_price number The final selling price after your price rules.
currency string The store’s currency. Same for every entry.
applied_rule_id integer | null The ID of the price rule that produced this price, or null if none applied.