Date-Specific Prices

GET/boats/:id/date-prices

Retrieve date-specific price overrides and availability blocks for a boat within a date range.

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)

Request

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

Response

Returns an array of date-price objects, ordered by date ascending.

[
  {
    "id": "dp-1a2b3c...",
    "boat_id": "550e8400-e29b-41d4-a716-446655440000",
    "date": "2024-07-04",
    "price_per_day": 600,
    "is_available": true,
    "note": "Independence Day premium",
    "created_at": "2024-01-15T10:00:00Z"
  },
  {
    "id": "dp-4d5e6f...",
    "boat_id": "550e8400-e29b-41d4-a716-446655440000",
    "date": "2024-07-05",
    "price_per_day": null,
    "is_available": false,
    "note": "Owner use",
    "created_at": "2024-01-15T10:00:00Z"
  }
]

Response Fields

Field	Type	Description
`id`	string	Date-price ID (UUID)
`boat_id`	string	Boat this override belongs to
`date`	string	Date (YYYY-MM-DD)
`price_per_day`	number \| null	Custom price, or null if using season price
`is_available`	boolean	Whether the date is bookable
`note`	string \| null	Optional note/reason
`created_at`	string	ISO 8601 timestamp

Errors

Status	Message
`400`	start and end dates are required

Set Date Prices

POST/boats/:id/date-prices

Create or update date-specific prices and availability. Accepts a single object or an array for bulk operations. Uses upsert -- existing entries for the same boat + date are updated.

Requires authentication as a company member for the boat.

Authentication

X-API-Key: cb_live_xxxxx

Request Body

Single object or array of date-price objects:

Field	Type	Required	Description
`date`	string	Yes	Date (YYYY-MM-DD)
`price_per_day`	number \| null	No	Custom price (null to clear override)
`is_available`	boolean	No	Default: `true`. Set to `false` to block the date.
`note`	string \| null	No	Optional note/reason

Request

curl -X POST https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000/date-prices \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cb_live_xxxxx" \
  -d '[
    {
      "date": "2024-07-04",
      "price_per_day": 600,
      "note": "Independence Day"
    },
    {
      "date": "2024-07-05",
      "is_available": false,
      "note": "Owner use"
    },
    {
      "date": "2024-07-06",
      "price_per_day": 550
    }
  ]'

Response

Returns the array of upserted date-price objects.

[
  {
    "id": "dp-1a2b3c...",
    "boat_id": "550e8400-e29b-41d4-a716-446655440000",
    "date": "2024-07-04",
    "price_per_day": 600,
    "is_available": true,
    "note": "Independence Day",
    "created_at": "2024-01-15T10:00:00Z"
  },
  {
    "id": "dp-4d5e6f...",
    "boat_id": "550e8400-e29b-41d4-a716-446655440000",
    "date": "2024-07-05",
    "price_per_day": null,
    "is_available": false,
    "note": "Owner use",
    "created_at": "2024-01-15T10:00:00Z"
  },
  {
    "id": "dp-7g8h9i...",
    "boat_id": "550e8400-e29b-41d4-a716-446655440000",
    "date": "2024-07-06",
    "price_per_day": 550,
    "is_available": true,
    "note": null,
    "created_at": "2024-01-15T10:00:00Z"
  }
]

Errors

Status	Message
`400`	At least one date price entry required
`400`	Each item must have a valid date (YYYY-MM-DD)
`404`	Boat not found

Use Cases

Block Dates for Maintenance

curl -X POST https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000/date-prices \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cb_live_xxxxx" \
  -d '[
    {"date": "2024-08-01", "is_available": false, "note": "Engine service"},
    {"date": "2024-08-02", "is_available": false, "note": "Engine service"}
  ]'

Holiday Premium Pricing

curl -X POST https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000/date-prices \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cb_live_xxxxx" \
  -d '[
    {"date": "2024-12-24", "price_per_day": 750, "note": "Christmas Eve"},
    {"date": "2024-12-25", "price_per_day": 750, "note": "Christmas Day"},
    {"date": "2024-12-31", "price_per_day": 900, "note": "New Years Eve"}
  ]'

Single Date Override

You can also send a single object instead of an array:

curl -X POST https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000/date-prices \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cb_live_xxxxx" \
  -d '{"date": "2024-07-04", "price_per_day": 600}'

Date-Specific Prices

On this page