> ## 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.

# Plans

> Fetch available Wilow subscription plans

## List Plans

Returns all available subscription plans with their types and pricing.

```http theme={null}
GET /external-partner/plans
```

**Headers**

| Header            | Value                |
| ----------------- | -------------------- |
| `API-KEY`         | Your partner API key |
| `Accept-Language` | `ar` or `en`         |

**Response**

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": 37,
      "name": "Max",
      "description": "Best for large families",
      "bag_size": 10,
      "bags_count": 2,
      "service": {
        "name": "clothes",
        "type": { "code": "clothes", "name": "Clothes" }
      },
      "plan_types": [
        {
          "id": 42,
          "name": "1 wash",
          "orders_count": 1,
          "price": 209,
          "price_per_pag": 104.5,
          "discount_percentage": 35
        },
        {
          "id": 43,
          "name": "4 washes",
          "orders_count": 4,
          "price": 799,
          "price_per_pag": 99.88,
          "discount_percentage": 37
        }
      ],
      "color": "#F4C26A"
    }
  ],
  "status_code": 200
}
```

## Plan Structure

| Field                       | Description                                         |
| --------------------------- | --------------------------------------------------- |
| `id`                        | Plan ID — used in subscribe                         |
| `bag_size`                  | Max kg per bag                                      |
| `bags_count`                | Number of bags included                             |
| `plan_types`                | Purchase options (e.g. 1 wash, 4 washes)            |
| `plan_types[].id`           | Plan type ID — used in subscribe                    |
| `plan_types[].orders_count` | Number of pickups included — pass to Available Days |
| `plan_types[].price`        | Total price in SAR                                  |
| `color`                     | Hex color for the plan card UI                      |