Skip to main content

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โ€‹

ParameterTypeLocationDescription
idintegerpathThe 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:

FieldTypeDescription
idintegerSeason identifier
namestringSeason name
start_datestring|nullStart date (YYYY-MM-DD) of the season's first date range. Backward-compatible; equals date_ranges[0].start_date.
end_datestring|nullEnd date (YYYY-MM-DD) of the season's first date range. Backward-compatible; equals date_ranges[0].end_date.
date_rangesarrayAll 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โ€‹

StatusCodeDescription
401authentication_requiredNo API key provided
403insufficient_scopeAPI key lacks products:read scope
404resource_not_foundProduct not found