Create Booking

POST/bookings

Create a booking request for a boat. The booking starts in pending status and must be confirmed by the boat owner (unless instant booking is enabled).

This endpoint requires user authentication via Supabase Auth.

Request Body

Field	Type	Required	Description
`boat_id`	string	Yes	ID of the boat to book
`start_date`	string	Yes	Start date (YYYY-MM-DD)
`end_date`	string	Yes	End date (YYYY-MM-DD)
`start_time`	string	Yes	Start time (HH:MM, 24-hour)
`end_time`	string	Yes	End time (HH:MM, 24-hour)
`guests`	integer	Yes	Number of guests
`message`	string	No	Message to the boat owner

Request

curl -X POST https://charter.boats/api/bookings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <supabase-auth-token>" \
  -d '{
    "boat_id": "550e8400-e29b-41d4-a716-446655440000",
    "start_date": "2026-02-15",
    "end_date": "2026-02-15",
    "start_time": "09:00",
    "end_time": "17:00",
    "guests": 6,
    "message": "Celebrating a birthday!"
  }'

Response

{
  "id": "booking-uuid",
  "boat_id": "550e8400-e29b-41d4-a716-446655440000",
  "user_id": "user-uuid",
  "status": "pending",
  "start_date": "2026-02-15",
  "end_date": "2026-02-15",
  "start_time": "09:00",
  "end_time": "17:00",
  "guests": 6,
  "total_price": 2800,
  "message": "Celebrating a birthday!",
  "created_at": "2026-01-27T10:30:00Z"
}

Response Fields

Field	Type	Description
`id`	string	Created booking ID
`status`	string	Initial status (pending or confirmed for instant book)
`total_price`	number	Calculated total price

Errors

Status	Message
`400`	Boat is not available for the selected dates
`400`	Number of guests exceeds boat capacity
`400`	Booking duration is below minimum required hours
`401`	Authentication required