Vehicle Specifications API

Discover comprehensive vehicle specifications and decode vehicle identification numbers (VINs) effortlessly with CarsXE API. Get detailed information about any vehicle by querying its VIN. Explore the different endpoints available to manage contacts programmatically. Start leveraging the power of CarsXE to access accurate and up-to-date vehicle data.


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


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

Frequently asked questions

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": "2024-04-02T22:21:33.819Z"
}