Resolve Pricing

GET/boats/:id/pricing

Resolve the effective daily price for each day in a date range. Applies the full pricing waterfall: date overrides take priority over seasonal pricing. Days with no season coverage and no override are marked unavailable.

Path Parameters

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

Query Parameters

Parameter	Type	Required	Description
`start`	string	Yes	Start date (YYYY-MM-DD)
`end`	string	Yes	End date (YYYY-MM-DD)

The range is exclusive of the end date (i.e., start up to but not including end).

Request

curl "https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000/pricing?start=2024-07-01&end=2024-07-08"

Response

{
  "prices": [
    {
      "date": "2024-07-01",
      "price": 500,
      "source": "season",
      "seasonName": "Peak Season",
      "isAvailable": true
    },
    {
      "date": "2024-07-02",
      "price": 500,
      "source": "season",
      "seasonName": "Peak Season",
      "isAvailable": true
    },
    {
      "date": "2024-07-03",
      "price": 500,
      "source": "season",
      "seasonName": "Peak Season",
      "isAvailable": true
    },
    {
      "date": "2024-07-04",
      "price": 600,
      "source": "override",
      "isAvailable": true,
      "note": "Independence Day"
    },
    {
      "date": "2024-07-05",
      "price": 0,
      "source": "override",
      "isAvailable": false,
      "note": "Owner use"
    },
    {
      "date": "2024-07-06",
      "price": 500,
      "source": "season",
      "seasonName": "Peak Season",
      "isAvailable": true
    },
    {
      "date": "2024-07-07",
      "price": 500,
      "source": "season",
      "seasonName": "Peak Season",
      "isAvailable": true
    }
  ],
  "summary": {
    "totalDays": 7,
    "availableDays": 6,
    "unavailableDays": 1,
    "subtotal": 3100,
    "minPrice": 500,
    "maxPrice": 600,
    "avgPrice": 516.67
  }
}

Response Fields

`prices` array

Field	Type	Description
`date`	string	Date (YYYY-MM-DD)
`price`	number	Resolved price for this day (0 if unavailable)
`source`	string	`season` or `override`
`seasonName`	string	Name of the matching season (only when source is `season`)
`isAvailable`	boolean	Whether the date is bookable
`note`	string	Note from a date override (only when source is `override`)
`originalPrice`	number \| null	Pre-discount price (if a seasonal discount applies)
`discountPercentage`	number \| null	Active discount percentage
`discountName`	string \| null	Name of the discount

`summary` object

Field	Type	Description
`totalDays`	integer	Total days in the range
`availableDays`	integer	Number of bookable days
`unavailableDays`	integer	Number of blocked days
`subtotal`	number	Sum of prices for available days
`minPrice`	number	Lowest daily price among available days
`maxPrice`	number	Highest daily price among available days
`avgPrice`	number	Average daily price among available days

Price Sources

season: Using a seasonal pricing rule. The matching season's name is included in seasonName.
override: Using a date-specific price override. Overrides always take priority over seasons.

Pricing Waterfall

Date override -- if one exists for this date, it wins (can set a custom price or mark unavailable)
Season -- the highest-priority matching season sets the price
No coverage -- if neither exists, the day is unavailable (isAvailable: false, price: 0)

Errors

Status	Message
`400`	start and end dates are required
`400`	Dates must be in YYYY-MM-DD format

Use Cases

Calculate Booking Total

const res = await fetch(
  `/api/boats/${boatId}/pricing?start=${checkIn}&end=${checkOut}`
);
const { summary } = await res.json();
 
// Add fees
const fees = await fetch(`/api/boats/${boatId}/fees?start=${checkIn}&end=${checkOut}`);
const feeTotal = fees
  .filter(f => f.required)
  .reduce((sum, f) => sum + (f.period === 'per_day' ? f.amount * summary.availableDays : f.amount), 0);
 
const grandTotal = summary.subtotal + feeTotal + 45; // + $45 service fee

Display Calendar Prices

curl "https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000/pricing?start=2024-07-01&end=2024-08-01"

Resolve Pricing

On this page