---
title: "Generate Product Card with Vehicle Compatibility for Rim"
method: GET
path: "/v2/classified/by_rim/search/"
tags: ["Classified methods"]
---

# Generate Product Card with Vehicle Compatibility for Rim

`GET /v2/classified/by_rim/search/`

## Request

- Base URL: `https://api.wheel-size.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wheel-size.com/v2/classified/by_rim/search/`
- Auth: API key in query parameter `user_key`
- TypeScript: <https://skmtc.dev/wheel-size/apis/wheel-fitment-api/docs/v2/classified/by_rim/search/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint generates the product card for a specific rim, providing compatibility information about various vehicles. The output includes vehicle make, model, generation, and production years, which allows clients to enrich the product page by displaying compatible vehicle options where the rim can be installed.

**2D Frontspace/Backspace filtering:** Compatibility is determined using a 2D geometric filter on both frontspace (hub-to-outer-lip) and backspace (hub-to-inner-lip). OEM wheel pairs must have FS and BS greater than or equal to the searched rim's values minus the tolerance (`fs_poke` / `bs_push` in mm). The safe direction (more tuck for FS, more retract for BS) is uncapped.

Each result includes `fs_delta_mm` (positive = poke toward fender) and `bs_delta_mm` (positive = deeper toward suspension) showing how much the searched rim differs from the OEM fitment.

Note that in some cases, additional components such as spacers or special bolts/nuts may be required for proper installation. It is recommended to check fitment by placing the rims on the vehicle and verifying they do not interfere with the brake caliper or extend beyond the wheel arch.

## Query parameters

- `bolt_pattern` string, required
- `rim_diameter` number, double, required
- `rim_width` number, double, required
- `rim_offset` number, double, required
- `cb` number, double
- `fd` number, double
- `fs_poke` integer
- `bs_push` integer
- `rim_bst_from` integer
- `rim_bst_to` integer
- `od_tolerance` number, double
- `ow_tolerance` number, double
- `diameter_range` integer
- `sort` 'name' | 'fitment' | 'load'
- `ordering` string
- `limit` integer
- `offset` integer

## Response `200`

- GenerationsByRimReportOutput
  - `data` GenerationData[], required
    - `model` ClassifiedCar, required
      - `make` ClassifiedMake, required
        - `slug` string, required
        - `name` string, required
        - `name_en` string, required: Original english name. Use it along with _**`lang`**_ query parameter
      - `slug` string, required
      - `name` string, required
      - `name_en` string, required: Original english name. Use it along with _**`lang`**_ query parameter
    - `slug` string, required
    - `name` string, required
    - `year_ranges` string, required
    - `regions` unknown[], required
      - unknown
    - `min_fs_delta_mm` number, double, required: Min frontspace delta vs OEM, mm. Positive = pokes toward fender.
    - `max_fs_delta_mm` number, double, required: Max frontspace delta vs OEM, mm.
    - `min_bs_delta_mm` number, double, required: Min backspace delta vs OEM, mm. Positive = pushes toward suspension.
    - `max_bs_delta_mm` number, double, required: Max backspace delta vs OEM, mm.
    - `min_oem_fs_ratio` number, double, nullable, required: Min OEM frontspace ratio.
    - `max_oem_fs_ratio` number, double, nullable, required: Max OEM frontspace ratio.
    - `min_oem_fs_bs_ratio` number, double, nullable, required: Min OEM FS/BS ratio.
    - `max_oem_fs_bs_ratio` number, double, nullable, required: Max OEM FS/BS ratio.
    - `max_oem_frontspace_mm` number, double, nullable, required: Max OEM frontspace, mm.
    - `max_load_kg` number, double, nullable, required: Max load capacity, kg.
    - `max_load_index` integer, nullable, required: Max load index value.
    - `cb_diff_mm` number, double, nullable, required: Centre bore difference, mm (null when cb not provided).
    - `backspace_difference_mm` number, double, required: [Deprecated] Use min/max fs/bs delta fields instead.
    - `backspace_difference_percent` number, double, required: [Deprecated] Use min/max fs/bs delta fields instead.
  - `meta` ClassifiedMeta, required
    - `count` integer, required
    - `offset` integer, required
    - `limit` integer, required

## Changes

- **2026-09-18** `dd21f21710f3`: 2 info
  - `query` request parameter `rim_bst_from` was deprecated
  - `query` request parameter `rim_bst_to` was deprecated

[Operation history](https://skmtc.dev/wheel-size/apis/wheel-fitment-api/changes/v2/classified/by_rim/search/get.md)

---

[API](https://skmtc.dev/wheel-size/apis/wheel-fitment-api.md) - [All operations](https://skmtc.dev/wheel-size/apis/wheel-fitment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wheel-size/apis/wheel-fitment-api/revisions/0283a9f8acf0?raw)