Drill down into a generation: per-vehicle modifications with OEM specs and fitment deltas
Changed onGiven a specific generation from the by_rim/search/ hierarchy, returns individual trims/modifications with their OEM wheel specs and per-vehicle fitment data.
Each result includes the vehicle's OEM rim and tire specs, frontspace/backspace in mm, and deltas showing how much the searched rim differs from the OEM fitment. When cb (centre bore) is provided, cb_diff_mm shows the hub bore difference.
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
Bolt pattern is expressed as the number of lugs by the diameter of an imaginary circle formed by the centers of the wheel lugs. You can use GET /by_rim/bp/ to get a list of available value values. (e.g. 5x114.3)
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)
Rim width is the distance measured in inches from bead seat to bead seat. You can use GET /by_rim/rw/ to get a list of available value values. (e.g. 7.5)
Rim offset is a distance between wheel mounting surface where it is bolted to hub and the centerline of rim. You can use GET /by_rim/of/ to get a list of available value values. (e.g. 38)
Centre bore value, mm (e.g. 60)
The fd parameter represents the diameter of the wheel fastener threads, measured in millimeters (mm). This parameter is essential for ensuring a secure fit of the wheel's bolts or lug nuts. For a list of possible values and additional details, please refer to the Thread Size ISO and UN Series Glossary on Wheel-Size.com. (e.g. 14)
Frontspace poke tolerance in mm. 0 = exact or safer only (no poke). Default: 2. (e.g. 2)
Backspace push tolerance in mm. 0 = exact or safer only (no push). Default: 2. (e.g. 2)
[Deprecated] Mapped to bs_push. Use bs_push instead.
[Deprecated] Safe direction is now uncapped. Mapped to bs_push if sent alone. Use fs_poke/bs_push instead.
Percentage adjustment for the overall diameter tolerance range (0–5%), where default is 1%.
Percentage adjustment for the overall width tolerance range (0–3%), where default is 0%.
Widen rim diameter search window by ±N inches. 0 = exact match only. Default: 0.
Sort order: name (A-Z), fitment (closest FS delta), load (heaviest first).
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
queryrequest parameterrim_bst_fromwas deprecated - info
queryrequest parameterrim_bst_towas deprecated
- info
- breaking
the response property
//became nullable for the status - breaking
the response property
//became nullable for the status - breaking
the response property
//became nullable for the status - warning
deleted the
queryrequest parameterordering
- breaking