Specifications

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).

GET/specs

Vehicle Specifications

This endpoint allows you to retrieve vehicle data from a Vehicle's Identification Number.

Required attributes

Name
key
Type
string
Description
Your CarsXE API key.
Name
vin
Type
string
Description
The 17 character long vehicle identification number.

Optional attributes

Name
format
Type
string
Description
The format of the response. One of json or xml. Defaults to json.
Name
deepdata
Type
string
Description
Request for extra data. Set to 1 to use. Significantly slower than the regular request but will retrieve additional data.

Response attributes

Name
input
Type
object
Description
Contains the input parameters specified by the query.
Name
attributes
Type
object
Description
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).
Name
colors
Type
array
Description
A list of objects with details about available color options based on the vehicle’s year, make, and model.
Name
equipment
Type
object
Description
Details about a vehicle’s equipment based on the vehicle’s year, make, and model.
Name
warranties
Type
array
Description
List of objects containing standard vehicle warranties available by type, miles and months.
Name
deepdata
Type
object
Description
More information on the vehicle from our deep data search.
Name
success
Type
boolean
Description
More information on the vehicle from our deep data search.
Name
error
Type
string
Description
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

FAQ

Title
What VINs can I use for testing?
▼
You may be use the following VINs for test:
- WBAFR7C57CC811956
Title
Is the Vehicle Specifications API included in the free trial?
▼
Yes! The Vehicle Specifications API is included in the 7-day free trial. For more information visit our pricing page.

Request

GET

/specs

curl -G https://api.carsxe.com/specs \
  -d key=CARSXE_API_KEY \
  -d vin=WBAFR7C57CC811956

Response

{
  success: true,
  input: {
    key: "API_KEY",
    vin: "WBAFR7C57CC811956",
  },
  attributes: {
    year: "2012",
    make: "BMW",
    model: "5-Series",
    trim: "535i",
    style: "SEDAN 4-DR",
    type: "",
    size: "",
    category: "",
    made_in: "GERMANY",
    made_in_city: "",
    doors: "",
    fuel_type: "",
    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: "",
    transmission: "6-Speed Manual | 8-Speed Automatic",
    transmission_short: "6M | 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: "",
    standard_towing: "",
    maximum_towing: "",
    standard_payload: "",
    maximum_payload: "",
    maximum_gvwr: "",
  },
  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",
    },
  ],
  timestamp: new Date().toISOString(),
}