WHwheel-size
Classified methods

Generate Product Card with Vehicle Compatibility for Package (Rim + Tire)

Changed on

This endpoint allows users to retrieve a list of vehicles that are compatible with a specific combination of wheel and tire specifications—referred to as a package. By providing detailed parameters such as bolt pattern, rim dimensions, tire dimensions, center bore, and fastener diameter, users can obtain a comprehensive list of vehicle models where this package can be installed. The output includes: Vehicle Make and Model, Generation, Production Years. This information enables clients to enhance product pages by displaying potential vehicles that can utilize the specified wheel and tire package, assisting customers in making informed purchasing decisions. Unlike other Classified endpoints, this method considers both wheel and tire specifications together, providing a more accurate compatibility list based on technical calculations.

Technical Fitment Calculations: Utilizes advanced calculations, including wheel backspacing and tire dimensions, to ensure the package fits within the physical constraints of the vehicle's wheel housing and suspension components. Additional Components May Be Required: In some cases, installing the package may necessitate additional components such as spacers or specialized bolts/nuts to achieve proper fitment.

get/v2/classified/by_package/search/

Request

Query parameters

bolt_patternstring required
Example:5x114.3

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_diameternumber double required
Example:18

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_widthnumber double required
Example:7.5

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_offsetnumber double required
Example:35

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)

cbnumber double

Centre bore value, mm (e.g. 60)

fdnumber double

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)

fs_pokeinteger

Frontspace poke tolerance in mm. 0 = exact or safer only (no poke). Default: 2. (e.g. 2)

bs_pushinteger

Backspace push tolerance in mm. 0 = exact or safer only (no push). Default: 2. (e.g. 2)

rim_bst_frominteger

[Deprecated] Mapped to bs_push. Use bs_push instead.

rim_bst_tointeger

[Deprecated] Safe direction is now uncapped. Mapped to bs_push if sent alone. Use fs_poke/bs_push instead.

od_tolerancenumber double

Overall diameter tolerance as a decimal fraction (0–0.05). Default: 0.01 (1%). (e.g. 0.01)

ow_tolerancenumber double

Overall width tolerance as a decimal fraction (0–0.03). Default: 0 (0%).

diameter_rangeinteger

Widen rim diameter search window by ±N inches. 0 = exact match only. Default: 0.

sort'name' | 'fitment' | 'load'

Sort order for results.

  • name — alphabetical by make/model (default)
  • fitment — closest frontspace delta first
  • load — heaviest load capacity first (nulls last) (e.g. name)
section_widthinteger required
Example:235

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)

aspect_ratiointeger required
Example:60

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)

orderingstring

Comma-separated list without spaces. Supported field names: make, model

limitinteger

Maximum number of items to return (default 100, max 1000).

offsetinteger

Number of items to skip before collecting the result set.

Response

Changes

  • dd21f21710f3Revision changes
    • info

      query request parameter rim_bst_from was deprecated

    • info

      query request parameter rim_bst_to was deprecated