A FINN car subscription is a flexible way to stay mobile anytime - without long-term commitments like buying or leasing a car. With a fixed monthly rate that already includes insurance, maintenance, registration, and even CO₂ offsetting, the car subscription offers full transparency and convenience.
Best of all, you can book online in just a few minutes, and your new car will be delivered straight to your doorstep or you can pick it up at one of our stations.
get_available_filtersDiscover what's currently available in FINN's fleet. Returns all brands (with nested models), car types, fuel types, colors, subscription terms, gearshifts, and price/power/range bounds. Use this to answer questions like 'What brands does FINN offer?' or to validate filter values before searching.
get_subscription_pricingCalculate exact monthly subscription price for a specific vehicle, term, and mileage combination. Returns base price, km add-on, total, and checkout link.
km_packageMonthly km package (500, 1000, 1500, 2000, 2500, 3000, 4000, 5000)
term_monthsSubscription term in months (1, 6, 9, 12, 13, 18, 24, 36)
vehicle_idstringThe vehicle product ID
get_vehicle_detailsGet full specifications, equipment, all images, pricing per term, and checkout links for a specific vehicle. Use a vehicle_id from search_vehicles results. IMPORTANT: Always show detail_url and checkout_url as clickable links. The vehicle_id field is an internal API identifier — never display it to users.
vehicle_idstringThe vehicle product ID (e.g. "bmw-ix1-12345-alpinweissuni")
search_vehiclesSearch available cars on FINN with filters. Returns matching vehicles with prices, images, and links. All filter values use German names (e.g. "Elektro" not "Electric", "Schwarz" not "Black"). IMPORTANT: Always show detail_url as a clickable link for each vehicle. The vehicle_id field is an internal API identifier for get_vehicle_details — never display it to users.
available_fromstringEarliest delivery date (YYYY-MM-DD)
available_tostringLatest delivery date (YYYY-MM-DD)
brandsarrayCar brands (e.g. ["BMW", "Audi", "Mercedes-Benz"])
cartypesarrayCar types in German (e.g. ["SUV", "Kombi", "Kleinwagen", "Van"])
colorsarrayColors in German (e.g. ["Schwarz", "Weiß", "Blau"])
fuelsarrayFuel types in German (e.g. ["Elektro", "Benzin", "Diesel", "Plug-In-Hybrid"])
has_dealsbooleanFilter for cars with special deals/discounts
has_hitchbooleanFilter for cars with hitch
is_young_driverbooleanFilter for cars allowing drivers under 23
limitnumberNumber of results (1-10, default 5)
max_ev_rangenumberMaximum electric range in km
max_powernumberMaximum power in kW
max_pricenumberMaximum monthly price in EUR
min_ev_rangenumberMinimum electric range in km
min_powernumberMinimum power in kW
min_pricenumberMinimum monthly price in EUR
modelsarrayCar models (e.g. ["iX1", "3er Limousine"])
sortstringSort order: asc/desc by price, availability, or last_added
ascdescavailabilitylast_addedtermsarraySubscription term lengths in months (available: 1, 6, 12, 18, 24, 36)