As the name suggests, vehicle specifications (a.k.a VIN Decoding) are a core part of CarsXE — the very reason CarsXE exists is so you can retrieve vehicle information. On this page, we'll dive into the different contact endpoints you can use to manage contacts programmatically. We'll look at how to query and retrieve vehicle specifications from a vehicle identification number (VIN).
<apiplayground method="GET" path="/specs" params={[ { name: "vin", required: true, example: "WBAFR7C57CC811956" }, { name: "deepdata", options: ["1"], description: "Extra data — slower but more complete." }, { name: "disableIntVINDecoding", options: ["1"] }, ]} />
---
<row>
 <col>
 ## Required attributes
 <properties>
 <property name="key" type="string">
 Your CarsXE API key.
 </property>
 <property name="vin" type="string">
 The 17 character long vehicle identification number.
 </property>
 </properties>
 ## Optional attributes
 <properties>
 <property name="format" type="string">
 The format of the response. One of `json` or `xml`. Defaults to `json`.
 </property>
 <property name="deepdata" type="string">
 Request for extra data. Set to `1` to use. Significantly slower than the regular request but will retrieve additional data.
 </property>
 <property name="disableIntVINDecoding" type="string">
 If we're unable to decode the VIN an [International VIN decoding](/docs/v1/international-vin-decoder) check is run to get some data. Set this to `1` to disable and return an error instead of a potential response.
 </property>
 </properties>
 ---
 ## Response attributes
 <properties>
 <property name="input" type="object">
 Contains the input parameters specified by the query.
 </property>
 <property name="attributes" type="object">
 A map of specifications about the VIN (VIN, Year, Make, Model, Trim, Trim Selections, Style, Type, Size, Category, Made In, Made In City, Doors, Fuel Type, Fuel Capacity, CityMileage, Highway Mileage, Engine, Engine Size, Engine Cylinders, Transmission, Transmission Type, Transmission Speeds, Drivetrain, Anti-Brake System, Steering Type, Curb Weight, Gross Weight, Gross Vehicle Weight Rating, Overall Height, Overall Length, Overall Width, Wheelbase Length, Standard Seating, Optional Seating, Invoice Price, Delivery Charges, Manufacturer Suggested Retail Price).
 </property>
 <property name="colors" type="array">
 A list of objects with details about available color options based on the vehicle’s year, make, and model.
 </property>
 <property name="equipment" type="object">
 Details about a vehicle’s equipment based on the vehicle’s year, make, and model.
 </property>
 <property name="warranties" type="array">
 List of objects containing standard vehicle warranties available by `type`, `miles` and `months`.
 </property>
 <property name="deepdata" type="object">
 More information on the vehicle from our deep data search.
 </property>
 <property name="success" type="boolean">
 More information on the vehicle from our deep data search.
 </property>
 <property name="error" type="string">
 One of the following error codes:
 * `invalid_inputs` (missing VIN, ID, or year/make/model/trim)
 * `invalid_vin` (not a valid VIN)
 * `no_data` (no specifications available)
 * `api_not_enabled` (functionality not enabled for API key)
 * or (blank) if no error
 </property>
 </properties>
 <faq faqs={[{ question: "What VIN can I use for testing?", answer: <strong>You may be use the following VINs for test: <code>WBAFR7C57CC811956</code></strong>},{question: "Is the Vehicle Specifications API included in the free trial?", answer: <strong>Yes! The Vehicle Specifications API is included in the 7-day free trial. For more information visit our <a href='/index.cgi/contrast/https://api.carsxe.com:443/pricing'>pricing</a> page.</strong>}]} hidePadding />
 </col>
 <col sticky>
 <codegroup title="Request" tag="GET" label="/specs">
 ```bash
 curl -G https://api.carsxe.com/specs \
 -d key=CARSXE_API_KEY \
 -d vin=WBAFR7C57CC811956
 ```
 ```js
 import { CarsXE } from "carsxe-api";
 const carsxe = new CarsXE("CARSXE_API_KEY");
 const vin = "WBAFR7C57CC811956";
 try {
 const vehicle = await carsxe.specs({ vin });
 console.log(vehicle);
 } catch (error) {
 console.error(error);
 }
 ```
 ```python
 import asyncio
 from carsxe_api import CarsXE
 carsxe = CarsXE('CARSXE_API_KEY')
 vin = 'WBAFR7C57CC811956'
 try:
 vehicle = asyncio.run(carsxe.specs({"vin": vin}))
 print(vehicle)
 except Exception as e:
 print(f"Error: {e}")
 ```
 ```php
 <?php require_once __DIR__ . '/vendor/autoload.php'; use CarsxeDeveloper\Carsxe\Carsxe; $API_KEY = 'CARSXE_API_KEY'; $carsxe = new Carsxe($API_KEY); $vin = 'WBAFR7C57CC811956'; try { $vehicle = $carsxe->specs(['vin' => $vin]);
 print_r($vehicle);
 } catch (Exception $error) {
 echo "Error: " . $error->getMessage();
 }
 ```
 ```ruby
 require 'carsxe'
 API_KEY = 'CARSXE_API_KEY'
 carsxe = Carsxe::CarsXE.new(api_key: API_KEY)
 vin = 'WBAFR7C57CC811956'
 begin
 vehicle = carsxe.specs('vin' => vin)
 puts vehicle
 rescue StandardError => error
 puts "Error: #{error.message}"
 end
 ```
 ```go
 package main
 import (
 	"fmt"
 	"github.com/carsxe/carsxe-go-package"
 )
 func main() {
 	client := carsxe.New("CARSXE_API_KEY")
 	vin := "WBAFR7C57CC811956"
 	vehicle := client.Specs(map[string]string{"vin": vin})
 	fmt.Println(vehicle)
 }
 ```
 ```java
 import io.github.carsxe.CarsXE;
 import java.util.Map;
 import java.util.HashMap;
 public class Main {
 public static void main(String[] args) {
 CarsXE carsxe = new CarsXE("CARSXE_API_KEY");
 Map<string, String> params = new HashMap<strong>();
 params.put("vin", "WBAFR7C57CC811956");
 try {
 Map<string, Object> vehicle = carsxe.specs(params);
 System.out.println(vehicle);
 } catch (Exception e) {
 System.err.println("Error: " + e.getMessage());
 }
 }
 }
 ```
 ```swift
 import carsxe
 let carsxe = CarsXE(apiKey: "CARSXE_API_KEY")
 let vin = "WBAFR7C57CC811956"
 do {
 let vehicle = try carsxe.specs(["vin": vin])
 print(vehicle)
 } catch {
 print("Error: \(error)")
 }
 ```
 ```csharp
 using carsxe;
 using System;
 using System.Collections.Generic;
 using System.Threading.Tasks;
 class Program
 {
 static async Task Main(string[] args)
 {
 string API_KEY = "CARSXE_API_KEY";
 CarsXE carsxe = new CarsXE(API_KEY);
 string vin = "WBAFR7C57CC811956";
 try
 {
 var vehicle = await carsxe.Specs(new Dictionary<string, string> { { "vin", vin } });
 Console.WriteLine(vehicle);
 }
 catch (Exception ex)
 {
 Console.WriteLine($"Error: {ex.Message}");
 }
 }
 }
 ```
 </codegroup>
 <codegroup title="Response">
 ```json showLineNumbers
 {
 "success": true,
 "input": {
 "key": "API_KEY",
 "vin": "WBAFR7C57CC811956"
 },
 "attributes": {
 "year": "2012",
 "make": "BMW",
 "model": "5-Series",
 "trim": "535i",
 "style": "SEDAN 4-DR",
 "type": "Sedan/Saloon",
 "size": "",
 "category": "",
 "made_in": "GERMANY",
 "made_in_city": "DINGOLFING",
 "doors": "4",
 "fuel_type": "Gasoline",
 "fuel_capacity": "18.50 gallon",
 "city_mileage": "19 - 21 miles/gallon",
 "highway_mileage": "29 - 31 miles/gallon",
 "engine": "3.0L L6 DOHC 24V",
 "engine_size": "",
 "engine_cylinders": "6",
 "transmission": "6-Speed Manual &#124; 8-Speed Automatic",
 "transmission_short": "6M &#124; 8A",
 "transmission_type": "",
 "transmission_speeds": "",
 "drivetrain": "RWD",
 "anti_brake_system": "4-Wheel ABS",
 "steering_type": "R&P",
 "curb_weight": "4090 lbs",
 "gross_vehicle_weight_rating": "",
 "overall_height": "57.60 in.",
 "overall_length": "193.10 in.",
 "overall_width": "73.20 in.",
 "wheelbase_length": "116.90 in.",
 "standard_seating": "5",
 "invoice_price": "48,480ドル USD",
 "delivery_charges": "895ドル USD",
 "manufacturer_suggested_retail_price": "52,500ドル USD",
 "production_seq_number": "811956",
 "front_brake_type": "Disc",
 "rear_brake_type": "Disc",
 "turning_diameter": "37.50 in.",
 "front_suspension": "Ind",
 "rear_suspension": "Ind",
 "front_spring_type": "Coil",
 "rear_spring_type": "Coil",
 "tires": "245/45R18",
 "front_headroom": "40.50 in.",
 "rear_headroom": "38.30 in.",
 "front_legroom": "",
 "rear_legroom": "",
 "front_shoulder_room": "58.30 in.",
 "rear_shoulder_room": "56.20 in.",
 "front_hip_room": "",
 "rear_hip_room": "",
 "interior_trim": [
 "Black Dakota Leather Interior",
 "Black Nappa Leather Interior",
 "Cinnamon Brown/Black Dakota Leather Interior",
 "Everest Gray Dakota Leather Interior",
 "Oyster/Black Dakota Leather Interior",
 "Oyster/Black Nappa Leather Interior",
 "Venetian Beige Dakota Leather Interior"
 ],
 "exterior_color": [
 "Alpine White",
 "Black Sapphire Metallic",
 "Carbon Black Metallic",
 "Cashmere Silver Metallic",
 "Deep Sea Blue Metallic",
 "Dark Graphite Metallic II",
 "Imperial Blue Metallic",
 "Jet Black",
 "Milano Beige Metallic",
 "Mojave Metallic",
 "Space Gray Metallic",
 "Tasman Green Metallic",
 "Titanium Silver Metallic"
 ],
 "curb_weight_manual": "4056 lbs",
 "ground_clearance": "",
 "track_front": "63.00 in.",
 "track_rear": "64.10 in.",
 "cargo_length": "",
 "width_at_wheelwell": "",
 "width_at_wall": "",
 "depth": "",
 "optional_seating": "",
 "passenger_volume": "",
 "cargo_volume": "",
 "cargo_volume_seats_in_place": "",
 "maximum_cargo_volume": "",
 "standard_towing": "",
 "maximum_towing": "",
 "standard_payload": "",
 "maximum_payload": "",
 "maximum_gvwr": "",
 "vehicle_class": "1",
 "vehicle_rating": "Light"
 },
 "colors": [
 {
 "category": "Interior",
 "name": "Black Dakota Leather Interior"
 },
 {
 "category": "Interior",
 "name": "Black Nappa Leather Interior"
 },
 {
 "category": "Interior",
 "name": "Cinnamon Brown/Black Dakota Leather Interior"
 },
 {
 "category": "Interior",
 "name": "Everest Gray Dakota Leather Interior"
 },
 {
 "category": "Interior",
 "name": "Oyster/Black Dakota Leather Interior"
 },
 {
 "category": "Interior",
 "name": "Oyster/Black Nappa Leather Interior"
 },
 {
 "category": "Interior",
 "name": "Venetian Beige Dakota Leather Interior"
 },
 {
 "category": "Exterior",
 "name": "Alpine White"
 },
 {
 "category": "Exterior",
 "name": "Black Sapphire Metallic"
 },
 {
 "category": "Exterior",
 "name": "Carbon Black Metallic"
 },
 {
 "category": "Exterior",
 "name": "Cashmere Silver Metallic"
 },
 {
 "category": "Exterior",
 "name": "Deep Sea Blue Metallic"
 },
 {
 "category": "Exterior",
 "name": "Dark Graphite Metallic II"
 },
 {
 "category": "Exterior",
 "name": "Imperial Blue Metallic"
 },
 {
 "category": "Exterior",
 "name": "Jet Black"
 },
 {
 "category": "Exterior",
 "name": "Milano Beige Metallic"
 },
 {
 "category": "Exterior",
 "name": "Mojave Metallic"
 },
 {
 "category": "Exterior",
 "name": "Space Gray Metallic"
 },
 {
 "category": "Exterior",
 "name": "Tasman Green Metallic"
 },
 {
 "category": "Exterior",
 "name": "Titanium Silver Metallic"
 }
 ],
 "equipment": {
 "4wd_awd": "N/A",
 "abs_brakes": "Std.",
 "adjustable_foot_pedals": "N/A",
 "air_conditioning": "Std.",
 "alloy_wheels": "Std.",
 "am_fm_radio": "Std.",
 "automatic_headlights": "Std.",
 "automatic_load_leveling": "N/A",
 "cargo_area_cover": "N/A",
 "cargo_area_tiedowns": "N/A",
 "cargo_net": "N/A",
 "cassette_player": "N/A",
 "cd_changer": "Opt.",
 "cd_player": "Std.",
 "child_safety_door_locks": "Std.",
 "chrome_wheels": "N/A",
 "cruise_control": "Std.",
 "daytime_running_lights": "Std.",
 "deep_tinted_glass": "N/A",
 "driver_airbag": "Std.",
 "driver_multi_adjustable_power_seat": "Std.",
 "dvd_player": "Opt.",
 "electrochromic_exterior_rearview_mirror": "Std.",
 "electrochromic_interior_rearview_mirror": "Std.",
 "electronic_brake_assistance": "Std.",
 "electronic_parking_aid": "Opt.",
 "first_aid_kit": "N/A",
 "fog_lights": "Std.",
 "front_air_dam": "Std.",
 "front_cooled_seat": "Opt.",
 "front_heated_seat": "Opt.",
 "front_power_lumbar_support": "Std.",
 "front_power_memory_seat": "Std.",
 "front_side_airbag": "Std.",
 "front_side_airbag_with_head_protection": "N/A",
 "front_split_bench_seat": "N/A",
 "full_size_spare_tire": "N/A",
 "genuine_wood_trim": "Std.",
 "glass_rear_window_on_convertible": "N/A",
 "heated_exterior_mirror": "Std.",
 "heated_steering_wheel": "Opt.",
 "high_intensity_discharge_headlights": "Std.",
 "interval_wipers": "Std.",
 "keyless_entry": "Std.",
 "leather_seat": "Std.",
 "leather_steering_wheel": "Std.",
 "limited_slip_differential": "Std.",
 "load_bearing_exterior_rack": "N/A",
 "locking_differential": "N/A",
 "locking_pickup_truck_tailgate": "N/A",
 "manual_sunroof": "Std.",
 "navigation_aid": "Opt.",
 "passenger_airbag": "Std.",
 "passenger_multi_adjustable_power_seat": "Std.",
 "pickup_truck_bed_liner": "N/A",
 "pickup_truck_cargo_box_light": "N/A",
 "power_adjustable_exterior_mirror": "Std.",
 "power_door_locks": "Std.",
 "power_sliding_side_van_door": "N/A",
 "power_sunroof": "Std.",
 "power_trunk_lid": "Opt.",
 "power_windows": "Std.",
 "rain_sensing_wipers": "Std.",
 "rear_spoiler": "Opt.",
 "rear_window_defogger": "Std.",
 "rear_wiper": "N/A",
 "remote_ignition": "N/A",
 "removable_top": "N/A",
 "run_flat_tires": "Std.",
 "running_boards": "N/A",
 "second_row_folding_seat": "N/A",
 "second_row_heated_seat": "Opt.",
 "second_row_multi_adjustable_power_seat": "N/A",
 "second_row_removable_seat": "N/A",
 "second_row_side_airbag": "N/A",
 "second_row_side_airbag_with_head_protection": "N/A",
 "second_row_sound_controls": "Opt.",
 "separate_driver_front_passenger_climate_controls": "Std.",
 "side_head_curtain_airbag": "Std.",
 "skid_plate": "N/A",
 "sliding_rear_pickup_truck_window": "N/A",
 "splash_guards": "N/A",
 "steel_wheels": "N/A",
 "steering_wheel_mounted_controls": "Std.",
 "subwoofer": "Std.",
 "tachometer": "Std.",
 "telematics_system": "Std.",
 "telescopic_steering_column": "Std.",
 "third_row_removable_seat": "N/A",
 "tilt_steering": "Std.",
 "tilt_steering_column": "Std.",
 "tire_pressure_monitor": "Std.",
 "tow_hitch_receiver": "N/A",
 "towing_preparation_package": "N/A",
 "traction_control": "Std.",
 "trip_computer": "Std.",
 "trunk_anti_trap_device": "Std.",
 "vehicle_anti_theft": "Std.",
 "vehicle_stability_control_system": "Std.",
 "voice_activated_telephone": "N/A",
 "wind_deflector_for_convertibles": "N/A"
 },
 "warranties": [
 {
 "type": "Basic",
 "miles": "50,000 mile",
 "months": "48 month"
 },
 {
 "type": "Powertrain",
 "miles": "50,000 mile",
 "months": "48 month"
 },
 {
 "type": "Rust",
 "months": "144 month",
 "miles": "Unlimited mile"
 }
 ],
 "deepdata": {
 "Error Code": "0",
 "Error Text": "0 - VIN decoded clean. Check Digit (9th position) is correct",
 "Vehicle Descriptor": "WBAFR7C5*CC",
 "Make": "BMW",
 "Manufacturer Name": "BMW AG",
 "Model": "535i",
 "Model Year": "2012",
 "Plant City": "DINGOLFING",
 "Series": "5-Series",
 "Trim": "",
 "Vehicle Type": "PASSENGER CAR",
 "Plant Country": "GERMANY",
 "Plant Company Name": "",
 "Plant State": "",
 "Body Class": "Sedan/Saloon",
 "Doors": "4",
 "Gross Vehicle Weight Rating From": "Class 1: 6,000 lb or less (2,722 kg or less)",
 "Gross Vehicle Weight Rating To": "Class 1: 6,000 lb or less (2,722 kg or less)",
 "Wheel Base (inches) From": "116.9",
 "Bed Type": "Not Applicable",
 "Cab Type": "Not Applicable",
 "Trailer Type Connection": "Not Applicable",
 "Trailer Body Type": "Not Applicable",
 "Number of Wheels": "4",
 "Wheel Size Front (inches)": "18",
 "Wheel Size Rear (inches)": "18",
 "Custom Motorcycle Type": "Not Applicable",
 "Motorcycle Suspension Type": "Not Applicable",
 "Motorcycle Chassis Type": "Not Applicable",
 "Bus Floor Configuration Type": "Not Applicable",
 "Bus Type": "Not Applicable",
 "Steering Location": "Left-Hand Drive (LHD)",
 "Number of Seats": "5",
 "Number of Seat Rows": "2",
 "Transmission Style": "",
 "Transmission Speeds": "",
 "Axles": "2",
 "Drive Type": "RWD/Rear-Wheel Drive",
 "Brake System Type": "Hydraulic",
 "Engine Number of Cylinders": "6",
 "Displacement (CC)": "2979.1682352",
 "Displacement (CI)": "181.8",
 "Displacement (L)": "3.0",
 "Engine Stroke Cycles": "4",
 "Engine Model": "",
 "Fuel Type - Primary": "Gasoline",
 "Valve Train Design": "Dual Overhead Cam (DOHC)",
 "Fuel Type - Secondary": "",
 "Fuel Delivery / Fuel Injection Type": "",
 "Engine Configuration": "In-Line",
 "Turbo": "Yes",
 "Engine Manufacturer": "BMW",
 "Engine Brake (hp) From": "300",
 "Cooling Type": "Water",
 "Electrification Level": "",
 "Other Engine Info": "",
 "Pretensioner": "Yes",
 "Seat Belt Type": "Manual",
 "Other Restraint System Info": "Head Inflatable Restraint for Driver, Front Passenger, Rear Outboard Driver-side and Rear Outboard Passenger-side. Knee Inflatable Restraint for Driver and Front Passenger. Pretensioners for Driver and Front Passenger.",
 "Curtain Air Bag Locations": "1st and 2nd Rows",
 "Front Air Bag Locations": "1st Row (Driver and Passenger)",
 "Knee Air Bag Locations": "1st Row (Driver and Passenger)",
 "Side Air Bag Locations": "1st Row (Driver and Passenger)",
 "Anti-lock Braking System (ABS)": "Standard",
 "Electronic Stability Control (ESC)": "Standard",
 "Traction Control": "Standard",
 "Tire Pressure Monitoring System (TPMS) Type": "Direct",
 "Auto-Reverse System for Windows and Sunroofs": "",
 "Event Data Recorder (EDR)": "",
 "Keyless Ignition": "",
 "Adaptive Cruise Control (ACC)": "",
 "Crash Imminent Braking (CIB)": "",
 "Forward Collision Warning (FCW)": "",
 "Dynamic Brake Support (DBS)": "",
 "Pedestrian Automatic Emergency Braking (PAEB)": "",
 "Blind Spot Warning (BSW)": "",
 "Lane Departure Warning (LDW)": "",
 "Lane Keeping Assistance (LKA)": "",
 "Blind Spot Intervention (BSI)": "",
 "Lane Centering Assistance": "",
 "Backup Camera": "",
 "Parking Assist": "",
 "Rear Cross Traffic Alert": "",
 "Rear Automatic Emergency Braking": "",
 "Automatic Crash Notification (ACN) / Advanced Automatic Crash Notification (AACN)": "",
 "Daytime Running Light (DRL)": "",
 "Headlamp Light Source": "",
 "Semiautomatic Headlamp Beam Switching": "",
 "Adaptive Driving Beam (ADB)": "",
 "NCSA Body Type": "4-door sedan, hardtop",
 "NCSA Make": "BMW",
 "NCSA Model": "5-series"
 },
 "timestamp": "2025-10-01T22:40:36.374Z"
 }
 ```
</codegroup>
 </col>
</row>
</div><div class="naked_ctrl">
<form action="/index.cgi/contrast" method="get" name="gate">
<p><a href="http://altstyle.alfasado.net">AltStyle</a> によって変換されたページ <a href="https://api.carsxe.com:443/api/markdown/docs/v1/specifications">(-&gt;オリジナル)</a>
/ <label>アドレス: <input type="text" name="naked_post_url" value="https://api.carsxe.com:443/api/markdown/docs/v1/specifications" size="22" /></label> <label>モード: <select name="naked_post_mode">
<option value="default">デフォルト</option>
<option value="speech">音声ブラウザ</option>
<option value="ruby">ルビ付き</option>
<option value="contrast" selected="selected">配色反転</option>
<option value="larger-text">文字拡大</option>
<option value="mobile">モバイル</option>
</select>
<input type="submit" value="表示" />
</p>
</form>
</div>