Cria.al

Use this when the traveller has picked one car (a slug from search_cars) and wants to know whether it can be rented for particular dates and locations, or what that trip costs with the extras they want. Returns available true with the car's trip_total_eur and a booking_url that opens the booking on cria.al with the trip filled in, or available false with the reason. When the car is not available, offer other dates or call search_cars for alternatives. Do not use this to browse cars; use search_cars.

check_availability

Use this when the traveller asks about one car they found with search_cars, before deciding to book it. Returns its specs, colour, odometer reading, features and photos; the security deposit; where it can be picked up and returned, with any delivery fee; the rental provider's base city, rating, opening hours and out-of-hours fee; its rental rules (minimum rental days, minimum driver age, how many days before pickup cancellation is free, the no-show guarantee, the payment methods accepted at pickup); the insurance every rental includes; and the optional extras with their prices (insurance tiers and what each covers, border crossing and the allowed countries, child seat, unlimited kilometres and others). Takes a slug returned by search_cars; never guess one. It neither prices a trip nor checks dates: use check_availability for that.

get_car

Use this to turn a place the traveller names (an airport, a city, a beach town) into the location code that search_cars and check_availability take, or when the traveller asks where in Albania cars can be picked up. Returns every location where at least one car on cria.al can be picked up, with its code, its name, whether it is an airport, how many cars serve it and a link to its car list. If the place the traveller named is not listed, suggest the nearest listed location and confirm it with them before searching.

list_locations

Use this when a traveller wants to rent a car in Albania for specific dates and has not chosen a car yet. Returns the cars available for the whole trip whose rental provider serves the pickup and return locations, in the order the cria.al car list shows them: cars from providers based at the pickup location first, each group by trip total, with a car from elsewhere moved ahead when it is at least EUR 7 a day cheaper. Each car has its trip_total_eur for these dates, the deposit, specs, the provider's base city and rating, a car_url to its page and a booking_url that opens the booking on cria.al with the trip filled in, where the traveller enters their details and pays. results_url opens the same search on cria.al. Pass only the filters and extras the traveller asked for. A requested extra (insurance, border_crossing, child_seat, unlimited_kilometres) keeps only cars that offer it, is included in trip_total_eur and is selected in booking_url. Do not use this for one specific car (use check_availability), for rentals outside Albania, or for flights and hotels.

search_cars