Look up style SKUs

When to use this. A SKU is one unique colour/size combination of a style: the level at which you assign barcodes, negotiate prices, and read resolved custom-field values. Use these endpoints to look up a style’s SKUs, or page across the SKUs of every style in the organisation. Creating and updating SKUs is not yet part of the public API. SKUs require the Barcodes module and are a designer-only surface.

The workflow

SKUs hang off a style that already has its colourways and size range set up, one SKU per colour/size combination you sell. You read them for one style, one at a time, or across the whole organisation. Each SKU comes back enriched with its nested colour and size, the style’s custom fields resolved to that coordinate, and the lowest applicable price rows.

List a style's SKUs

GET /api/styles/{styleId}/skus returns a paginated list of one style’s SKUs. Filter by state, colorId and sizeId; a state of deleted is treated as inactive, as a SKU has no stored deleted state.

Fetch a single SKU

GET /api/styles/{styleId}/skus/{skuId} returns one SKU, scoped to its style.

Page across the organisation

GET /api/skus pages through the SKUs of every style in the organisation.

Walkthrough

Read a single SKU on a style by its skuId.

curl "https://service.my.delogue.com/api/styles/4821/skus/90777" \
  -H "Accept: application/json" \
  -H "X-Auth-Token: Bearer YOUR_API_KEY"

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

{
  "status": "success",
  "code": "style_sku_retrieved",
  "data": {
    "id": 90777,
    "number": "SS26-1042-ECR-M",
    "state": "active",
    "barcode": null,
    "barcodeId": null,
    "styleId": 4821,
    "color": {
      "id": 5568,
      "name": "Ecru",
      "customId1": "ECR",
      "customId2": null,
      "state": "active"
    },
    "size": {
      "id": 8901,
      "name": "Medium",
      "sizeId": "M",
      "state": "active"
    },
    "customFields": [],
    "prices": [],
    "properties": []
  }
}

The response wraps the SKU in the standard envelope. A read returns the SKU enriched: color and size as nested objects, customFields resolved to that coordinate, prices at the lowest applicable variant level, and properties flags such as barcodeAssigned.

Field reference

The fields that matter most when reading a SKU:

Field	What it means at Delogue
`barcode` / `barcodeId`	The barcode assigned to the SKU and its identifier, or `null` for both when no barcode is assigned.
`color`	The colour side of the SKU’s colour/size coordinate, or `null` for a size-only variant. Filter on it with `colorId` (the colour-library colour id).
`customFields`	The style’s custom fields with this SKU’s per-colour and per-size values resolved in; the master value fills an empty cell. Empty when the custom-field modules are off.
`number`	The SKU number identifying this colour/size variant of the style.
`prices`	The style’s price rows resolved to the lowest applicable variant level for this SKU. Empty when the caller has no price access.
`properties`	Status flags present when they apply: `barcodeAssigned`, `exported`, `hasCustomFieldOverrides` and `hasPriceOverrides`.
`size`	The size side of the SKU’s colour/size coordinate, or `null` for a colour-only variant. Filter on it with `sizeId` (the size-range size id).
`state`	`active` or `inactive`. A SKU has no stored deleted state.

Roles & permissions

SKUs are a designer-only surface: supplier accounts receive 403. The caller’s organisation must have the Barcodes module enabled, and the user needs the barcodes permission at read level. Without the module the request is refused; without price access, prices comes back empty rather than failing.

When things go wrong

Errors use the standard envelope (status: "error", a code, and error.details[]). A style that does not exist returns 404; a style in another organisation returns 403; an unknown skuId under the style returns 404. See Errors & responses for the full list of codes and how to resolve them.

What to call next

Styles

The style, its colourways, and size range that SKUs hang off.

Size ranges

Manage the sizes a SKU’s nested size points at.

Colours

Manage the colour library a SKU’s nested color points at.

Style prices

The full price rows a SKU’s prices join back to: GET /api/styles/{styleId}/prices.

Getting Started

Concepts

Guides

The workflow

Walkthrough

Field reference

Roles & permissions

When things go wrong

What to call next

Styles

Size ranges

Colours

Style prices

​The workflow

​Walkthrough

​Field reference

​Roles & permissions

​When things go wrong

​What to call next

Styles

Size ranges

Colours

Style prices

The workflow

Walkthrough

Field reference

Roles & permissions

When things go wrong

What to call next