> ## 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.
# Read a style's care instructions
> Retrieve the assembled care-label content for a style — its subtabs, care symbols, composition layers, instructions, and colourways.
**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.
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`.
In the Delogue app, care instructions are arranged into subtabs on the style — each with its
icons, layers, instructions, and colour associations.
`GET /api/styles/{styleId}/care-instructions` returns every subtab for the style, fully
expanded.
Combine the care instructions with the rest of the style record — see
`GET /api/styles/{styleId}`.
```mermaid theme={"dark"}
sequenceDiagram
participant D as Designer
participant API as Delogue API
D->>API: GET /api/care-instructions (library)
API-->>D: instruction texts
D->>API: GET /api/styles/{styleId}/care-instructions
API-->>D: subtabs with icons, layers, materials, colours
```
## 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.
```bash cURL theme={"dark"}
curl "https://service.my.delogue.com/api/styles/{styleId}/care-instructions" \
-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/styles/{styleId}/care-instructions", {
method: "GET",
headers: {
"Accept": "application/json",
"X-Auth-Token": "Bearer YOUR_API_KEY",
},
});
const { data } = await res.json();
```
```json theme={"dark"}
{
"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](/concepts/errors) for the full list of codes and how to resolve them.
## What to call next
Build and maintain the reusable care-instruction library the subtabs draw on.
Read and manage the style these care instructions belong to.
The reference for `GET /api/styles/{styleId}/care-instructions`.
How to get and send your `X-Auth-Token` API key.