List Pricing Rules
Get all pricing rules for a product.
Endpointโ
GET /v1/products/{id}/pricing
Authenticationโ
Requires an API key with the products:read scope.
Parametersโ
| Parameter | Type | Location | Description |
|---|---|---|---|
id | integer | path | The product ID |
Responseโ
Success (200 OK)โ
{
"data": {
"product_id": 1,
"pricing": [
{
"id": 1,
"season": null,
"price_structure": "flat",
"price": 50.00,
"interval": 1,
"label": null,
"interval_units": "day",
"interval_description": "Day",
"display_on_widget": true,
"created_at": "2026-01-15T10:00:00+00:00",
"updated_at": "2026-01-15T10:00:00+00:00"
},
{
"id": 2,
"season": {
"id": 1,
"name": "Summer Peak",
"start_date": "2026-06-01",
"end_date": "2026-08-31",
"date_ranges": [
{ "start_date": "2026-06-01", "end_date": "2026-08-31" },
{ "start_date": "2026-12-01", "end_date": "2026-12-20" }
]
},
"price_structure": "flat",
"price": 75.00,
"interval": 1,
"label": "Full day",
"interval_units": "day",
"interval_description": "Day",
"display_on_widget": true,
"created_at": "2026-01-15T10:00:00+00:00",
"updated_at": "2026-01-15T10:00:00+00:00"
}
]
},
"meta": {
"request_id": "req_abc123",
"timestamp": "2026-02-01T10:00:00+00:00"
}
}
Season blockโ
When a pricing rule is tied to a seasonal rate, the season object describes when that rate applies:
| Field | Type | Description |
|---|---|---|
id | integer | Season identifier |
name | string | Season name |
start_date | string|null | Start date (YYYY-MM-DD) of the season's first date range. Backward-compatible; equals date_ranges[0].start_date. |
end_date | string|null | End date (YYYY-MM-DD) of the season's first date range. Backward-compatible; equals date_ranges[0].end_date. |
date_ranges | array | All date ranges this season covers, each with start_date and end_date. A date season may span several ranges, so this is the authoritative list of when the seasonal rate applies. Empty for time and days seasons. |
See Get Seasons for the full season object.
Example Requestโ
curl -X GET "https://app.equipdash.com/api/v1/products/1/pricing" \
-H "Authorization: Bearer YOUR_API_KEY"
Errorsโ
| Status | Code | Description |
|---|---|---|
| 401 | authentication_required | No API key provided |
| 403 | insufficient_scope | API key lacks products:read scope |
| 404 | resource_not_found | Product not found |