Package: vpic-api
vPIC API Client LibraryA Python client library for decoding VINs and querying the United States
National Highway Traffic Safety Administration (NHTSA)Vehicle Product
Information Catalog Vehicle Listing (vPIC) API.NHTSA vPIC APIThe Vehicle Production Information Catalog (vPIC) API is hosted by the U.S. National Highway Transportation Safety Administration (NHTSA). vPIC data is provided by manufacturers who make vehicles for sale in the United States. The vPIC API is available 24/7, is free to use, and does not require registration. Seehttps://vpic.nhtsa.dot.gov/api/home/index/faqfor more on the vPIC API.FeaturesDecode 17-digit Vehicle Identification Numbers (VIN)Decode a partial VINDiscover manufacturers, makes, and modelsSupports cars, MPVs, trucks, motorcycles, buses, trailers, low speed vehicles and incomplete vehicles sold the U.S.A.Find manufacturer model year VIN guidesSupports vehicles made since 1981Comprehensive support for the vPIC APIGet results as Python objects (see vpic.TypedClient)Get results as JSON (see vpic.Client)Author@davidpeckhamInstallationpoetryaddvpic-apivpic.TypedClient Examplesvpic.TypedClient returns results as Python objects.Decode a VINGet the characteristics of a vehicle by it's 17-digit Vehicle Identification Number (VIN):fromvpicimportTypedClientc=TypedClient()result=c.decode_vin("1FTMW1T88MFA00001")Vehicle(abs="",...body_cab_type="Crew/ Super Crew/ Crew Max",body_class="Pickup",brake_system_desc="",brake_system_type="Hydraulic",...displacement_cc="3500.0",displacement_ci="213.58310433156",displacement_l="3.5",...drive_type="4WD/4-Wheel Drive/4x4",...engine_configuration="V-Shaped",engine_cycles="",engine_cylinders="6",engine_hp="375",engine_hp_to="",engine_kw="279.6375",engine_manufacturer="Ford",engine_model="GTDI",entertainment_system="",error_code="0",error_text="0 - VIN decoded clean. Check Digit (9th position) is correct",...make="FORD",make_id="460",manufacturer="FORD MOTOR COMPANY, USA",manufacturer_id="976",model="F-150",model_id="1801",model_year="2021",motorcycle_chassis_type="Not Applicable",motorcycle_suspension_type="Not Applicable",...plant_city="DEARBORN",plant_company_name="",plant_country="UNITED STATES (USA)",plant_state="MICHIGAN",...series="F-Series",series2="",...trim="SuperCrew-SSV",...vin="1FTMW1T88MFA00001",...vehicle_type="TRUCK ",...)Get the Models for a Make and Model Yearget_models_for_make("TESLA",model_year=2020)[Model(model_id=1685,model="Model S",make_id=441,make="TESLA",vehicle_type_id=None),Model(model_id=10199,model="Model X",make_id=441,make="TESLA",vehicle_type_id=None),Model(model_id=17834,model="Model 3",make_id=441,make="TESLA",vehicle_type_id=None),Model(model_id=27027,model="Model Y",make_id=441,make="TESLA",vehicle_type_id=None)]vpic.Client Examplesvpic.Client returns JSON results from the vPIC API.This client automatically standardizes variable names where vPIC uses inconsistent naming. Disable this to see the unaltered JSON responses:fromvpicimportClientc=Client(standardize_names=False)Decode a VINGet the characteristics of a vehicle by it's 17-digit Vehicle Identification Number (VIN):fromvpicimportClientc=Client()result=c.decode_vin("1FA6P8TD5M5100001",2021)Here are a few of the 130+ attributes vPIC returns for the VIN:{"Doors":"2","ErrorCode":"0","ErrorText":"0 - VIN decoded clean. Check Digit (9th position) is correct","Make":"FORD","MakeId":"460","Manufacturer":"FORD MOTOR COMPANY, USA","ManufacturerId":"976","Model":"Mustang","ModelId":"1781","ModelYear":"2021","PlantCity":"FLATROCK","PlantCountry":"UNITED STATES (USA)","PlantState":"MICHIGAN","Series":"I4 Coupe","VIN":"1FA6P8TD5M5100001","VehicleType":"PASSENGER CAR",}Get the Models for a Make and Model Yearresult=c.get_models_for_make("TESLA",2021)[{"MakeId":441,"Make":"TESLA","ModelId":1685,"Model":"Model S"},{"MakeId":441,"Make":"TESLA","ModelId":10199,"Model":"Model X"},{"MakeId":441,"Make":"TESLA","ModelId":17834,"Model":"Model 3"},{"MakeId":441,"Make":"TESLA","ModelId":27027,"Model":"Model Y"}]