Get Booking

GET/bookings/:id

Retrieve complete details for a single booking, including boat info, owner details, and any associated review.

This endpoint requires user authentication. Users can only view their own bookings.

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The booking's unique identifier (UUID)

Request

curl https://charter.boats/api/bookings/booking-uuid \
  -H "Authorization: Bearer <supabase-auth-token>"

Response

{
  "id": "booking-uuid",
  "boat_id": "boat-uuid",
  "user_id": "user-uuid",
  "status": "completed",
  "start_date": "2026-01-20",
  "end_date": "2026-01-20",
  "start_time": "09:00",
  "end_time": "17:00",
  "guests": 6,
  "total_price": 2800,
  "message": "Birthday celebration",
  "created_at": "2026-01-15T10:30:00Z",
  "boat": {
    "id": "boat-uuid",
    "title": "Luxury Catamaran",
    "boat_type": "catamaran",
    "location_city": "Miami",
    "location_state": "Florida",
    "price_per_hour": 350,
    "images": [...],
    "owner": {
      "id": "owner-uuid",
      "name": "Captain Mike",
      "avatar_url": "https://..."
    }
  },
  "review": {
    "id": "review-uuid",
    "rating": 5,
    "comment": "Amazing experience! Captain Mike was fantastic.",
    "created_at": "2026-01-21T10:00:00Z"
  }
}

Response Fields

Field	Type	Description
`id`	string	Booking ID
`boat_id`	string	Boat ID
`status`	string	pending, confirmed, cancelled, completed
`start_date`	string	Start date
`end_date`	string	End date
`start_time`	string	Start time
`end_time`	string	End time
`guests`	integer	Number of guests
`total_price`	number	Total price in USD
`message`	string	Guest's message to owner
`boat`	object	Full boat details including owner
`review`	object	Associated review (if completed and reviewed)

Errors

Status	Message
`401`	Authentication required
`404`	Booking not found