{"openapi":"3.1.0","info":{"title":"TIARENTAL Public Discovery API","version":"3.0.0","description":"Read-only public discovery and date-specific availability endpoints for TIARENTAL rental inventory, suppliers, locations, cross-border rules and published reviews in Albania. Booking creation is not exposed by this public AI API."},"servers":[{"url":"https://tiarental.com"}],"paths":{"/ai/summary":{"get":{"operationId":"marketplaceSummary","summary":"Get a current public marketplace snapshot","responses":{"200":{"description":"Marketplace summary"},"503":{"description":"Live catalog unavailable"}}}},"/ai/cars":{"get":{"operationId":"listCars","summary":"Filter current public rental car listings without asserting date-specific availability","parameters":[{"name":"q","in":"query","required":false,"description":"Free-text match against vehicle, supplier and location fields.","schema":{"type":"string"}},{"name":"transmission","in":"query","required":false,"description":"Example: automatic or manual.","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Example: SUV, Compact, Economy, Premium.","schema":{"type":"string"}},{"name":"supplier","in":"query","required":false,"description":"Supplier name substring.","schema":{"type":"string"}},{"name":"location","in":"query","required":false,"description":"Pickup location, city, airport code or location slug.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Required allowed cross-border country.","schema":{"type":"string"}},{"name":"unlimited_mileage","in":"query","description":"Require or exclude unlimited mileage.","schema":{"type":"boolean"}},{"name":"cross_border","in":"query","description":"Require or exclude cross-border permission.","schema":{"type":"boolean"}},{"name":"instant_confirmation","in":"query","description":"Require or exclude instant confirmation.","schema":{"type":"boolean"}},{"name":"max_price","in":"query","description":"Maximum displayed daily listing price in EUR.","schema":{"type":"number","minimum":0}},{"name":"max_deposit","in":"query","description":"Maximum displayed refundable deposit in EUR.","schema":{"type":"number","minimum":0}},{"name":"min_seats","in":"query","description":"Minimum seat count.","schema":{"type":"number","minimum":1}},{"name":"max_minimum_days","in":"query","description":"Maximum standard minimum rental days.","schema":{"type":"number","minimum":1}},{"name":"short_stay_days","in":"query","description":"Require a vehicle bookable for this exact duration through its standard minimum or an explicit short-stay price.","schema":{"type":"number","minimum":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":250,"default":100}}],"responses":{"200":{"description":"Filtered public rental car inventory"},"503":{"description":"Live catalog unavailable"}}}},"/ai/search":{"get":{"operationId":"searchAvailableCars","summary":"Search current date-specific rental availability and quote snapshots","description":"Preferred endpoint when the user supplies pickup/return dates and locations. Results reflect availability at generation time and can change before confirmation.","parameters":[{"name":"pickup","in":"query","required":false,"description":"Pickup location, for example Tirana Airport (TIA).","schema":{"type":"string"}},{"name":"dropoff","in":"query","required":false,"description":"Drop-off location. Defaults to pickup.","schema":{"type":"string"}},{"name":"from","in":"query","required":true,"description":"Pickup date in YYYY-MM-DD format.","schema":{"type":"string"}},{"name":"to","in":"query","required":true,"description":"Return date in YYYY-MM-DD format.","schema":{"type":"string"}},{"name":"from_time","in":"query","required":false,"description":"Pickup time in HH:MM, Europe/Tirane local time. Default 10:00.","schema":{"type":"string"}},{"name":"to_time","in":"query","required":false,"description":"Return time in HH:MM, Europe/Tirane local time. Default 10:00.","schema":{"type":"string"}},{"name":"transmission","in":"query","required":false,"description":"Optional transmission filter.","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Optional category filter.","schema":{"type":"string"}},{"name":"supplier","in":"query","required":false,"description":"Optional supplier substring.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Require permission for one cross-border country.","schema":{"type":"string"}},{"name":"unlimited_mileage","in":"query","description":"Require or exclude unlimited mileage.","schema":{"type":"boolean"}},{"name":"cross_border","in":"query","description":"Require or exclude cross-border permission.","schema":{"type":"boolean"}},{"name":"instant_confirmation","in":"query","description":"Require or exclude instant confirmation.","schema":{"type":"boolean"}},{"name":"max_price","in":"query","description":"Maximum quoted daily rate in EUR.","schema":{"type":"number","minimum":0}},{"name":"max_deposit","in":"query","description":"Maximum refundable deposit in EUR.","schema":{"type":"number","minimum":0}},{"name":"min_seats","in":"query","description":"Minimum seat count.","schema":{"type":"number","minimum":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Current availability results"},"400":{"description":"Invalid rental period"},"503":{"description":"Availability service unavailable"}}}},"/ai/suppliers":{"get":{"operationId":"listSuppliers","summary":"List public local rental suppliers","parameters":[{"name":"verified_only","in":"query","description":"Defaults to true. Set false to include active public suppliers that are not yet verified.","schema":{"type":"boolean"}},{"name":"q","in":"query","required":false,"description":"Supplier name or description substring.","schema":{"type":"string"}},{"name":"location","in":"query","required":false,"description":"Require supplier inventory in a matching location.","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Require supplier inventory in a matching vehicle category.","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":250,"default":100}}],"responses":{"200":{"description":"Public supplier list"},"503":{"description":"Live catalog unavailable"}}}},"/ai/cross-border":{"get":{"operationId":"listCrossBorderCars","summary":"List public cars allowing requested cross-border travel","parameters":[{"name":"country","in":"query","required":false,"description":"Single requested country.","schema":{"type":"string"}},{"name":"countries","in":"query","required":false,"description":"Comma-separated requested countries, for example Montenegro,Kosovo,North Macedonia.","schema":{"type":"string"}},{"name":"match","in":"query","schema":{"type":"string","enum":["all","any"],"default":"all"}},{"name":"transmission","in":"query","required":false,"description":"Optional transmission filter.","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Optional vehicle category filter.","schema":{"type":"string"}},{"name":"unlimited_mileage","in":"query","description":"Require or exclude unlimited mileage.","schema":{"type":"boolean"}},{"name":"max_deposit","in":"query","description":"Maximum displayed refundable deposit in EUR.","schema":{"type":"number","minimum":0}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":250,"default":100}}],"responses":{"200":{"description":"Cross-border eligible public listings"},"503":{"description":"Live catalog unavailable"}}}},"/ai/destinations":{"get":{"operationId":"listDestinations","summary":"List active TIARENTAL pickup destinations and current listing counts","parameters":[{"name":"q","in":"query","required":false,"description":"Location, city, airport code or slug substring.","schema":{"type":"string"}}],"responses":{"200":{"description":"Active rental locations"},"503":{"description":"Live catalog unavailable"}}}},"/ai/reviews":{"get":{"operationId":"listPublishedReviews","summary":"List published approved reviews linked to bookings and public vehicles","parameters":[{"name":"supplier","in":"query","required":false,"description":"Supplier name substring.","schema":{"type":"string"}},{"name":"vehicle","in":"query","required":false,"description":"Vehicle name substring.","schema":{"type":"string"}},{"name":"min_rating","in":"query","schema":{"type":"number","minimum":1,"maximum":5}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}}],"responses":{"200":{"description":"Published approved reviews"},"503":{"description":"Live catalog unavailable"}}}},"/ai/health":{"get":{"operationId":"discoveryHealth","summary":"Check whether public AI discovery data is available","responses":{"200":{"description":"Healthy"},"503":{"description":"Unavailable"}}}}}}