List Bundles
Retrieve a paginated list of product bundles.
Endpointโ
GET /v1/bundles
Authenticationโ
Requires a live or test API key with products:read scope.
Query Parametersโ
| Parameter | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Page number |
per_page | integer | 15 | Items per page (max 100) |
search | string | - | Search by bundle name |
pricing_type | string | - | Filter by flat or calculated |
is_bookable | boolean | - | Filter by bookable status |
Example Requestโ
curl -X GET "https://app.equipdash.com/api/v1/bundles?per_page=10&is_bookable=true" \
-H "Authorization: Bearer YOUR_API_KEY"
Responseโ
Success (200 OK)โ
{
"data": [
{
"id": 1,
"name": "Beach Day Package",
"description": "Everything you need for a perfect day at the beach.",
"excerpt": "Complete beach package",
"pricing": {
"type": "calculated",
"flat_price": null,
"interval_unit": null
},
"total_items": 3,
"is_bookable": true,
"created_at": "2026-01-15T10:00:00Z",
"updated_at": "2026-01-15T10:00:00Z"
},
{
"id": 2,
"name": "Camping Essentials",
"description": "Basic camping gear bundle.",
"excerpt": "Camping starter kit",
"pricing": {
"type": "flat",
"flat_price": 75.00,
"interval_unit": "day"
},
"total_items": 4,
"is_bookable": true,
"created_at": "2026-01-10T08:30:00Z",
"updated_at": "2026-01-12T14:00:00Z"
}
],
"meta": {
"current_page": 1,
"last_page": 3,
"per_page": 10,
"total": 25,
"request_id": "req_abc123"
}
}
Errorsโ
| Status | Code | Description |
|---|---|---|
| 401 | authentication_required | No API key provided |
| 403 | insufficient_scope | API key lacks products:read scope |
Notesโ
- Results are sorted by creation date (newest first)
- The
itemsarray is not included in list responses for performance; use Get Bundle for full details is_bookableistruewhen the bundle has at least 2 items