Skip to main content

Check Carpool Vehicle Availability

GET 
/carpool/vehicles/availability

Asks Carpool whether a booking would be accepted for a vehicle and window, before POST /carpool/bookings is called. Supply exactly one of filter[vehicle_id] and filter[category_id].

The window, vehicle and driver go through the checks POST /carpool/bookings applies, including the account cooldown between bookings. A category selection returns the one vehicle Carpool would assign and needs filter[request_driver_id]. A vehicle selection may leave the driver out, and then only the window and vehicle checks run. A 422 carries the reason_code POST /carpool/bookings returns for the same cause.

The Checking Availability guide covers the checks and their order, what only create checks, and what a subuser sees.

Request​

Responses​

The bookable vehicle, or an empty list when the vehicle is not an active Carpool vehicle of the account. The list holds at most one item, so the response carries no pagination.