> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wilow.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Laundry Preferences

> Get and set per-service laundry preferences for a customer

Laundry preferences are set **per service type** (`clothes`, `shoes`, `ironing`). They tell Wilow how the customer wants their laundry handled.

***

## Store Preferences

```http theme={null}
POST /external-partner/customers/laundry-preferences
```

**Headers**

| Header            | Value                     |
| ----------------- | ------------------------- |
| `Authorization`   | `Bearer {customer_token}` |
| `Idempotency-Key` | Unique UUID               |

**Body** `multipart/form-data`

| Field               | Type    | Required | Notes                                     |
| ------------------- | ------- | -------- | ----------------------------------------- |
| `service_type`      | string  | ✅        | `clothes`, `shoes`, or `ironing`          |
| `organic_detergent` | boolean | ❌        | Use organic detergent                     |
| `scent`             | boolean | ❌        | Add scent                                 |
| `mirzam`            | boolean | ❌        | Add mirzam (traditional Saudi scent)      |
| `starch`            | boolean | ❌        | Apply starch (clothes only)               |
| `starch_level`      | string  | ❌        | `light`, `medium`, or `heavy`             |
| `protection_layer`  | boolean | ❌        | Add protection layer (required for shoes) |

**Response**

```json theme={null}
{
  "success": true,
  "data": {
    "id": 2275,
    "organic_detergent": true,
    "scent": true,
    "mirzam": false,
    "starch": true,
    "starch_level": { "code": "light", "name": "Light" },
    "protection_layer": false,
    "service": {
      "name": "clothes",
      "type": { "code": "clothes", "name": "Clothes" }
    }
  },
  "status_code": 200
}
```

***

## Get Preferences

```http theme={null}
GET /external-partner/customers/laundry-preferences?service_type=clothes
```

**Headers**

| Header          | Value                     |
| --------------- | ------------------------- |
| `API-KEY`       | Your partner API key      |
| `Authorization` | `Bearer {customer_token}` |

**Query Parameters**

| Param          | Required | Notes                            |
| -------------- | -------- | -------------------------------- |
| `service_type` | ✅        | `clothes`, `shoes`, or `ironing` |
| `plan_id`      | ❌        | Filter by specific plan          |

**Response** — same shape as store response above.