List Plans
Returns all available subscription plans with their types and pricing.GET /external-partner/plans
| Header | Value |
|---|---|
API-KEY | Your partner API key |
Accept-Language | ar or en |
{
"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 |