Look up style prices

When to use this. Style prices are the negotiated values on a style’s price matrix: one row per style, colour, size, or colour-and-size, each carrying its calculation columns with a current value and an optional future price. This surface is read-only — use it to look prices up, whether for a single style or filtered across the collection.

The workflow

A style’s prices are already maintained inside Delogue (in the price matrix). Through the API you read them in one of three ways: the full block for one style, a single row by its id, or a filtered page across styles.

Find the style

GET /api/styles to locate the style whose prices you want, and note its id.

Read the price block

GET /api/styles/{styleId}/prices for the full block — supplier currency and terms, the approval status, and every price row for that style.

Scan across styles

GET /api/style-prices with filters (style, colour, season, supplier, approval status, future-date range) to page through price rows without fixing on one style.

Drill into a row

GET /api/style-prices/{id} to re-read a single row — the same shape the list returns for it.

Walkthrough

Read the price block for a style, then filter the collection and drill into one row. Every response uses the standard envelope; formula and item-price columns are computed at read time, so the values you read are already resolved.

curl "https://service.my.delogue.com/api/style-prices" \
  -H "Accept: application/json" \
  -H "X-Auth-Token: Bearer YOUR_API_KEY"

const res = await fetch("https://service.my.delogue.com/api/style-prices", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-Auth-Token": "Bearer YOUR_API_KEY",
  },
});
const { data } = await res.json();

{
  "status": "success",
  "code": "style_prices_retrieved",
  "data": [
    {
      "id": 48213,
      "styleId": 90417,
      "colorId": null,
      "colorName": null,
      "colorStatus": "inactive",
      "sizeRangeSizeId": null,
      "sizeRangeSizeName": null,
      "sizeRangeSizeStatus": "inactive",
      "variantType": "none",
      "brandComments": "FOB target for SS26",
      "supplierComments": null,
      "futureDate": null,
      "futurePriceBrandComments": null,
      "futurePriceSupplierComments": null,
      "priceNegotiations": [
        {
          "value": 12.5,
          "futurePrice": null,
          "priceCalculation": {
            "id": 771,
            "ref": "A",
            "name": "FOB",
            "type": "currency",
            "currency": {
              "id": 33,
              "code": "EUR",
              "name": "Euro"
            },
            "formula": null,
            "position": 1,
            "properties": [
              "supplierVisible",
              "supplierEditable"
            ]
          }
        },
        {
          "value": 15.63,
          "futurePrice": null,
          "priceCalculation": {
            "id": 772,
            "ref": "B",
            "name": "Landed",
            "type": "formula",
            "currency": {
              "id": 33,
              "code": "EUR",
              "name": "Euro"
            },
            "formula": "A*1.25",
            "position": 2,
            "properties": [
              "bold"
            ]
          }
        }
      ],
      "properties": []
    },
    {
      "id": 48260,
      "styleId": 90417,
      "colorId": 5521,
      "colorName": "Deep Navy",
      "colorStatus": "active",
      "sizeRangeSizeId": null,
      "sizeRangeSizeName": null,
      "sizeRangeSizeStatus": "inactive",
      "variantType": "color",
      "brandComments": null,
      "supplierComments": null,
      "futureDate": "2026-09-01T00:00:00",
      "futurePriceBrandComments": "Renegotiated for AW26",
      "futurePriceSupplierComments": null,
      "priceNegotiations": [
        {
          "value": 13.1,
          "futurePrice": 12.8,
          "priceCalculation": {
            "id": 771,
            "ref": "A",
            "name": "FOB",
            "type": "currency",
            "currency": {
              "id": 33,
              "code": "EUR",
              "name": "Euro"
            },
            "formula": null,
            "position": 1,
            "properties": [
              "supplierVisible",
              "supplierEditable"
            ]
          }
        }
      ],
      "properties": []
    }
  ],
  "pagination": {
    "hasMore": true,
    "cursor": "eyJTaWduYXR1cmUiOiJhYmMxMjMifQ=="
  }
}

Each price row carries a priceNegotiations array — one entry per calculation column — with the current value, the futurePrice (effective from the row’s futureDate), and the column definition. Hold onto each row’s id to re-read it via GET /api/style-prices/{id}.

Field reference

The fields that matter most when reading a style price row:

Field	What it means at Delogue
`brandComments`	Free-text comment on the current price entered by the brand.
`colorId`	StyleColorMaster id of the colourway this price row applies to, or null for a style-level (non-colour) row. Shares the id-space of styleColors[].id and SKU color.id.
`colorName`	Name of the colourway this price row applies to, or null for a style-level row.
`colorStatus`	Whether the referenced colourway is active or inactive.
`futureDate`	Date from which the future price takes effect, or null when no future price is set.
`futurePriceBrandComments`	Free-text comment on the future price entered by the brand.
`futurePriceSupplierComments`	Free-text comment on the future price entered by the supplier.
`id`	Unique identifier of the style price row.
`priceNegotiations`	The price-calculation columns for this row, each with its current negotiated value and future price.
`properties`	Reserved for future extensibility; currently always empty.
`sizeRangeSizeId`	Identifier of the size this price row applies to, or null for a non-size row.
`sizeRangeSizeName`	Name of the size this price row applies to, or null for a non-size row.
`sizeRangeSizeStatus`	Whether the referenced size is active or inactive.
`styleId`	Identifier of the style this price row belongs to.
`supplierComments`	Free-text comment on the current price entered by the supplier.
`variantType`	Granularity of this price row: none (per style), color (per colour), size (per size), or sizeColor (per colour and size).

Roles & permissions

Reading style prices requires the prices permission on a designer (brand) account — typically CompanyAdmin or CompanyUser. A style whose id belongs to another organisation returns 403; a style or price id that exists nowhere returns 404.

When things go wrong

Errors use the standard envelope (status: "error", a code, and error.details[]). See Errors & responses for the full list of codes and how to resolve them.

What to call next

Styles

Find the style whose prices you want to read, and note its id.

Items

Item prices feed item-price calculation columns on a style’s price matrix.

Price block for a style

The full block for one style: GET /api/styles/{styleId}/prices.

Authentication

How to get and send your X-Auth-Token API key.

Getting Started

Concepts

Guides

The workflow

Walkthrough

Field reference

Roles & permissions

When things go wrong

What to call next

Styles

Items

Price block for a style

Authentication

​The workflow

​Walkthrough

​Field reference

​Roles & permissions

​When things go wrong

​What to call next

Styles

Items

Price block for a style

Authentication

The workflow

Walkthrough

Field reference

Roles & permissions

When things go wrong

What to call next