List Bookings

GET/bookings

Retrieve all bookings for the currently authenticated user (as a guest).

This endpoint requires user authentication via Supabase Auth, not API key authentication.

Query Parameters

Parameter	Type	Description
`status`	string	Filter by status: `pending`, `confirmed`, `cancelled`, `completed`

Request

curl https://charter.boats/api/bookings \
  -H "Authorization: Bearer <supabase-auth-token>"
 
# Filter by status
curl "https://charter.boats/api/bookings?status=confirmed" \
  -H "Authorization: Bearer <supabase-auth-token>"

Response

[
  {
    "id": "booking-uuid-1",
    "boat_id": "boat-uuid",
    "user_id": "user-uuid",
    "status": "confirmed",
    "start_date": "2026-02-15",
    "end_date": "2026-02-15",
    "start_time": "09:00",
    "end_time": "17:00",
    "guests": 6,
    "total_price": 2800,
    "message": "Looking forward to the trip!",
    "created_at": "2026-01-27T10:30:00Z",
    "boat": {
      "id": "boat-uuid",
      "title": "Luxury Catamaran",
      "boat_type": "catamaran",
      "location_city": "Miami",
      "location_state": "Florida",
      "images": [
        {
          "url": "https://...",
          "is_primary": true
        }
      ]
    }
  }
]

Response Fields

Field	Type	Description
`id`	string	Booking ID (UUID)
`boat_id`	string	ID of the booked boat
`user_id`	string	ID of the guest
`status`	string	pending, confirmed, cancelled, completed
`start_date`	string	Start date (ISO 8601)
`end_date`	string	End date (ISO 8601)
`start_time`	string	Start time (HH:MM)
`end_time`	string	End time (HH:MM)
`guests`	integer	Number of guests
`total_price`	number	Total price in USD
`boat`	object	Boat details with images

List Bookings

Query Parameters

Request

Response

Response Fields

On this page