> ## Documentation Index
> Fetch the complete documentation index at: https://integration.delogue.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Look up style prices
> Read a style's negotiated prices — current and future values, calculation columns, supplier currency and terms — across the price matrix.
**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.
`GET /api/styles` to locate the style whose prices you want, and note its id.
`GET /api/styles/{styleId}/prices` for the full block — supplier currency and terms, the
approval status, and every price row for that style.
`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.
`GET /api/style-prices/{id}` to re-read a single row — the same shape the list returns for it.
```mermaid theme={"dark"}
sequenceDiagram
participant D as Designer
participant API as Delogue API
D->>API: GET /api/styles/{styleId}/prices
API-->>D: supplier info, price status, price rows
D->>API: GET /api/style-prices?style-id={styleId}&price-status=notApproved
API-->>D: page of matching price rows
D->>API: GET /api/style-prices/{id}
API-->>D: single price row
```
## 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.
```bash cURL theme={"dark"}
curl "https://service.my.delogue.com/api/style-prices" \
-H "Accept: application/json" \
-H "X-Auth-Token: Bearer YOUR_API_KEY"
```
```js JavaScript theme={"dark"}
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();
```
```json theme={"dark"}
{
"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](/concepts/errors) for the full list of codes and how to resolve them.
## What to call next
Find the style whose prices you want to read, and note its id.
Item prices feed item-price calculation columns on a style's price matrix.
The full block for one style: `GET /api/styles/{styleId}/prices`.
How to get and send your `X-Auth-Token` API key.