3001.VIN Decoder

Brief Summary:

From VIN, we can know the key information of the vehicle, including brand, model, engine specifications, production year, vehicle configuration etc. And for some brands we can also provide detailed information such as production date, body color, and configuration options selected when purchasing the car.

Request URL: Request example:

Default

Includes the vehicle's official announcement model number (a vehicle model designation marked on the manufacturer's plate of some vehicles).

Request method:

GET or POST

【Example】: C# code (for other languages, please use AI to translate accordingly).

Parameters:

ParameterRequiredTypeDescription
vinYesstring17-digit VIN (Vehicle Identification Number)
userYesstringuser name
tokenYesstringMD5(concat(MD5('myuser'),MD5('mypass'),'/?vin=XXXXXXXXXXXXXXXXX'))
gonggao_noNostringgonggao_no

Response example 
{

    "code":1,


    "msg":"success",


    "data":{


        "model_year_from_vin":"2015",


        "epc":"toyota",


        "epc_cn":"丰田",


        "my_model_std_id":"1152",


        "epc_id":"1152",


        "matching_mode":"exact_match",


        "brand":"丰田",


        "gonggao_no":"gtm7202ge",


        "build_date":"201506",


        "model_list":[


            {


                "Id":10815,


                "Js_id":10815,


                "model_detail_key":"wlzlzy",


                "Gonggao_no":"gtm7202ge",


                "Group_id":"40",


                "UrlMake":"toyota",


                "Epc":"toyota",


                "Epc_id":"1152",


                "Model_year":"2015",


                "Model_detail":"丰田 凯美瑞 2.0l 手自一体(6档) 精英版 2015年款",


                "Model_detial_en":"Toyota Camry 2.0L AMT(6-speed) Elite 2015",


                "Factory":"广汽丰田",


                "Factory_en":"Gac Toyota Automobile",


                "Brand":"丰田",


                "Brand_en":"Toyota",


                "Model":"凯美瑞",


                "Model_zh":"凯美瑞",


                "Model_en":"Camry",


                "Series":"凯美瑞",


                "Series_en":"Camry",


                "Series_zh":"凯美瑞",


                "Sales_version":"精英版",


                "Sales_version_en":"Elite",


                "Cc":"2.0L",


                "Engine_no":"6AR",


                "Engine_no_en":"6AR",


                "Air_intake":"自然吸气",


                "Air_intake_en":"Naturally aspirated",


                "Fuel_type":"汽油",


                "Fule_type_en":"gasoline",


                "Transmission_detail":"手自一体变速器(AMT)",


                "Transmission_detail_en":"Automated manual transmission (AMT)",


                "Gear_num":"6",


                "Gear_num_en":"6",


                "Driving_mode":"前置前驱",


                "Driving_mode_en":"Front-wheel drive",


                "Img_adress":"026\264481.jpg,026\264480.jpg,026\264479.jpg",


                "Trans_code":"",


                "Chassis_code":"",


                "Door_num":"四门",


                "Seat_num":"5",


                "Body_type":"三厢车",


                "Date_begin":"2015-01-10",


                "Date_end":"2016-08-01",


                "Price":"184800",


                "Autohome_id":"https://www.autohome.com.cn/spec/20898",


                "Xs_id":"XS_58264"


            },


            {


                "Id":10816,


                "Js_id":10816,


                "model_detail_key":"wlzlzy",


                "Gonggao_no":"gtm7202ge",


                "Group_id":"40",


                "UrlMake":"toyota",


                "Epc":"toyota",


                "Epc_id":"1152",


                "Model_year":"2015",


                "Model_detail":"丰田 凯美瑞 2.0l 手自一体(6档) 领先版 2015年款",


                "Model_detial_en":"Toyota Camry 2.0L AMT(6-speed) Precede 2015",


                "Factory":"广汽丰田",


                "Factory_en":"Gac Toyota Automobile",


                "Brand":"丰田",


                "Brand_en":"Toyota",


                "Model":"凯美瑞",


                "Model_zh":"凯美瑞",


                "Model_en":"Camry",


                "Series":"凯美瑞",


                "Series_en":"Camry",


                "Series_zh":"凯美瑞",


                "Sales_version":"领先版",


                "Sales_version_en":"Precede",


                "Cc":"2.0L",


                "Engine_no":"6AR",


                "Engine_no_en":"6AR",


                "Air_intake":"自然吸气",


                "Air_intake_en":"Naturally aspirated",


                "Fuel_type":"汽油",


                "Fule_type_en":"gasoline",


                "Transmission_detail":"手自一体变速器(AMT)",


                "Transmission_detail_en":"Automated manual transmission (AMT)",


                "Gear_num":"6",


                "Gear_num_en":"6",


                "Driving_mode":"前置前驱",


                "Driving_mode_en":"Front-wheel drive",


                "Img_adress":"026\264481.jpg,026\264480.jpg,026\264479.jpg",


                "Trans_code":"",


                "Chassis_code":"",


                "Door_num":"四门",


                "Seat_num":"5",


                "Body_type":"三厢车",


                "Date_begin":"2015-01-10",


                "Date_end":"2016-08-01",


                "Price":"192800",


                "Autohome_id":"https://www.autohome.com.cn/spec/20899",


                "Xs_id":"XS_58263"


            }


        ],


        "model_original_epc_list":[


            {


                "Epc_id":1152,


                "CarAttributes":[


                    {


                        "Language":"zh",


                        "IsMajorAttribute":true,


                        "Col_name":"车型",


                        "Col_value":"CAMRY/HYBRID (CHINA)"


                    },


                    {


                        "Language":"en",


                        "IsMajorAttribute":true,


                        "Col_name":"Model name",


                        "Col_value":"CAMRY/HYBRID (CHINA)"


                    },


                    {


                        "Language":"zh",


                        "IsMajorAttribute":true,


                        "Col_name":"车型代码",


                        "Col_value":"ASV51L-JETEHC"


                    },


                    {


                        "Language":"en",


                        "IsMajorAttribute":true,


                        "Col_name":"Model code",


                        "Col_value":"ASV51L-JETEHC"


                    },


                    {


                        "Language":"zh",


                        "IsMajorAttribute":true,


                        "Col_name":"引擎",


                        "Col_value":"6ARFSE"


                    },


                    {


                        "Language":"en",


                        "IsMajorAttribute":true,


                        "Col_name":"Engine code",


                        "Col_value":"6ARFSE"


                    },


                    {


                        "Language":"zh",


                        "IsMajorAttribute":true,


                        "Col_name":"变速箱",


                        "Col_value":"6FC"


                    },


                    {


                        "Language":"en",


                        "IsMajorAttribute":true,


                        "Col_name":"Transmission",


                        "Col_value":"6FC"


                    },


                    {


                        "Language":"zh",


                        "IsMajorAttribute":true,


                        "Col_name":"级别",


                        "Col_value":"20E"


                    },


                    {


                        "Language":"en",


                        "IsMajorAttribute":true,


                        "Col_name":"Grade",


                        "Col_value":"20E"


                    },


                    {


                        "Language":"zh",


                        "IsMajorAttribute":true,


                        "Col_name":"其它信息",


                        "Col_value":"LHD  CHI"


                    },


                    {


                        "Language":"en",


                        "IsMajorAttribute":true,


                        "Col_name":"Additional vehicle infomation",


                        "Col_value":"LHD  CHI"


                    }


                ]


            }


        ],


        "model_gonggao_list":[


            {


                "Id":455283,


                "F4":"SVW71611BM",


                "F6":"大众汽车(VOLKSWAGEN)",


                "F7":"轿车",


                "F9":"1600",


                "F11":"汽油",


                "F12":"GB18352.5-2013",


                "F13":"2",


                "F14":"2470",


                "F15":"840/760",


                "F16":"-/-",


                "F17":"4",


                "F18":"185/60 R15 84T",


                "F19":"14/21.5",


                "F20":"839/661",


                "F21":"1463",


                "F22":"1456",


                "F23":"3970",


                "F24":"1682",


                "F25":"1462",


                "F26":"",


                "F27":"",


                "F28":"",


                "F29":"185",


                "F30":"5",


                "F32":"",


                "F36":"上汽大众汽车有限公司",


                "F41":"承载式车身",


                "F45":"选装双线条光亮散热器隔栅,天窗,GPS天线,尾部光亮饰条,30 LIMITED字牌,运动型套件;ABS系统型号为:6RD 614 117,6RD 614 517,生产企业为:博世汽车部件(苏州)有限公司",


                "Img_adress":"109\1096664.jpg,033\337713.jpg,007\71364.jpg,007\71363.jpg,007\71362.jpg,007\71361.jpg",


                "Engines":[


                    {


                        "Engine_no":"CSR",


                        "Cc":"1598",


                        "Kw":"81",


                        "Factory":"上海大众动力总成有限公司"


                    }


                ]


            }


        ],


        "model_import_list":[


            {


                "Epc":"Freightliner",


                "Make_cn":"福莱纳",


                "Make_en":"Freightliner",


                "Model_cn":"M2 106",


                "Model_en":"M2 106",


                "Body_style_cn":"侧置驾驶室",


                "Body_style_en":"CONVENTIONAL CAB",


                "Cc_cn":"6.7升",


                "Cc_en":"6.7 litre",


                "Engine_cn":"6.7升，L6，柴油机",


                "Engine_en":"6.7L L6 DIESEL",


                "Trim_cn":"",


                "Trim_en":"",


                "Transmission_cn":"",


                "Transmission_en":"",


                "Driveline_cn":"4X2",


                "Driveline_en":"4X2",


                "Seating_standard_cn":"",


                "Seating_standard_en":"",


                "Length_cn":"",


                "Length_en":"",


                "Width_cn":"",


                "Width_en":"",


                "Height_cn":"",


                "Height_en":""


            }


        ]


    }


}

