Bumper

Create a vehicle report using a license plate and US state. This action consumes an available vehicle-report credit or entitlement. Returns vehicle identity, mileage, market value, ownership history, accident and recall data, detailed pricing, specs, and safety ratings inline. Data availability varies by vehicle and source — this is not a guaranteed complete history. Check premium.status in the response. If it is "locked", salvage and title records are not known yet; always tell the user when you present the report, even if they did not ask about those sections, and offer unlock_vehicle_premium_data instead of reporting them as absent. If it is "unavailable", the premium records are not available in this response yet; tell the user and call unlock_vehicle_premium_data again shortly to refresh the report instead of offering a new unlock or reporting them as absent.

create_vehicle_report_by_plate

Create a vehicle report using a VIN. This action consumes an available vehicle-report credit or entitlement. Returns vehicle identity, mileage, market value, ownership history, accident and recall data, detailed pricing, specs, and safety ratings inline. Data availability varies by vehicle and source — this is not a guaranteed complete history. Check premium.status in the response. If it is "locked", salvage and title records are not known yet; always tell the user when you present the report, even if they did not ask about those sections, and offer unlock_vehicle_premium_data instead of reporting them as absent. If it is "unavailable", the premium records are not available in this response yet; tell the user and call unlock_vehicle_premium_data again shortly to refresh the report instead of offering a new unlock or reporting them as absent.

create_vehicle_report_by_vin

Create a vehicle report using year, make, model, and trim. This action consumes an available vehicle-report credit or entitlement. Returns vehicle identity, mileage, market value, ownership history, accident and recall data, detailed pricing, specs, and safety ratings inline. Data availability varies by vehicle and source — this is not a guaranteed complete history. Check premium.status in the response. If it is "locked", salvage and title records are not known yet; always tell the user when you present the report, even if they did not ask about those sections, and offer unlock_vehicle_premium_data instead of reporting them as absent. If it is "unavailable", the premium records are not available in this response yet; tell the user and call unlock_vehicle_premium_data again shortly to refresh the report instead of offering a new unlock or reporting them as absent.

create_vehicle_report_by_ymm

Unlock the premium NMVTIS records (salvage history, title checks, title registrations) of an existing vehicle report and return the refreshed report. Use the report_id returned by a create_vehicle_report_by_* tool, only after the user agrees to unlock. This may use one of the user's premium unlocks and does not create a new report. If premium.status is "unavailable" in the result the records are still loading: call this tool again shortly. Owner and past-owner sections stay unavailable on the user's plan even after unlocking.

unlock_vehicle_premium_data

Retrieve focused accident, recall, salvage, reported-damage, repair-quote, and maintenance details from an existing vehicle report. Use the report_id returned by a create_vehicle_report_by_* tool. Multiple accident records may relate to the same underlying incident — do not treat the record count as the number of distinct collisions. Salvage is premium NMVTIS data: when salvage holds a status/message object instead of a list, it is locked or pending, which is NOT the same as no salvage history — tell the user and offer unlock_vehicle_premium_data.

get_vehicle_damages

Retrieve focused market value, pricing tiers, price range, and ownership-cost data from an existing vehicle report. Use the report_id returned by a create_vehicle_report_by_* tool. All figures are estimates based on Bumper's available data and assumptions, not guaranteed sale prices.

get_vehicle_market_value

Retrieve focused ownership, title, lien, investigation, inspection, sales, and damage-history details from an existing vehicle report. Use the report_id returned by a create_vehicle_report_by_* tool. An empty list means no such record was found in the available Bumper data — it does not confirm the event never happened. Exception: title_checks, title_registrations and the salvage count are premium NMVTIS data; when they hold a status/message object instead of a list, they are locked or pending, which is NOT the same as no records — tell the user and offer unlock_vehicle_premium_data.

get_vehicle_background

Retrieve focused NHTSA safety ratings, complaint counts, and warranty details from an existing vehicle report. Use the report_id returned by a create_vehicle_report_by_* tool. NHTSA ratings are not available for every vehicle/trim — a missing rating means it was not found, not that the vehicle tested poorly.

get_vehicle_safety

Retrieve focused technical specifications, equipment, and design details from an existing vehicle report. Use the report_id returned by a create_vehicle_report_by_* tool. Installed equipment/options reflect what Bumper's data sources report for this vehicle and may not list every factory option.

get_vehicle_specs