CarVault

Add a general non-fuel, non-service vehicle expense. Resolve names with list_vehicles first. amountDecimal is an exact base-10 string, currency must match the vehicle, date is ISO YYYY-MM-DD, and optional mileage is km. Cost group is derived by CarVault and must not be supplied.

Add multiple fuel or electric charging expenses for one active vehicle. Resolve names with list_vehicles first. All entries use the vehicle currency; liquid quantity is litres and electric quantity is kWh. Submit entries oldest to newest. Each entry has an exact amountDecimal and quantityDecimal, optional mileage in km, and isFullTank defaults false unless the user explicitly confirmed it. Free accounts can keep up to 15 expense records on their active vehicle; the batch is rejected before writing if its known remaining allowance is too small. The API creates entries individually, so a concurrent write can leave a structured partial result; an exact retry safely replays those entries without duplicates.

Add a fuel or electric charging expense to an active vehicle. Resolve names with list_vehicles first. amountDecimal and quantityDecimal are exact decimal strings, currency must match the vehicle, liquid quantity is litres, electric quantity is kWh, and mileage is optional km. isFullTank defaults false and must be true only when the user explicitly said the tank was filled completely; never infer it from 'fuel-up'. Consumption needs two full-tank entries with mileage.

Add a manual odometer reading to an active vehicle. Resolve names with list_vehicles first. date is ISO YYYY-MM-DD and mileageKm is the exact non-negative odometer value in kilometres; chronology must not decrease by effective date.

Add a SERVICE or REPAIR record to an active vehicle, optionally with next-service targets and an actual reminder. Resolve names first. Money is an exact decimal string with vehicle currency; dates are ISO and mileage is km. A created reminder updates phone notifications only after the mobile app next opens or foregrounds.

Get exact vehicle cost statistics for an optional inclusive ISO-date range. Money is returned as base-10 minor-unit strings with ISO-4217 currency; do not treat minor units as major-unit decimals. Returns actionable insufficient-data text rather than zero when there are no expenses.

Get fuel or energy statistics for one vehicle and optional ISO-date range. Distance is km; liquid quantity is litres, electric quantity is kWh, and consumption is canonical quantity per 100 km. Uses full-tank anchors only and returns an actionable explanation instead of zero or an estimate when data is insufficient.

List active reminders due across non-archived vehicles. Due mileage is in km, due dates are ISO dates, money uses minor-unit strings plus ISO currency, and status is computed by CarVault using the user's synchronized thresholds.

Get one vehicle's details, current observed mileage in km, expense count, fuel statistics, and cost summary. Resolve a spoken vehicle name with list_vehicles first. Fuel consumption is full-tank-to-full-tank only and is never estimated.

List the user's vehicles and their exact vehicleIds. Call this first to resolve names such as 'the Peugeot'. Mileage is in km. By default archived vehicles are omitted; archived vehicles are read-only.