Search By Model

List modifications

Changed on

Returns all modifications for the provided make, model, year or generation parameters. Please note that you need to specify at least one of the following parameters: year or generation.

All array parameters can have multiple values. For example, region=eudm&region=usdm.

get/v2/modifications/

Request

Query parameters

makestring required
Example:mitsubishi

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)

modelstring required
Example:outlander

The particular Model of the brand. You can use GET /models/ to get a list of available slug values. (e.g. outlander)

yearinteger

You can use GET /years/ to get a list of available slug values. (e.g. 2015)

generationstring

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)

regionstring[]

A Region is the region where the car was officially sold or is still being sold. You can use GET /regions/ to get a list of available slug values. (e.g. usdm)

langstring

Use this parameter to get translations for the fields of the following objects: Make, Model, Region. The field name_en always has the original English name. By default en language is used. Currently, translation works in Chinese (zh-cn) and Japanese (ja) languages only.

fuel'biodiesel_blend' | 'cng' | 'diesel' | 'e100' | 'electric' | 'ethanol_blend' | 'flex_fuel' | 'h2' | 'hybrid' | 'lpg' | 'petrol' | 'petrol_cng' | 'petrol_lpg'

Engine Fuel. Matches the legacy engine.fuel value or either fuel axis, so ?fuel=ethanol_blend finds the Flex-Fuel vehicles that can burn it, and ?fuel=lpg returns dedicated-LPG and petrol/LPG bi-fuel vehicles alike. Values are Fuel.code — the same code returned by powertrain.primary_fuel.code, so a response value pastes straight back into a query. Historical spellings (flex-fuel, natural-gas, hydrogen, e85, b20…) are still accepted. (e.g. diesel)

horsepowernumber double

Horsepower value (1hp = 550 ft⋅lbf/s), hp. If defined, the search will be performed within the range of ±2.7hp Matches the headline power figure, whose source depends on the electrification level — not always the combined system total, and not always the combustion engine (see power). (e.g. 150)

horsepower_minnumber double

Minimum horsepower value, hp. Matches the headline power figure, whose source depends on the electrification level — not always the combined system total, and not always the combustion engine (see power). (e.g. 125)

horsepower_maxnumber double

Maximum horsepower value, hp. Matches the headline power figure, whose source depends on the electrification level — not always the combined system total, and not always the combustion engine (see power). (e.g. 225)

trimstring

Provides a non-strict search by engine/trim name. (e.g. ('2.0 PHEV', '2.0 TDI SCR BlueMotion 4Motion')) Typically used for integration with other systems (i.e. search by license plate). To narrow down your results use fuel and/or horsepower filters.

trim_levelstring

Provides a case-insensitive search by trim level. (e.g. EX-L, Touring, Executive)

orderingstring

Comma-separated list without spaces. Supported field names: trim, start_year, end_year

Response

Changes

    • breaking

      removed the enum value ethanol from the query request parameter fuel

    • breaking

      removed the enum value flex-fuel from the query request parameter fuel

    • breaking

      removed the enum value hydrogen from the query request parameter fuel

    • breaking

      removed the enum value natural-gas from the query request parameter fuel

    • breaking

      removed the enum value petrol-lpg from the query request parameter fuel

    • breaking

      removed the enum value petrol-natural-gas from the query request parameter fuel

    • info

      added the new enum value biodiesel_blend to the query request parameter fuel

    • info

      added the new enum value cng to the query request parameter fuel

    • info

      added the new enum value e100 to the query request parameter fuel

    • info

      added the new enum value ethanol_blend to the query request parameter fuel

    • info

      added the new enum value flex_fuel to the query request parameter fuel

    • info

      added the new enum value h2 to the query request parameter fuel

    • info

      added the new enum value petrol_cng to the query request parameter fuel

    • info

      added the new enum value petrol_lpg to the query request parameter fuel

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status