Response description

ParameterTypeDescription
Model_year_from_vinstringVehicle production year
EpcstringThe EPC corresponding to this VIN — critically important, as it is required for subsequent parts data queries.
my_model_std_idstringDeprecated, replaced with epc_id. Retained for compatibility.
epc_idstringSub-model ID under a specific OEM EPC
Matching_modestringMatching mode, including exact_match and inexact_match
brandstring
build_datestring
model_liststringStandard Vehicle Model List
model_list>IdintDeprecated, replaced with JS_ID. Retained for compatibility.
model_list>Js_idintStandard Vehicle Model ID
model_list>model_detail_keystringKey for detailed vehicle configuration (not JS_ID); use this field to retrieve all parameters for a specific model.
model_list>Gonggao_nostringVehicle Announcement Model Number
model_list>Group_idstringEPC brand group ID, used to distinguish brand groups (e.g., Honda and Acura both belong to the Honda group).
model_list>UrlMakestringCompatibility field, deprecated; use epc instead in future implementations.
model_list>Epcstring
model_list>Epc_idstring
model_list>Model_yearstring
model_list>Model_detailstring
model_list>Model_detial_enstring
model_list>Factorystring
model_list>Brandstring
model_list>Modelstring
model_list>Seriesstring
model_list>Sales_versionstring
model_list>CcstringEngine displacement (L)
model_list>Engine_nostring
model_list>Air_intakestring
model_list>Fuel_typestring
model_list>Transmission_detailstring
model_list>Gear_numstring
model_list>Driving_modestring
model_list>Trans_codestring
model_list>Chassis_codestring
model_list>Door_numstring
model_list>Seat_numstring
model_list>Body_typestring
model_list>Date_beginstringVehicle launch date
model_list>Date_endstringVehicle discontinuation date
model_list>Pricestring
model_list>Autohome_idstring
model_list>Xs_idstringCustom client field ID; can be ignored.
model_list>Img_adressstringhttp://resource.17vin.com/img/car/all/{Img_adress} example：http://resource.17vin.com/img/car/all/00d/BH7168AY/k90127340.jpg
model_original_epc_liststringOriginal OEM EPC Vehicle Model Information List
model_original_epc_list>Epc_idint
model_original_epc_list>CarAttributesstringOriginal OEM Vehicle Configuration Details
model_original_epc_list>CarAttributes>Languagestring
model_original_epc_list>CarAttributes>IsMajorAttributestring
model_original_epc_list>CarAttributes>Col_namestring
model_original_epc_list>CarAttributes>Col_valuestring
model_import_liststringList of niche imported brand vehicle models
model_import_list>Epcstring
model_import_list>Make_cnstring
model_import_list>Model_cnstring
model_import_list>Body_style_cnstring
model_import_list>Cc_cnstring
model_import_list>Engine_cnstring
model_import_list>Trim_cnstring
model_import_list>Transmission_cnstring
model_import_list>Driveline_cnstring
model_import_list>Seating_standard_cnstring
model_import_list>Length_cnstring
model_import_list>Width_cnstring
model_import_list>Height_cnstring

Remark

The model_list and model_original_epc_list nodes may appear simultaneously. If both contain no data, the model_import_list node may appear as a fallback.

model_original_epc_list has the highest reliability, but uses a non-standard structure—its data format varies by EPC brand.

model_list provides standardized data with a consistent structure across all brands.

model_import_list serves as supplementary data with relatively lower reliability and only appears when both model_list and model_original_epc_list are empty.