Read a style's care instructions

When to use this. A style’s care instructions are the assembled care-label content: one or more subtabs, each carrying the wash/dry/iron care symbols, the garment’s composition layers and their materials, free-text instructions, and the style colours the subtab applies to. Use this endpoint to read that content back — for a PDF export, an ERP sync, or to show the care label alongside the rest of a style. This surface is read-only; the content is authored in the Delogue app and from the care-instruction library.

The workflow

Care instructions build on the brand’s care-instruction library (layers, materials, and the instruction texts themselves) and are then arranged into subtabs on a specific style. This endpoint returns the finished, style-level result.

Build the library

Maintain the reusable care-instruction building blocks — instruction texts, composition layers, and materials — see GET /api/care-instructions, GET /api/care-instruction-layers, and GET /api/care-instruction-materials.

Arrange them on the style

In the Delogue app, care instructions are arranged into subtabs on the style — each with its icons, layers, instructions, and colour associations.

Read the assembled set

GET /api/styles/{styleId}/care-instructions returns every subtab for the style, fully expanded.

Use it on the style

Combine the care instructions with the rest of the style record — see GET /api/styles/{styleId}.

Walkthrough

Read the care instructions for a style. The response is a single object with the style’s subtabs, each fully expanded with its icons, composition layers (and their materials), instructions, and colour associations.

curl "https://service.my.delogue.com/api/styles/{styleId}/care-instructions" \
  -H "Accept: application/json" \
  -H "X-Auth-Token: Bearer YOUR_API_KEY"

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

{
  "status": "success",
  "code": "ok",
  "data": {
    "properties": [],
    "subtabs": [
      {
        "id": 4501,
        "name": "Main label",
        "state": "active",
        "properties": [],
        "adminSubtab": {
          "id": 88,
          "name": "Care label",
          "customId": "CL-01",
          "state": "active"
        },
        "exception": null,
        "colorAssociations": [
          {
            "id": 9012,
            "styleColor": {
              "id": 7734,
              "customId1": "460",
              "customId2": null,
              "name": "Army",
              "status": "active",
              "adminColorId": 87
            }
          }
        ],
        "icons": [
          {
            "id": 331,
            "customId": "WASH-30",
            "text": "Machine wash 30°C",
            "region": "europe",
            "iconType": "wash_instruction",
            "state": "active",
            "iconResourceUrl": "https://service.my.delogue.com/care-icons/wash-30.svg"
          }
        ],
        "layers": [
          {
            "associationId": 5540,
            "layer": {
              "id": 120,
              "customId": "SHELL",
              "text": "Shell",
              "state": "active"
            },
            "unit": {
              "id": 3,
              "name": "gram",
              "customId": "g"
            },
            "unitValue": 240.0,
            "properties": [],
            "materials": [
              {
                "material": {
                  "id": 61,
                  "customId": "COT",
                  "text": "Cotton",
                  "state": "active"
                },
                "percentage": 80.0
              },
              {
                "material": {
                  "id": 62,
                  "customId": "PES",
                  "text": "Polyester",
                  "state": "active"
                },
                "percentage": 20.0
              }
            ]
          }
        ],
        "instructions": [
          {
            "id": 812,
            "customId": "INS-01",
            "text": "Wash inside out",
            "state": "active"
          }
        ]
      }
    ]
  }
}

Each subtab’s state reflects whether it is active, and every nested layer carries its materials with their composition percentages — useful for rendering a full care label or a fibre-content breakdown.

Field reference

The fields that matter most when reading a style’s care instructions:

Field	What it means at Delogue
`properties`	Property flags for the care-instructions set, reserved for extensibility; currently typically empty.
`subtabs`	The care-instruction subtabs configured on the style. Each subtab groups a coordinated set of icons, layers, instructions, and colour associations.

Roles & permissions

Reading care instructions requires read access on the care_instructions permission and the Care Instructions module. On a designer (brand) account this means the CareInstructions role (or a company admin / flexible role with care-instruction access). Supplier accounts can read a style’s care instructions when a brand they collaborate with has the module enabled.

When things go wrong

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

What to call next

Care instructions

Build and maintain the reusable care-instruction library the subtabs draw on.

Styles

Read and manage the style these care instructions belong to.

Care instructions endpoint

The reference for GET /api/styles/{styleId}/care-instructions.

Authentication

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

Getting Started

Concepts

Guides

Read a style's care instructions

The workflow

Walkthrough

Field reference

Roles & permissions

When things go wrong

What to call next

Care instructions

Styles

Care instructions endpoint

Authentication

​The workflow

​Walkthrough

​Field reference

​Roles & permissions

​When things go wrong

​What to call next

Care instructions

Styles

Care instructions endpoint

Authentication

The workflow

Walkthrough

Field reference

Roles & permissions

When things go wrong

What to call next