Wheel Size Widget

{"swagger": "2.0", "info": {"title": "Wheel Fitment API", "description": "The Wheel Fitment API allows for programmatic access to the database of www.wheel-size.com and its services.\nUse this API to retrieve information about vehicle fitment database for rims and tires, including OE and option fitments, and plus/minus sizing fitment information. A variety of country and language specific options are available. The coverage of fitment data for vehicles manufactured since 2000 is nearly 100%.\n\nThe information about fitment data is updated on a daily basis.", "termsOfService": "https://www.wheel-size.com/privacy-policy/", "contact": {"email": "info@wheel-size.com"}, "version": "v1"}, "host": "api.wheel-size.com", "schemes": ["https"], "basePath": "/v1", "produces": ["application/json"], "securityDefinitions": {"user_key": {"description": "Your access token. [Get your API key](https://developer.wheel-size.com/signup?plan_ids%5B%5D=2357355811171)", "type": "apiKey", "name": "user_key", "in": "query"}}, "security": [{"user_key": []}], "paths": {"/bolt-patterns/": {"get": {"operationId": "bolt-patterns_list", "description": "A list of possible bolt patterns with the number of matching model modifications", "parameters": [{"name": "stud", "in": "query", "description": "Number of stud holes (e.g. `5`)", "type": "number"}, {"name": "stud_min", "in": "query", "description": "Lower bound for number of stud holes (e.g. `4`)", "type": "number"}, {"name": "stud_max", "in": "query", "description": "Upper bound for number of stud holes (e.g. `7`)", "type": "number"}, {"name": "pcd", "in": "query", "description": "Pitch circle diameter, mm (e.g. `115`)", "type": "number"}, {"name": "pcd_min", "in": "query", "description": "Lower bound for pitch circle diameter, mm (e.g. `105`)", "type": "number"}, {"name": "pcd_max", "in": "query", "description": "Upper bound for pitch circle diameter, mm (e.g. `135`)", "type": "number"}, {"name": "brands", "in": "query", "description": "Show information only for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `mitsubishi,nissan,toyota`)", "type": "string"}, {"name": "brands_exclude", "in": "query", "description": "Don't show information for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `geely,great-wall`)", "type": "string"}, {"name": "countries", "in": "query", "description": "Show information for local manufacturers from specified countries only.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `us,gb,jp`)", "type": "string"}, {"name": "countries_exclude", "in": "query", "description": "Don't show information for local manufacturers from specified countries.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `ru,ua`)", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/BoltPattern"}}}}, "tags": ["bolt-patterns"], "summary": "Get list of bolt patterns", "deprecated": false}, "parameters": []}, "/bolt-patterns/{bolt_pattern}/": {"get": {"operationId": "bolt-patterns_read", "description": "Get a list of model modifications matching to the given bolt pattern", "parameters": [{"name": "bolt_pattern", "in": "path", "description": "Bolt pattern combines number of stud holes and pitch circle diameter.\nUse _**`GET /bolt-patterns/`**_ to get possible values (e.g. `5x105`)", "required": true, "type": "string", "x-example": "5x105"}, {"name": "rim_diameter", "in": "query", "description": "Rim diameter, in (e.g. `16`)", "type": "number"}, {"name": "rim_width", "in": "query", "description": "Rim width, in (e.g. `7`)", "type": "number"}, {"name": "offset", "in": "query", "description": "Rim offset, mm (e.g. `40`)", "type": "number"}, {"name": "offset_min", "in": "query", "description": "Lower bound for rim offset, mm (e.g. `35`)", "type": "number"}, {"name": "offset_max", "in": "query", "description": "Upper bound for rim offset, mm (e.g. `45`)", "type": "number"}, {"name": "cb", "in": "query", "description": "Centre bore value, mm (e.g. `60`)", "type": "number"}, {"name": "cb_min", "in": "query", "description": "Lower bound for centre bore value, mm (e.g. `55`)", "type": "number"}, {"name": "cb_max", "in": "query", "description": "Upper bound for centre bore value, mm (e.g. `65`)", "type": "number"}, {"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}, {"name": "brands", "in": "query", "description": "Show information only for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `mitsubishi,nissan,toyota`)", "type": "string"}, {"name": "brands_exclude", "in": "query", "description": "Don't show information for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `geely,great-wall`)", "type": "string"}, {"name": "countries", "in": "query", "description": "Show information for local manufacturers from specified countries only.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `us,gb,jp`)", "type": "string"}, {"name": "countries_exclude", "in": "query", "description": "Don't show information for local manufacturers from specified countries.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `ru,ua`)", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/MakeWithModels"}}}}, "tags": ["bolt-patterns"], "summary": "Model modifications by bolt pattern", "deprecated": false}, "parameters": [{"name": "bolt_pattern", "in": "path", "required": true, "type": "string"}]}, "/countries/": {"get": {"operationId": "countries_list", "description": "List of possible countries to be used in any other API method.\nIndended to be used in case you want to restrict results for several countries.", "parameters": [], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/Country"}}}}, "tags": ["countries"], "summary": "Returns a list of countries", "deprecated": false}, "parameters": []}, "/generations/": {"get": {"operationId": "generations_list", "description": "Get a list of generations for the given model. It is possible to retrieve generations for specific year.", "parameters": [{"name": "make", "in": "query", "description": "Manufacturer slug name, use _**`GET /makes/`**_ to get possible values (e.g. `mitsubishi`)", "required": true, "type": "string", "x-example": "mitsubishi"}, {"name": "model", "in": "query", "description": "Model slug name, use _**`GET /models/`**_ to get possible values (e.g. `outlander`)", "required": true, "type": "string", "x-example": "outlander"}, {"name": "year", "in": "query", "description": "You can use _**`GET /years/`**_ to get possible years (e.g. `2015`)", "type": "integer"}, {"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/GenerationWithMakeAndModel"}}}}, "tags": ["generations"], "summary": "Generations for the given model", "deprecated": false}, "parameters": []}, "/makes/": {"get": {"operationId": "makes_list", "description": "Get a list of all manufacturers", "parameters": [{"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}, {"name": "brands", "in": "query", "description": "Show information only for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `mitsubishi,nissan,toyota`)", "type": "string"}, {"name": "brands_exclude", "in": "query", "description": "Don't show information for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `geely,great-wall`)", "type": "string"}, {"name": "countries", "in": "query", "description": "Show information for local manufacturers from specified countries only.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `us,gb,jp`)", "type": "string"}, {"name": "countries_exclude", "in": "query", "description": "Don't show information for local manufacturers from specified countries.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `ru,ua`)", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/Make"}}}}, "tags": ["makes"], "summary": "Returns a list of manufacturers", "deprecated": false}, "parameters": []}, "/markets/": {"get": {"operationId": "markets_list", "description": "Get a list of possible markets (regions)", "parameters": [{"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/Market"}}}}, "tags": ["markets"], "summary": "Returns a list of markets/regions", "deprecated": false}, "parameters": []}, "/models/": {"get": {"operationId": "models_list", "description": "Get a list of models that match given manufacturer and year (if present)", "parameters": [{"name": "make", "in": "query", "description": "Manufacturer slug name, use _**`GET /makes/`**_ to get possible values (e.g. `mitsubishi`)", "required": true, "type": "string", "x-example": "mitsubishi"}, {"name": "year", "in": "query", "description": "You can use _**`GET /years/`**_ to get possible years (e.g. `2015`)", "type": "integer"}, {"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/Model"}}}}, "tags": ["models"], "summary": "Returns a list of models by manufacturer", "deprecated": false}, "parameters": []}, "/models/{make}/{slug}/": {"get": {"operationId": "models_read", "description": "Get the detailed information about model series", "parameters": [{"name": "make", "in": "path", "description": "Manufacturer slug name, use _**`GET /makes/`**_ to get possible values (e.g. `mitsubishi`)", "required": true, "type": "string", "x-example": "mitsubishi"}, {"name": "slug", "in": "path", "description": "Model slug name, use _**`GET /models/`**_ to get possible values (e.g. `outlander`)", "required": true, "type": "string", "x-example": "outlander"}, {"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}], "responses": {"200": {"description": "", "schema": {"$ref": "#/definitions/ModelWithTires"}}}, "tags": ["models"], "summary": "Get more info about model", "deprecated": true}, "parameters": [{"name": "make", "in": "path", "required": true, "type": "string"}, {"name": "slug", "in": "path", "required": true, "type": "string"}]}, "/models/{make}/{slug}/{year}/": {"get": {"operationId": "models_read_year", "description": "", "parameters": [{"name": "make", "in": "path", "description": "Manufacturer slug name, use _**`GET /makes/`**_ to get possible values (e.g. `mitsubishi`)", "required": true, "type": "string", "x-example": "mitsubishi"}, {"name": "slug", "in": "path", "description": "Model slug name, use _**`GET /models/`**_ to get possible values (e.g. `outlander`)", "required": true, "type": "string", "x-example": "outlander"}, {"name": "year", "in": "path", "description": "You can use _**`GET /years/`**_ to get possible years (e.g. `2015`)", "required": true, "type": "integer", "x-example": 2015}, {"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}], "responses": {"200": {"description": "", "schema": {"$ref": "#/definitions/ModelWithTires"}}}, "tags": ["models"], "summary": "Get more info about model/year", "deprecated": true}, "parameters": [{"name": "make", "in": "path", "required": true, "type": "string"}, {"name": "slug", "in": "path", "required": true, "type": "string"}, {"name": "year", "in": "path", "required": true, "type": "string"}]}, "/search/by_hf_tire/": {"get": {"operationId": "search_by_hf_tire_list", "description": "Get a list of model modifications that match the given tire size in high flotation sizing system", "parameters": [{"name": "tire_diameter", "in": "query", "description": "Tire diameter, in (e.g. `31`)", "required": true, "type": "number", "x-example": 31}, {"name": "tire_section_width", "in": "query", "description": "Tire section width, in (e.g. `10.5`)", "required": true, "type": "number", "x-example": 10.5}, {"name": "rim_diameter_hf", "in": "query", "description": "Rim diameter, in (e.g. `15`)", "required": true, "type": "number", "x-example": 15}, {"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}, {"name": "brands", "in": "query", "description": "Show information only for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `mitsubishi,nissan,toyota`)", "type": "string"}, {"name": "brands_exclude", "in": "query", "description": "Don't show information for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `geely,great-wall`)", "type": "string"}, {"name": "countries", "in": "query", "description": "Show information for local manufacturers from specified countries only.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `us,gb,jp`)", "type": "string"}, {"name": "countries_exclude", "in": "query", "description": "Don't show information for local manufacturers from specified countries.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `ru,ua`)", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/MakeWithModels"}}}}, "tags": ["search"], "summary": "Find models matching given high flotation tire", "deprecated": false}, "parameters": []}, "/search/by_model/": {"get": {"operationId": "search_by_model_list", "description": "Find OE and option fitments that match the given manufacturer, model, year and trim.\n\n**It's an alias** for _**`GET /vehicles/`**_ method", "parameters": [{"name": "make", "in": "query", "description": "Manufacturer slug name, use _**`GET /makes/`**_ to get possible values (e.g. `mitsubishi`)", "required": true, "type": "string", "x-example": "mitsubishi"}, {"name": "model", "in": "query", "description": "Model slug name, use _**`GET /models/`**_ to get possible values (e.g. `outlander`)", "required": true, "type": "string", "x-example": "outlander"}, {"name": "year", "in": "query", "description": "You can use _**`GET /years/`**_ to get possible years (e.g. `2015`)", "required": true, "type": "integer", "x-example": 2015}, {"name": "trim", "in": "query", "description": "Use *`slug`* from _**`GET /trims/`**_ methods here. (e.g. `20-dla-gg2w-iii-restyling`)", "type": "string"}, {"name": "only_oem", "in": "query", "description": "Show only original equipment wheels", "type": "boolean"}, {"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/Vehicle"}}}}, "tags": ["search"], "summary": "Find OE and option fitments by model/year/trim", "deprecated": false}, "parameters": []}, "/search/by_rim/": {"get": {"operationId": "search_by_rim_list", "description": "Get a list of model modifications that match the given rim parameters, grouped by manufacturer.\n\nIt's an alias for _**`GET /bolt-patterns/{bolt_pattern}/`**_ method with given path and query parameters.", "parameters": [{"name": "bolt_pattern", "in": "query", "description": "Bolt pattern combines number of stud holes and pitch circle diameter.\nUse _**`GET /bolt-patterns/`**_ to get possible values (e.g. `5x105`)", "required": true, "type": "string", "x-example": "5x105"}, {"name": "rim_diameter", "in": "query", "description": "Rim diameter, in (e.g. `16`)", "required": true, "type": "number", "x-example": 16}, {"name": "rim_width", "in": "query", "description": "Rim width, in (e.g. `7`)", "required": true, "type": "number", "x-example": 7}, {"name": "offset", "in": "query", "description": "Rim offset, mm (e.g. `40`)", "type": "number"}, {"name": "offset_min", "in": "query", "description": "Lower bound for rim offset, mm (e.g. `35`)", "type": "number"}, {"name": "offset_max", "in": "query", "description": "Upper bound for rim offset, mm (e.g. `45`)", "type": "number"}, {"name": "cb", "in": "query", "description": "Centre bore value, mm (e.g. `60`)", "type": "number"}, {"name": "cb_min", "in": "query", "description": "Lower bound for centre bore value, mm (e.g. `55`)", "type": "number"}, {"name": "cb_max", "in": "query", "description": "Upper bound for centre bore value, mm (e.g. `65`)", "type": "number"}, {"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}, {"name": "brands", "in": "query", "description": "Show information only for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `mitsubishi,nissan,toyota`)", "type": "string"}, {"name": "brands_exclude", "in": "query", "description": "Don't show information for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `geely,great-wall`)", "type": "string"}, {"name": "countries", "in": "query", "description": "Show information for local manufacturers from specified countries only.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `us,gb,jp`)", "type": "string"}, {"name": "countries_exclude", "in": "query", "description": "Don't show information for local manufacturers from specified countries.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `ru,ua`)", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/MakeWithModels"}}}}, "tags": ["search"], "summary": "Find models matching given rim parameters", "deprecated": false}, "parameters": []}, "/search/by_tire/": {"get": {"operationId": "search_by_tire_list", "description": "Get a list of model modifications matching given tire, grouped by manufacturer.\n\nIt's an alias for _**`GET /tire/{tire}/`**_ method\n\n(tire configuration is combined of required tire width, aspect ratio and rim diameter).", "parameters": [{"name": "tire_width", "in": "query", "description": "Tire width, mm (e.g. `195`)", "required": true, "type": "number", "x-example": 195}, {"name": "aspect_ratio", "in": "query", "description": "Aspect ratio, % (e.g. `50`)", "required": true, "type": "number", "x-example": 50}, {"name": "rim_diameter", "in": "query", "description": "Rim diameter, in (e.g. `16`)", "required": true, "type": "number", "x-example": 16}, {"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}, {"name": "brands", "in": "query", "description": "Show information only for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `mitsubishi,nissan,toyota`)", "type": "string"}, {"name": "brands_exclude", "in": "query", "description": "Don't show information for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `geely,great-wall`)", "type": "string"}, {"name": "countries", "in": "query", "description": "Show information for local manufacturers from specified countries only.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `us,gb,jp`)", "type": "string"}, {"name": "countries_exclude", "in": "query", "description": "Don't show information for local manufacturers from specified countries.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `ru,ua`)", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/MakeWithModels"}}}}, "tags": ["search"], "summary": "Find models matching given tire parameters", "deprecated": false}, "parameters": []}, "/tires/": {"get": {"operationId": "tires_list", "description": "Get a list of tires with a number of matching model modifications", "parameters": [{"name": "width", "in": "query", "description": "Tire width, mm (e.g. `195`)", "type": "number"}, {"name": "width_min", "in": "query", "description": "Lower bound for tire width, mm (e.g. `165`)", "type": "number"}, {"name": "width_max", "in": "query", "description": "Upper bound for tire width, mm (e.g. `200`)", "type": "number"}, {"name": "aspect_ratio", "in": "query", "description": "Aspect ratio, % (e.g. `50`)", "type": "number"}, {"name": "aspect_ratio_min", "in": "query", "description": "Lower bound for aspect ratio, % (e.g. `30`)", "type": "number"}, {"name": "aspect_ratio_max", "in": "query", "description": "Upper bound for aspect ratio, % (e.g. `70`)", "type": "number"}, {"name": "rim_diameter", "in": "query", "description": "Rim diameter, in (e.g. `16`)", "type": "number"}, {"name": "rim_diameter_min", "in": "query", "description": "Lower bound for rim diameter, in (e.g. `13`)", "type": "number"}, {"name": "rim_diameter_max", "in": "query", "description": "Upper bound for rim diameter, in (e.g. `20`)", "type": "number"}, {"name": "brands", "in": "query", "description": "Show information only for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `mitsubishi,nissan,toyota`)", "type": "string"}, {"name": "brands_exclude", "in": "query", "description": "Don't show information for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `geely,great-wall`)", "type": "string"}, {"name": "countries", "in": "query", "description": "Show information for local manufacturers from specified countries only.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `us,gb,jp`)", "type": "string"}, {"name": "countries_exclude", "in": "query", "description": "Don't show information for local manufacturers from specified countries.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `ru,ua`)", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/Tire"}}}}, "tags": ["tires"], "summary": "Returns a list of tires", "deprecated": false}, "parameters": []}, "/tires/{tire}/": {"get": {"operationId": "tires_read", "description": "Get a list of model modifications by tire", "parameters": [{"name": "tire", "in": "path", "description": "Formatted tire size.\nUse _**`GET /tires/`**_ to get possible values (e.g. `195/50R15`)", "required": true, "type": "string", "x-example": "195/50R15"}, {"name": "width", "in": "query", "description": "Tire width, mm (e.g. `195`)", "type": "number"}, {"name": "width_min", "in": "query", "description": "Lower bound for tire width, mm (e.g. `165`)", "type": "number"}, {"name": "width_max", "in": "query", "description": "Upper bound for tire width, mm (e.g. `200`)", "type": "number"}, {"name": "aspect_ratio", "in": "query", "description": "Aspect ratio, % (e.g. `50`)", "type": "number"}, {"name": "aspect_ratio_min", "in": "query", "description": "Lower bound for aspect ratio, % (e.g. `30`)", "type": "number"}, {"name": "aspect_ratio_max", "in": "query", "description": "Upper bound for aspect ratio, % (e.g. `70`)", "type": "number"}, {"name": "rim_diameter", "in": "query", "description": "Rim diameter, in (e.g. `16`)", "type": "number"}, {"name": "rim_diameter_min", "in": "query", "description": "Lower bound for rim diameter, in (e.g. `13`)", "type": "number"}, {"name": "rim_diameter_max", "in": "query", "description": "Upper bound for rim diameter, in (e.g. `20`)", "type": "number"}, {"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}, {"name": "brands", "in": "query", "description": "Show information only for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `mitsubishi,nissan,toyota`)", "type": "string"}, {"name": "brands_exclude", "in": "query", "description": "Don't show information for specified manufacturers.\nUse _**`GET /makes/`**_ method to get the full list. (e.g. `geely,great-wall`)", "type": "string"}, {"name": "countries", "in": "query", "description": "Show information for local manufacturers from specified countries only.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `us,gb,jp`)", "type": "string"}, {"name": "countries_exclude", "in": "query", "description": "Don't show information for local manufacturers from specified countries.\nUse _**`GET /countries/`**_ method to get the full list of countries. (e.g. `ru,ua`)", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/MakeWithModels"}}}}, "tags": ["tires"], "summary": "Model modifications matching given tire", "deprecated": false}, "parameters": [{"name": "tire", "in": "path", "required": true, "type": "string"}]}, "/trims/": {"get": {"operationId": "trims_list", "description": "List of model modifications matching given manufacturer, model and year", "parameters": [{"name": "make", "in": "query", "description": "Manufacturer slug name, use _**`GET /makes/`**_ to get possible values (e.g. `mitsubishi`)", "required": true, "type": "string", "x-example": "mitsubishi"}, {"name": "model", "in": "query", "description": "Model slug name, use _**`GET /models/`**_ to get possible values (e.g. `outlander`)", "required": true, "type": "string", "x-example": "outlander"}, {"name": "year", "in": "query", "description": "You can use _**`GET /years/`**_ to get possible years (e.g. `2015`)", "required": true, "type": "integer", "x-example": 2015}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/Trim"}}}}, "tags": ["trims"], "summary": "Model modifications", "deprecated": false}, "parameters": []}, "/vehicles/": {"get": {"operationId": "vehicles_list", "description": "Find OE and option fitments that match the given manufacturer, model, year and trim.\n\nPlease use _**`GET /search/by_model/`**_ instead as it is deprecated at the current moment.", "parameters": [{"name": "make", "in": "query", "description": "Manufacturer slug name, use _**`GET /makes/`**_ to get possible values (e.g. `mitsubishi`)", "required": true, "type": "string", "x-example": "mitsubishi"}, {"name": "model", "in": "query", "description": "Model slug name, use _**`GET /models/`**_ to get possible values (e.g. `outlander`)", "required": true, "type": "string", "x-example": "outlander"}, {"name": "year", "in": "query", "description": "You can use _**`GET /years/`**_ to get possible years (e.g. `2015`)", "required": true, "type": "integer", "x-example": 2015}, {"name": "trim", "in": "query", "description": "Use *`slug`* from _**`GET /trims/`**_ methods here. (e.g. `20-dla-gg2w-iii-restyling`)", "type": "string"}, {"name": "only_oem", "in": "query", "description": "Show only original equipment wheels", "type": "boolean"}, {"name": "lang", "in": "query", "description": "Use this parameter anywhere in the API to get *`name`* field translation of the following objects: **`Make`**, **`Model`**, **`Market`**.\nAcross the *`name`* this objects will have *`name_en`* field with original english name. By default `en` language is used. \nAvailable languages: `en,de,ru,es,it,pt,fr,ja,zh-cn,zh-tw`. Currently translation works for chinese `zh-cn` language only", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/Vehicle"}}}}, "tags": ["vehicles"], "summary": "Find OE and option fitments by model/year/trim", "deprecated": true}, "parameters": []}, "/years/": {"get": {"operationId": "years_list", "description": "Get a list of years that match the given manufacturer and model (if present)", "parameters": [{"name": "make", "in": "query", "description": "Manufacturer slug name, use _**`GET /makes/`**_ to get possible values (e.g. `mitsubishi`)", "required": true, "type": "string", "x-example": "mitsubishi"}, {"name": "model", "in": "query", "description": "Model slug name, use _**`GET /models/`**_ to get possible values (e.g. `outlander`)", "type": "string"}], "responses": {"200": {"description": "", "schema": {"type": "array", "items": {"$ref": "#/definitions/Year"}}}}, "tags": ["years"], "summary": "Returns list of years for the given manufacturer/model", "deprecated": false}, "parameters": []}}, "definitions": {"BoltPattern": {"required": ["stud", "pcd", "count"], "type": "object", "properties": {"pattern": {"description": "Formatted bolt pattern (e.g. `5x105`)", "type": "string"}, "stud": {"description": "Stud holes number (e.g. `5`)", "type": "integer"}, "pcd": {"description": "Pitch circle diameter, mm (e.g. `105`)", "type": "number"}, "count": {"description": "Number of vehicles matching bolt pattern", "type": "integer"}}}, "Make": {"required": ["slug", "name", "name_en"], "type": "object", "properties": {"slug": {"description": "Manufacturer slug name (e.g. `mitsubishi`)", "type": "string", "format": "slug", "pattern": "^[-a-zA-Z0-9_]+$"}, "name": {"description": "Manufacturer name (e.g. `Mitsubishi`)", "type": "string"}, "name_en": {"description": "\nOriginal english name.\nUse it along with _**`lang`**_ query parameter \n", "type": "string"}}}, "Market": {"required": ["slug", "abbr", "name", "name_en"], "type": "object", "properties": {"slug": {"description": "Market slug name (e.g. `eudm`)", "type": "string", "format": "slug", "pattern": "^[-a-zA-Z0-9_]+$"}, "abbr": {"description": "Market abbreviation (e.g. `EUDM`)", "type": "string"}, "name": {"description": "Market name (e.g. `European domestic market`)", "type": "string"}, "name_en": {"description": "\nOriginal english name.\nUse it along with _**`lang`**_ query parameter \n", "type": "string"}}}, "TrimWithMarketAndYears": {"required": ["trim", "market", "years"], "type": "object", "properties": {"trim": {"description": "Trim name (e.g. `2.0`, can be __*`null`*__)", "type": ["string", "null"]}, "market": {"$ref": "#/definitions/Market"}, "years": {"description": "Production years for these trim and market", "type": "array", "items": {"type": "integer"}}}}, "ModelWithTrims": {"required": ["slug", "name", "start_year", "end_year", "vehicles"], "type": "object", "properties": {"slug": {"description": "Model name (e.g. `Outlander`)", "type": "string"}, "name": {"description": "Model slug name (e.g. `outlander`)", "type": "string"}, "start_year": {"description": "Model production start year.\nIt should be 'integer' but it is used as 'string' by historical reasons.", "type": "string"}, "end_year": {"description": "Model production end year.\nIt should be 'integer' but it is used as 'string' by historical reasons. \nIt equals to the __*`current year + 1`*__ if it is still in production.", "type": "string"}, "vehicles": {"type": "array", "items": {"$ref": "#/definitions/TrimWithMarketAndYears"}}}}, "MakeWithModels": {"required": ["make", "models"], "type": "object", "properties": {"make": {"$ref": "#/definitions/Make"}, "models": {"type": "array", "items": {"$ref": "#/definitions/ModelWithTrims"}}}}, "Country": {"required": ["slug", "name"], "type": "object", "properties": {"slug": {"description": "Country code (e.g. `JP`)", "type": "string"}, "name": {"description": "Country (e.g. `Japan`)", "type": "string"}}}, "Model": {"required": ["slug", "name", "name_en"], "type": "object", "properties": {"slug": {"description": "Model slug name (e.g. `outlander`)", "type": "string"}, "name": {"description": "Model name (e.g. `Outlander`)", "type": "string"}, "name_en": {"description": "\nOriginal english name.\nUse it along with _**`lang`**_ query parameter \n", "type": "string"}}}, "Body": {"type": "object", "properties": {"title": {"description": "Contains body type, generation name and years, number of doors if such info is provided.\n (e.g. `III Restyling [2015 .. 2019] Closed Off-Road Vehicle, 5d`)", "type": "string"}, "image": {"description": "Body picture url", "type": "string", "format": "uri"}}}, "GenerationWithMakeAndModel": {"required": ["make", "model", "name", "bodies"], "type": "object", "properties": {"make": {"$ref": "#/definitions/Make"}, "model": {"$ref": "#/definitions/Model"}, "name": {"description": "Generation name (e.g. `III Restyling`)", "type": "string"}, "bodies": {"type": "array", "items": {"$ref": "#/definitions/Body"}}, "start_year": {"description": "Generation start year", "type": "integer"}, "end_year": {"description": "Generation end year.\nIt equals to the __*`current year + 1`*__ if it is still in production.", "type": "integer"}, "years": {"description": "Generation production years", "type": "array", "items": {"type": "integer"}}}}, "Generation": {"required": ["name", "bodies"], "type": "object", "properties": {"name": {"description": "Generation name (e.g. `III Restyling`)", "type": "string"}, "bodies": {"type": "array", "items": {"$ref": "#/definitions/Body"}}, "start_year": {"description": "Generation start year", "type": "integer"}, "end_year": {"description": "Generation end year.\nIt equals to the __*`current year + 1`*__ if it is still in production.", "type": "integer"}, "years": {"description": "Generation production years", "type": "array", "items": {"type": "integer"}}}}, "Aggregation": {"required": ["min", "max", "units"], "type": "object", "properties": {"min": {"description": "Min aggregated value", "type": "number"}, "max": {"description": "Max aggregated value", "type": "number"}, "units": {"description": "One of `mm, in, %`", "type": "string"}}}, "SizeAggregation": {"required": ["min", "max"], "type": "object", "properties": {"min": {"description": "Size combined from minimum *`width`*, *`aspect_ratio`* and *`diameter`*", "type": "string"}, "max": {"description": "Size combined from maximum *`width`*, *`aspect_ratio`* and *`diameter`*", "type": "string"}}}, "TiresAggregation": {"description": "Tire width, aspect ratio, and rim diameter values aggregated by all possible model modifications", "required": ["aspect_ratio", "diameter", "width", "tire_size"], "type": "object", "properties": {"aspect_ratio": {"$ref": "#/definitions/Aggregation"}, "diameter": {"$ref": "#/definitions/Aggregation"}, "width": {"$ref": "#/definitions/Aggregation"}, "tire_size": {"$ref": "#/definitions/SizeAggregation"}}}, "RimAgregation": {"description": "Rim diameter, offset, and width values aggregated by bolt pattern", "required": ["diameter", "offset", "width"], "type": "object", "properties": {"diameter": {"$ref": "#/definitions/Aggregation"}, "offset": {"$ref": "#/definitions/Aggregation"}, "width": {"$ref": "#/definitions/Aggregation"}}}, "ModelWithTires": {"required": ["make", "model", "year", "generations"], "type": "object", "properties": {"make": {"$ref": "#/definitions/Make"}, "model": {"$ref": "#/definitions/Model"}, "year": {"description": "Selected year (e.g. `2015`, can be __*`null`*__)", "type": ["integer", "null"]}, "years": {"description": "Model production years", "type": "array", "items": {"type": "integer"}}, "generations": {"type": "array", "items": {"$ref": "#/definitions/Generation"}}, "tires": {"$ref": "#/definitions/TiresAggregation"}, "rims": {"description": "Each key is bolt pattern, e.g. *`5x105`*", "type": "object", "additionalProperties": {"$ref": "#/definitions/RimAgregation"}}}}, "Power": {"description": "Power in different units (can be __*`null`*__)", "required": ["PS", "hp", "kW"], "type": "object", "properties": {"PS": {"description": "Power, PS (e.g. `169`)", "type": "number"}, "hp": {"description": "Power, hp (e.g. `166`)", "type": "number"}, "kW": {"description": "Power, kW (e.g. `124`)", "type": "number"}}}, "Pressure": {"description": "Tire pressure in different units (can be __*`null`*__)", "required": ["bar", "psi", "kPa"], "type": "object", "properties": {"bar": {"description": "Pressure, bar (e.g. `2.4`)", "type": "number"}, "psi": {"description": "Pressure, psi (e.g. `35`)", "type": "number"}, "kPa": {"description": "Pressure, kPa (e.g. `240`)", "type": "number"}}}, "Wheel": {"required": ["rim", "rim_diameter", "rim_width", "rim_offset", "tire", "tire_sizing_system", "tire_construction", "tire_width", "tire_aspect_ratio", "tire_diameter", "tire_section_width", "tire_is_82series"], "type": "object", "properties": {"tire_pressure": {"$ref": "#/definitions/Pressure"}, "rim": {"description": "Formatter rim size (e.g. `7Jx18 ET38`, can be __*`\"\"`*__)", "type": "string"}, "rim_diameter": {"description": "Rim diameter, in (e.g. `18.0`, can be __*`null`*__)", "type": ["number", "null"]}, "rim_width": {"description": "Rim width, in (e.g. `7.0`, can be __*`null`*__)", "type": ["number", "null"]}, "rim_offset": {"description": "Rim offset, mm (e.g. `38.0`, can be __*`null`*__)", "type": ["number", "null"]}, "tire": {"description": "Formatted tire size (e.g. `225/55R18`, can be __*`\"\"`*__)", "type": "string"}, "tire_sizing_system": {"description": "Tire sizing system (e.g. `metric`, can be __*`null`*__)", "type": ["string", "null"], "enum": ["metric", "flotation", "lt-metric", "lt-numeric"]}, "tire_construction": {"description": "Tire constriction code (e.g. `R`, can be __*`null`*__)", "type": ["string", "null"], "enum": ["R", "B", "D"]}, "tire_width": {"description": "Tire width, mm (e.g. `225.0`, can be __*`null`*__)", "type": ["number", "null"]}, "tire_aspect_ratio": {"description": "Aspect ratio, % (e.g. `55.0`, can be __*`null`*__)", "type": ["number", "null"]}, "tire_diameter": {"description": "High flotation tire diameter, in (e.g. `31.0`, can be __*`null`*__)", "type": ["number", "null"]}, "tire_section_width": {"description": "High flotation section width, in (e.g. `10.5`, can be __*`null`*__)", "type": ["number", "null"]}, "tire_is_82series": {"description": "Is an old tire with assumed aspect ratio 82%", "type": "boolean"}, "load_index": {"description": "Load index (e.g. `98`, can be __*`null`*__)", "type": ["integer", "null"]}, "speed_index": {"description": "Speed rating (e.g. `H`, can be __*`null`*__)", "type": ["string", "null"]}}}, "WheelPair": {"required": ["showing_fp_only", "is_stock", "front", "rear"], "type": "object", "properties": {"showing_fp_only": {"description": "Show front pair only", "type": "boolean"}, "is_stock": {"description": "Original Equipment (OE)", "type": "boolean"}, "front": {"$ref": "#/definitions/Wheel"}, "rear": {"$ref": "#/definitions/Wheel"}}}, "Vehicle": {"required": ["market", "body", "trim", "slug", "generation", "stud_holes", "pcd", "centre_bore", "lock_text", "bolt_pattern", "engine_type"], "type": "object", "properties": {"market": {"$ref": "#/definitions/Market"}, "body": {"description": "Body name. Used extensively for JDM market (e.g. `GG2W`, can be __*`null`*__)", "type": ["string", "null"]}, "trim": {"description": "Trim name. It can be empty for models created for JDM market (e.g. `2.0`, can be __*`null`*__)", "type": ["string", "null"]}, "slug": {"description": "Combined trim, body, and generation identifier.\nNon-unique through markets (e.g. `20-gg2w-iii-restyling`)", "type": "string"}, "generation": {"$ref": "#/definitions/Generation"}, "stud_holes": {"description": "Number of stud holes (e.g. `5`, can be __*`null`*__)", "type": ["integer", "null"]}, "pcd": {"description": "Pitch circle diameter, mm (e.g. `105`, can be __*`null`*__)", "type": ["number", "null"]}, "centre_bore": {"description": "Centre bore diameter, mm (e.g. `48.1`, can be __*`null`*__)", "type": ["number", "null"]}, "lock_type": {"type": "string", "enum": ["nut", "bolt"]}, "lock_text": {"description": "Lock thread size (e.g. `M12 x 1.25`, can be __*`null`*__)", "type": ["string", "null"]}, "bolt_pattern": {"description": "Bolt pattern (e.g. `5x105`, can be __*`N/A`*__)", "type": "string"}, "power": {"$ref": "#/definitions/Power"}, "engine_type": {"description": "Engine type (e.g. `V8`, can be __*`null`*__)", "type": ["string", "null"]}, "fuel": {"description": "Fuel (e.g. `Petrol`, can be __*`null`*__)", "type": ["string", "null"]}, "wheels": {"type": "array", "items": {"$ref": "#/definitions/WheelPair"}}}}, "Tire": {"required": ["width", "aspect_ratio", "rim_diameter", "count"], "type": "object", "properties": {"tire": {"description": "Formatted tire size (e.g. `225/55R18`)", "type": "string"}, "width": {"description": "Tire section width, mm (e.g. `195`)", "type": "integer"}, "aspect_ratio": {"description": "Tire aspect ratio, % (e.g. `55`)", "type": "integer"}, "rim_diameter": {"description": "Rim diameter, in (e.g. `16`)", "type": "number"}, "count": {"description": "Number of vehicles matching tire size", "type": "integer"}}}, "Trim": {"required": ["slug", "trim", "body", "production_start_year", "production_end_year"], "type": "object", "properties": {"slug": {"description": "Combined trim, body, and generation identifier.\nNon-unique through markets (e.g. `20-gg2w-iii-restyling`)", "type": "string"}, "name": {"description": "Format: __*`trim (body) [generation]`*__ (e.g. `2.0 (GG2W) [III Restyling]`)", "type": "string"}, "trim": {"description": "Trim name. It can be empty for models created for JDM market (e.g. `2.0`, can be __*`null`*__)", "type": ["string", "null"]}, "body": {"description": "Body name. Used extensively for JDM market (e.g. `GG2W`, can be __*`null`*__)", "type": ["string", "null"]}, "generation": {"description": "Generation name (e.g. `III Restyling`, can be __*`null`*__)", "type": ["string", "null"]}, "production_start_year": {"description": "Trim production start year (e.g. `2015`, can be __*`null`*__)", "type": ["integer", "null"]}, "production_end_year": {"description": "Trim production end year (e.g. `2016`, can be __*`null`*__)", "type": ["integer", "null"]}, "markets": {"description": "List of markets where this trim if present", "type": "array", "items": {"$ref": "#/definitions/Market"}}}}, "Year": {"required": ["slug", "name"], "type": "object", "properties": {"slug": {"description": "Same as *`name`*.\nAimed to match general for this API slug-name format", "type": "integer"}, "name": {"description": "Year (e.g. `2015`)", "type": "integer"}}}}}