---
title: "Search by model"
method: GET
path: "/v2/search/by_model/"
tags: ["Search By Model"]
---

# Search by model

`GET /v2/search/by_model/`

Returns all modifications for the provided *`make`*, *`model`*, *`year`*, *`generation`*, *`modification`* or *`region`* parameters.
Please note that the search query provides access to wheel fitment data.

In addition to the required parameters, there are restrictions on the combination of parameters.
You need to provide:
1. *`make`* parameter;
2. *`model`* parameter;
3. at least one of the following parameters: *`modification`* or *`region`*;
4. at least one of the following parameters: *`year`* or *`generation`* — not required when *`modification`* is provided.

## Query parameters

- `make` string, required
- `model` string, required
- `year` integer
- `generation` string
- `modification` string
- `region` 'usdm' | 'cdm' | 'mxndm' | 'ladm' | 'eudm' | 'russia' | 'jdm' | 'chdm' | 'skdm' | 'sam' | 'medm' | 'nadm' | 'sadm' | 'audm'
- `lang` string
- `add_configurator` boolean
- `ordering` string
- `limit` integer
- `offset` integer

## Response `200`

- SearchByModelReportOutput
  - `data` SearchByModelData[], required
    - `slug` string, required — Identifier for the element. Value is a hash based on ID
    - `name` string, required — Trim name. It may be empty for models made for the Japanese region. (e.g. `2.4i`, can be __*`null`*__)
    - `body` string, required — Body name. It is widespread in the Japanese region. (e.g. `DBA-GF8W`, can be __*`null`*__)
    - `trim` string, required — Trim name. It may be empty for models made for the Japanese region. (e.g. `2.4i`, can be __*`null`*__)
    - `trim_scoring` number, double, nullable — Relevance score is calculated based on the computing a 'trim' similarity score A Relevance score between 0 and 100, with 100 being the highest. (e.g. `84.4`, can be __*`null`*__)
    - `trim_attributes` string, required — Trim attributes (e.g. `AWD`, can be __*`empty array`*__)
    - `trim_body_types` string, required — Trim body types (e.g. `Convertible`, can be __*`empty array`*__)
    - `trim_levels` string, required — Trim Levels (e.g. `EX-L, Touring, Executive`, can be __*`empty array`*__)
    - `make` MakesDataBase, required
      - `slug` string, required — Manufacturer slug name (e.g. `mitsubishi`)
      - `name` string, required — Manufacturer name (e.g. `Mitsubishi`)
      - `name_en` string, required — Original english name. Use it along with _**`lang`**_ query parameter
    - `model` ModelsDataBase, required
      - `slug` string, required — Model slug name (e.g. `outlander`)
      - `name` string, required — Model name (e.g. `Outlander`)
      - `name_en` string, required — Original english name. Use it along with _**`lang`**_ query parameter
    - `generation` Generation, required
      - `slug` string, required
      - `name` string, required
      - `platform` string, required
      - `start` integer, required
      - `end` integer, required
      - `bodies` Body[], required
        - `slug` string, required
        - `name` string, required
        - `image` string, required — Body image (can be __*`null`*__)
    - `start_year` integer, required
    - `end_year` integer, required
    - `engine` Engine, required
      - `fuel` string — Fuel (e.g. `Petrol`, can be __*`null`*__)
      - `capacity` string, required — Engine capacity (e.g. `3.5`, can be __*`null`*__)
      - `type` string, required — Engine type (e.g. `V8`, can be __*`null`*__)
      - `power` Power, required
        - `kW` number, double — kW - Kilowatts (e.g. `882.6`)
        - `PS` integer — PS - Metric horsepower (e.g. `1200`)
        - `hp` integer — hp - Mechanical horsepower (e.g. `1184`)
      - `code` string, required — Engine code (e.g. `D5244T`, can be __*`null`*__)
    - `regions` string, required
    - `technical` Technical, required
      - `wheel_fasteners` WheelFasteners, required
        - `type` string, required — Wheel Fasteners (e.g. `Nut`, can be __*`null`*__)
        - `thread_size` string, required — Thread Size (e.g. `M12 x 1.5`, can be __*`null`*__)
      - `wheel_tightening_torque` string, required — Torque value or range (e.g. `125 Nm`, can be __*`null`*__)
      - `stud_holes` integer, required — Number of stud holes (e.g. `5`, can be __*`null`*__)
      - `pcd` number, double, required — Pitch circle diameter, mm (e.g. `114.3`, can be __*`null`*__)
      - `centre_bore` string, required — Centre bore diameter, mm (e.g. `64.1`, can be __*`N/A`*__)
      - `bolt_pattern` string, required — Bolt pattern (e.g. `5x105`, can be __*`N/A`*__)
      - `rear_axis_stud_holes` integer, required — Number of stud holes (e.g. `5`, can be __*`null`*__)
      - `rear_axis_pcd` number, double, required — Pitch circle diameter, mm (e.g. `114.3`, can be __*`null`*__)
      - `rear_axis_centre_bore` number, double, required — Centre bore diameter, mm (e.g. `64.1`, can be __*`null`*__)
      - `rear_axis_bolt_pattern` string, required — Bolt pattern (e.g. `5x105`, can be __*`N/A`*__)
    - `tire_type` string, required — Tire type to mount on that car (can be __*`null`*__)
    - `wheels` WheelPair[], required
      - `is_stock` boolean, required — Original Equipment (OE)
      - `showing_fp_only` boolean, required — Show front pair only
      - `is_extra_load_tires` boolean, required — Extra Load tires (XL)
      - `is_high_load_tires` boolean, required — High Load tires (HL)
      - `is_recommended_for_winter` boolean, required — Recommended for winter use
      - `is_runflat_tires` boolean, required — Run-flat tires
      - `is_pressed_steel_rims` boolean, required — Pressed steel rims
      - `front` Wheel, required — Serializer for handling front wheel data, including tire pressure and various dimensions.
        - `rim` string, required — Formatter rim size (e.g. `7Jx18 ET38`, can be __*`""`*__)
        - `rim_diameter` number, double, required — Rim diameter, in (e.g. `18.0`, can be __*`null`*__)
        - `rim_width` number, double, required — Rim width, in (e.g. `7.0`, can be __*`null`*__)
        - `rim_offset` number, double, required — Rim offset, mm (e.g. `38.0`, can be __*`null`*__)
        - `tire_full` string, required — Formatted tire size (e.g. `225/55R18`, can be __*`""`*__)
        - `tire` string, required — Formatted tire size (e.g. `225/55R18`, can be __*`""`*__)
        - `load_index` integer — Load index (e.g. `98`, can be __*`null`*__)
        - `speed_index` string — Speed rating (e.g. `H`, can be __*`null`*__)
        - `tire_pressure` string, required — Tire pressure in different units (can be __*`null`*__)
        - `tire_sizing_system` 'metric' | 'numeric' | 'flotation' | 'lt-metric' | 'lt-numeric' | 'slick' | 'alpha-numeric', required — * `metric` - Metric * `numeric` - Numeric * `flotation` - Light Truck High Flotation * `lt-metric` - Light Truck Metric * `lt-numeric` - Light Truck Numeric * `slick` - Racing Slick * `alpha-numeric` - Alpha Numeric
        - `tire_construction` union, required — Tire construction code (e.g. `R`, can be __*`null`*__) * `R` - Radial (Radial-ply) * `B` - Bias Belt (Bias-belted) * `D` - Diagonal (Cross-ply) * `` - Ordinary Bias (Bias-ply)
          - 'R' | 'B' | 'D' — * `R` - Radial (Radial-ply) * `B` - Bias Belt (Bias-belted) * `D` - Diagonal (Cross-ply) * `` - Ordinary Bias (Bias-ply)
          - ''
        - `tire_width` number, double, required — Tire width, mm (e.g. `225.0`, can be __*`null`*__)
        - `tire_aspect_ratio` number, double, required — Aspect ratio, % (e.g. `55.0`, can be __*`null`*__)
        - `tire_diameter` number, double, required — High flotation tire diameter, in (e.g. `31.0`, can be __*`null`*__)
        - `tire_section_width` number, double, required — High flotation section width, in (e.g. `10.5`, can be __*`null`*__)
        - `tire_is_82series` boolean, required — Is an old tire with assumed aspect ratio 82%
        - `tire_alpha_numeric` string, required — Alpha-numeric size for the front tire (can be __*`null`*__)
        - `tire_width_mm` integer, required — Front tire width in millimeters
        - `tire_diameter_mm` integer, required — Front tire overall diameter in millimeters
        - `tire_weight_kg` number, double, required — Front tire weight in kilograms
      - `rear` Wheel, required — Serializer for handling front wheel data, including tire pressure and various dimensions.
        - `rim` string, required — Formatter rim size (e.g. `7Jx18 ET38`, can be __*`""`*__)
        - `rim_diameter` number, double, required — Rim diameter, in (e.g. `18.0`, can be __*`null`*__)
        - `rim_width` number, double, required — Rim width, in (e.g. `7.0`, can be __*`null`*__)
        - `rim_offset` number, double, required — Rim offset, mm (e.g. `38.0`, can be __*`null`*__)
        - `tire_full` string, required — Formatted tire size (e.g. `225/55R18`, can be __*`""`*__)
        - `tire` string, required — Formatted tire size (e.g. `225/55R18`, can be __*`""`*__)
        - `load_index` integer — Load index (e.g. `98`, can be __*`null`*__)
        - `speed_index` string — Speed rating (e.g. `H`, can be __*`null`*__)
        - `tire_pressure` string, required — Tire pressure in different units (can be __*`null`*__)
        - `tire_sizing_system` 'metric' | 'numeric' | 'flotation' | 'lt-metric' | 'lt-numeric' | 'slick' | 'alpha-numeric', required — * `metric` - Metric * `numeric` - Numeric * `flotation` - Light Truck High Flotation * `lt-metric` - Light Truck Metric * `lt-numeric` - Light Truck Numeric * `slick` - Racing Slick * `alpha-numeric` - Alpha Numeric
        - `tire_construction` union, required — Tire construction code (e.g. `R`, can be __*`null`*__) * `R` - Radial (Radial-ply) * `B` - Bias Belt (Bias-belted) * `D` - Diagonal (Cross-ply) * `` - Ordinary Bias (Bias-ply)
          - 'R' | 'B' | 'D' — * `R` - Radial (Radial-ply) * `B` - Bias Belt (Bias-belted) * `D` - Diagonal (Cross-ply) * `` - Ordinary Bias (Bias-ply)
          - ''
        - `tire_width` number, double, required — Tire width, mm (e.g. `225.0`, can be __*`null`*__)
        - `tire_aspect_ratio` number, double, required — Aspect ratio, % (e.g. `55.0`, can be __*`null`*__)
        - `tire_diameter` number, double, required — High flotation tire diameter, in (e.g. `31.0`, can be __*`null`*__)
        - `tire_section_width` number, double, required — High flotation section width, in (e.g. `10.5`, can be __*`null`*__)
        - `tire_is_82series` boolean, required — Is an old tire with assumed aspect ratio 82%
        - `tire_alpha_numeric` string, required — Alpha-numeric size for the front tire (can be __*`null`*__)
        - `tire_width_mm` integer, required — Front tire width in millimeters
        - `tire_diameter_mm` integer, required — Front tire overall diameter in millimeters
        - `tire_weight_kg` number, double, required — Front tire weight in kilograms
    - `configurator` string, required
  - `meta` SearchByModelMeta, required
    - `count` integer, required — total rows
    - `offset` integer, required — pagination offset
    - `limit` integer, required — pagination limit
    - `regions` string, required

---

[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-service-production.skmtc.workers.dev/v1/apis/wheel-size/wheel-fitment-api/revisions/8b6863e8004e/schema)
