Validate dates and list available vehicle classes (booking step 2)

Step 2 of the booking flow. Validates the dates, times and locations against the account's rules (opening hours, minimum and maximum rental period, advance booking time) and returns every vehicle class that has a rate for the period, with its availability and price. Classes without a rate or season for the dates are left out.

The minimum and maximum rental period, advance booking time and allowed times are skipped for administrators and for roles that do not set Can skip date validations to Deny. With such a user, enforce these rules in your integration for customer-facing bookings. A new booking made by the HQ 3.0 integration user, the website's booking engine, is always refused when its pick-up is in the past or inside the advance booking time, whatever that user's role.

Nothing is saved for a new booking: send the same booking context again in the next steps. Next: call GET /car-rental/reservations/additional-charges (step 3) with the chosen vehicle_class_id.

Changing an existing booking. Send reservation_id to move that reservation to the new dates. The change is saved, needs the role permission Can edit Reservations (Step 1 to 5), and is only allowed while the reservation is quote, open, pending or pending-reserved; otherwise the response is a business-rule error "The reservation can't be updated". For a new booking, the user needs the role permission Can create Reservations (Step 1 to 5).

Abandoned-cart tracking. Send the same reservation_attempt_uuid on every step to have the booking recorded as a reservation attempt until it is confirmed.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "pick_up_date": "2026-12-01",
    "pick_up_time": "10:00",
    "return_date": "2026-12-05",
    "return_time": "10:00",
    "pick_up_location": 1,
    "return_location": 1,
    "brand_id": 1,
    "reservation_attempt_uuid": "6f1d2c9a-3b7e-4f61-8d2a-0c5e9b4a7f13"
}

Responses

🟢200OK

application/json

HTTP 200 is also used for failures: always check success. When it is false, the body is an ErrorBusinessRule (status_code 410) or an ErrorUnauthorized (status_code 401 or 403). Business-rule failures here include invalid dates, a closed location, a rental period that is too short and a reservation that cannot be changed.

Bodyapplication/json

Examples

Available classesBusiness-rule failure (HTTP 200)

{
    "success": true,
    "status_code": 200,
    "errors": [],
    "data": {
        "reservation": {
            "id": null,
            "header": "New Reservation",
            "pick_up_date": "2026-12-01 10:00:00",
            "return_date": "2026-12-05 10:00:00",
            "flight_arrival_date": "2026-12-01 10:00:00",
            "flight_departure_date": "2026-12-05 10:00:00",
            "flight_number": "",
            "flight_departure_number": "",
            "pick_up_location": {
                "id": 1,
                "name": "Miami Airport",
                "timezone": "America/New_York"
            },
            "return_location": {
                "id": 1,
                "name": "Miami Airport",
                "timezone": "America/New_York"
            },
            "vehicle_class_id": null,
            "customer_id": null,
            "public_link": "",
            "comments": []
        },
        "tour_operator": [],
        "seasons": [
            {
                "id": 1,
                "date_start": "2026-01-01",
                "date_end": "2026-12-31",
                "minimal_rental_period": 1,
                "max_rental_period": 30,
                "minimum_rental_hours": null,
                "maximum_rental_hours": null,
                "rental_periods_per_class": []
            }
        ],
        "applicable_classes": [
            {
                "vehicle_class_id": 3,
                "sipp_code": "CDAR",
                "availability": {
                    "quantity": 4,
                    "next_available": null,
                    "limited_availability": false,
                    "recommended": false,
                    "selectable": true,
                    "selection_alert": null
                },
                "price": {
                    "total_days": 4,
                    "base_price": {
                        "currency": "usd",
                        "currency_icon": "$",
                        "amount": "180.00",
                        "usd_amount": "180.00",
                        "amount_for_display": "$180.00"
                    },
                    "base_price_with_taxes": {
                        "currency": "usd",
                        "currency_icon": "$",
                        "amount": "198.00",
                        "usd_amount": "198.00",
                        "amount_for_display": "$198.00"
                    },
                    "details": [],
                    "total_price_with_mandatory_charges_and_taxes": {
                        "currency": "usd",
                        "currency_icon": "$",
                        "amount": "198.00",
                        "usd_amount": "198.00",
                        "amount_for_display": "$198.00"
                    }
                },
                "vehicle_class": {
                    "label": "Compact",
                    "short_description": "Nissan Versa or similar",
                    "description": "",
                    "features": [],
                    "image": "https://yourcompany.example.com/public/fleets/images/3f1c9e2a-7b4d-4c8e-9a6f-1d2e3c4b5a69/vehicle-class",
                    "recommended": false
                },
                "distance_limits": {
                    "distance_allowed": 0,
                    "distance_limit_per_day": 0,
                    "distance_unit": "mi",
                    "distance_unlimited": true,
                    "distance_extra_price": {
                        "currency": "usd",
                        "currency_icon": "$",
                        "amount": "0.00",
                        "usd_amount": "0.00",
                        "amount_for_display": "$0.00"
                    },
                    "distance_extra_price_with_tax": {
                        "currency": "usd",
                        "currency_icon": "$",
                        "amount": "0.00",
                        "usd_amount": "0.00",
                        "amount_for_display": "$0.00"
                    }
                }
            }
        ]
    }
}

🟠404Record Not Found

🟠422Parameter Error