List Bookings

GET/bookings

Retrieve all bookings where the authenticated user is the guest, ordered by start date (newest first). Each booking includes basic boat details and images.

Requires session authentication. Returns only bookings belonging to the logged-in user.

Request

curl https://charter.boats/api/bookings \
  -H "Cookie: <session-cookie>"

Response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "boat_id": "boat-uuid",
    "guest_id": "user-uuid",
    "status": "confirmed",
    "start_at": "2026-07-12T17:00:00",
    "end_at": "2026-07-19T09:00:00",
    "guest_count": 6,
    "total_price": 4200,
    "service_fee": 45,
    "booking_source": "direct",
    "created_at": "2026-06-01T10:30:00Z",
    "boat": {
      "id": "boat-uuid",
      "title": "Luxury Catamaran",
      "boat_type": "catamaran",
      "location": {
        "id": "location-uuid",
        "name": "ACI Marina Split",
        "city": "Split",
        "country": "Croatia"
      },
      "images": [
        {
          "url": "https://...",
          "is_primary": true,
          "is_active": true
        }
      ]
    }
  }
]

Response Fields

Field	Type	Description
`id`	string	Booking ID (UUID)
`boat_id`	string	ID of the booked boat
`guest_id`	string	ID of the guest who made the booking
`status`	string	`pending`, `accepted`, `confirmed`, `completed`, `cancelled`
`start_at`	string	Charter start (ISO 8601 datetime, typically 17:00 check-in)
`end_at`	string	Charter end (ISO 8601 datetime, typically 09:00 check-out)
`guest_count`	integer	Number of guests
`total_price`	number	Charter price + fees (excludes service fee)
`service_fee`	number	Flat platform service fee
`booking_source`	string	`direct`, `nausys`, or `mmk`
`created_at`	string	When the booking was created
`boat`	object	Boat summary with location and images

Errors

Status	Message
`401`	Authentication required

List Bookings

Request

Response

Response Fields

Errors

On this page