Skip to main content

Version 1.1.4

Added​

  • Multiple Bookings Support

    • Added vehicleIdentifier parameter to support multiple bookings with the same external booking reference
    • Allows creating multiple vehicle bookings for a single booking reference by providing different vehicleIdentifier values
    • Duplicate prevention: System rejects bookings with the same combination of bookingReference and vehicleIdentifier

  • Enhanced Booking Filtering

    • Added bookingReference query parameter to GET /v1/bookings endpoint
    • Enables filtering and retrieving all bookings associated with a single external reference
    • Use case: Query all vehicles for a booking when using multiple vehicleIdentifier values

  • Booking Activities API

    • Added new endpoint: POST /v1/bookings/{bookId}/activities to create booking activities
    • Added new endpoint: GET /v1/bookings/{bookId}/activities to retrieve booking activities
    • Activities support role-based visibility permissions (operator, driver, passenger)
    • Default permissions: visible to all roles unless specified otherwise

Enhanced​

  • Create booking with quote

    • Added optional vehicleIdentifier parameter (integer)
    • Description: "Optional number to identify multiple vehicles for the same booking reference"

  • Create custom booking

    • Added optional vehicleIdentifier parameter (integer)
    • Description: "Optional number to identify multiple vehicles for the same booking reference"

  • Get a booking

    • Response now includes vehicleIdentifier field
    • Returns the vehicle identifier if set during booking creation

  • Get list bookings

    • Added bookingReference query parameter for filtering
    • Response includes vehicleIdentifier field for each booking

New Schemas​

  • CreateBookingActivityRequest

    • content (required): Activity content/note
    • permission (optional): Visibility permissions object
      • operator (boolean, default: true)
      • driver (boolean, default: true)
      • passenger (boolean, default: true)

  • BookingActivity

    • id: Activity ID
    • bookId: Booking ID
    • content: Activity content
    • createdDate: Activity creation timestamp
    • permission: Visibility permissions object

  • BookingActivityResponse

    • success: Boolean indicating operation success
    • activity: BookingActivity object

  • BookingActivitiesListResponse

    • bookId: Booking ID
    • activities: Array of BookingActivity objects
    • total: Total number of activities