Seasonal Pricing

GET/boats/:id/prices

Retrieve all seasonal pricing rules for a boat, ordered by priority (highest first), then by start month.

Path Parameters

Parameter	Type	Description
`id`	string	Boat ID (UUID)

Request

curl https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000/prices

Response

Returns an array of price objects.

[
  {
    "id": "996b6261-29ab-4770-b203-2c0d2a7b7e43",
    "boat_id": "3a121be0-c1f8-4432-8e18-4a125b46da65",
    "name": "High Season 2026",
    "start_month": 9,
    "start_day": 19,
    "end_month": 10,
    "end_day": 10,
    "price_per_day": 150.11,
    "priority": 8,
    "created_at": "2026-04-26T03:09:24.113714+00:00",
    "discount_percentage": null,
    "discount_name": null,
    "original_price_per_day": null,
    "valid_from_year": 2026,
    "valid_to_year": 2026,
    "product_name": "Crewed"
  },
  {
    "id": "95e31374-b7b6-4853-92e5-db41e5ceecc5",
    "boat_id": "3a121be0-c1f8-4432-8e18-4a125b46da65",
    "name": "High Season 2026",
    "start_month": 7,
    "start_day": 11,
    "end_month": 8,
    "end_day": 1,
    "price_per_day": 213.31,
    "priority": 7,
    "created_at": "2026-05-29T15:08:19.279204+00:00",
    "discount_percentage": 43,
    "discount_name": "43% discount",
    "original_price_per_day": 355.5,
    "valid_from_year": 2026,
    "valid_to_year": 2026,
    "product_name": "Crewed"
  }
]

Response Fields

Field	Type	Description
`id`	string	Price ID (UUID)
`boat_id`	string	Boat this price belongs to
`name`	string	Price name
`start_month`	integer	Start month (1-12)
`start_day`	integer	Start day (1-31)
`end_month`	integer	End month (1-12)
`end_day`	integer	End day (1-31)
`price_per_day`	number	Daily rate for this price
`priority`	integer	Higher priority wins on overlaps (default: 0)
`original_price_per_day`	number \| null	Pre-discount price (if a discount applies)
`discount_percentage`	number \| null	Active discount percentage
`discount_name`	string \| null	Name of the discount
`valid_from_year`	integer \| null	Year the price starts applying
`valid_to_year`	integer \| null	Year the price stops applying
`product_name`	string \| null	Product/package variant this price belongs to (e.g. `Bareboat`, `Crewed`)
`created_at`	string	ISO 8601 timestamp

Prices can wrap around year boundaries (e.g., November 15 to January 15).

This endpoint is read-only. Seasonal prices are created and edited from the dashboard under your logged-in session — there is no keyed endpoint to write them. To compute the effective price for specific dates, use Resolve Pricing.

Price Resolution

When multiple prices overlap, the one with the highest priority value wins. If no price covers a date, the date is considered unavailable.

Priority order:

Date-specific overrides (highest)
Seasonal pricing (by priority)
No coverage = unavailable