Drill down into a generation: per-vehicle modifications with OEM specs and fitment deltas for tire
Changed onGiven a specific generation from the by_tire/search/ hierarchy, returns individual trims/modifications with their OEM wheel and tire specs and per-vehicle fitment data.
Each result describes the vehicle's OEM wheel pair closest to the searched tire: its rim and tire specs plus deltas showing how much the searched tire differs from it: ow_delta_mm (overall width), od_delta_mm and od_delta_percent (overall diameter), and ar_delta (aspect ratio, percentage points). load_kg / load_index are the maximum over all of the vehicle's matching pairs.
Matching is identical to by_tire/search/ — exact rim diameter, with tire overall width and overall diameter within ±2 mm — so against the same data every generation returned by the parent endpoint resolves here to at least one modification. The two responses are cached independently, so right after a catalogue update an empty result is possible. The ±2 mm window also bounds ow_delta_mm and od_delta_mm to ±2: they report how exact the match is, not a size change.
There is no cb_diff_mm here — a tire has no centre bore.
Request
- Base URLhttps://api.wheel-size.com (the document declares no server; this is the origin it was published from)
- AuthAPI key in query parameter user_key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Section width is the width of the tire in mm. You can use GET /by_tire/sw/ to get a list of available value values. (e.g. 225)
The Aspect ratio is indicated on the tire sidewall as a percentage. It's the height of the sidewall measured from wheel rim to top of the tread, expressed as a percentage of tire width. You can use GET /by_tire/ar to get a list of available value values. (e.g. 45)
Rim diameter is the distance measured in inches across the face of the wheel, from bead seat to bead seat. You can use GET /by_rim/rd/ to get a list of available value values. (e.g. 19)
A car's Make is the brand of the vehicle. You can use GET /makes/ to get a list of available slug values. (e.g. mitsubishi)
The particular Model of the brand. You can use GET /models/ to get a list of available slug values. (e.g. outlander)
Vehicle Generation refers to the life cycle of a design for a specific make and model. You can use GET /generations/ to get a list of available slug values. (e.g. 18d10dc6e6)
Maximum number of items to return (default 100, max 1000).
Number of items to skip before collecting the result set.
Response
Changes
- info
endpoint added
- info