Drop Gear IO - Precision Simplified

Get vehicle identity

Decode a VIN into its vehicle identity (make, model, body, engine, transmission, colour, power, fuel) with no parts. Start here for any VIN — works for every supported brand, fast and small. For the build/equipment option codes the vehicle was ordered with, use get_build_options.

Get build/equipment options

Get the build/equipment option codes a VIN was ordered with, as equipmentCode/group/description items. Not every brand provides this — for brands that don't (e.g. Tesla) it returns supported: false with the message "Brand not supported" (not an error). A genuine failure (access denied, timeout) is returned as an error.

List parts categories

List the standard parts categories (codes 10-29, e.g. 14 = Brakes, 19 = Engine & Fuel System) so you can pick a categoryCode for get_category_parts. This is a fixed reference menu — it returns instantly with no lookup. It is VIN-independent, so not every category has parts for every vehicle; get_category_parts is authoritative (and returns a compact list of the categories that DO have parts if the one you pick is empty for that VIN).

Get parts for one category

Get all parts for ONE category of a vehicle, identified by categoryCode (10-29). This is the main workhorse. It first fetches just that category (cheap). If that category turns out to have no parts for this VIN, it returns a compact index of which categories DO have parts (counts only, not the parts themselves) so you can retry with one of those codes — it never dumps the full catalog just because one guess missed. (For motorcycles, category filtering does not apply — you get a flat assemblies l

Search parts by name

Find parts for a VIN by free-text name (e.g. "rear bumper", "oil filter", "headlight") WITHOUT needing to know the category. Searches the whole catalog and returns only the matching parts, each tagged with the category and assembly it belongs to. Use this when the user names a SPECIFIC part; use get_category_parts when they want a whole category.

List part numbers

Get a flat, de-duplicated, sorted list of every part number for a VIN, without full part details. Useful for cross-referencing or availability checks. Wraps visoea rt=2.

Get full parts catalog

Get the COMPLETE parts catalog for a VIN — every category, assembly and part. WARNING: this is often 1-1.5 MB and can overflow the model context. Prefer list_categories + get_category_parts. Only use this when you genuinely need the entire catalog at once.

Resolve a part number (supersession lookup)

Look up one specific part number in a VIN's catalog and report its supersession status: whether it has since been REPLACED BY a newer part number, or whether it itself REPLACES an older one. Useful when a customer already has a part number in hand and you need to know if it is still current. Not found is a normal answer (e.g. wrong VIN or a typo), not an error.