US Vehicle Plate Decoder

The US Vehicle Plate Decoder API provides access to a library of vehicle's data based on the vehicle's registration/license plate number and state.


The US Vehicle Plate Decoder API looks up the vehicle through the database for matches and returns the VIN, make, model and year among other attributes. It can be coupled with other APIs to become even more powerful. The state is a two letter abbreviation of one of the 50 states, or District of Columbia (DC), or Puerto Rico (PR).

All requests are made with API key, plate and state.

This endpoint allows you to retrieve US vehicle information based on license plates and registration numbers.

Required attributes

  • Name
    key
    Type
    string
    Description

    Your CarsXE API key.

  • Name
    plate
    Type
    string
    Description

    The vehicle registration number or license plate number.

  • Name
    state
    Type
    string
    Description

    The state is a two letter abbreviation of one of the 50 states, or District of Columbia (DC), or Puerto Rico (PR).

Optional attributes

  • Name
    decodeVIN
    Type
    boolean
    Description

    If set to true, the API will attempt to decode the VIN number and return the vehicle's information.

Response Attributes

  • Name
    success
    Type
    boolean
    Description

    Indicates whether the request was successful (e.g., true or false).

  • Name
    input
    Type
    object
    Description

    Contains the input parameters used in the request.

    • Name
      plate
      Type
      string
      Description

      The license plate of the vehicle (e.g., "H37SFS").

    • Name
      state
      Type
      string
      Description

      The state where the vehicle is registered (e.g., "NJ").

  • Name
    vin
    Type
    string
    Description

    The Vehicle Identification Number (VIN), a unique code identifying the specific vehicle (e.g., "1GNSCGKC0JR318026").

  • Name
    year
    Type
    string
    Description

    The manufacturing year of the vehicle (e.g., "2018").

  • Name
    make
    Type
    string
    Description

    The manufacturer of the vehicle (e.g., "Chevrolet").

  • Name
    model
    Type
    string
    Description

    The specific model name of the vehicle (e.g., "Suburban").

  • Name
    trim
    Type
    string
    Description

    The trim level or configuration of the vehicle (e.g., "LS").

  • Name
    name
    Type
    string
    Description

    A brief description of the vehicle, including the year, make, and model (e.g., "2018 Chevrolet Suburban").

  • Name
    engine
    Type
    string
    Description

    The engine's displacement and type, indicating its size and configuration (e.g., "5.3L V8 OHV 16V").

  • Name
    style
    Type
    string
    Description

    A detailed description of the vehicle's body style (e.g., "SUV").

  • Name
    transmission
    Type
    string
    Description

    The type of transmission system the vehicle uses, such as manual or automatic (e.g., "Automatic").

  • Name
    driveType
    Type
    string
    Description

    The drive configuration of the vehicle, such as front-wheel drive (FWD), rear-wheel drive (RWD), or all-wheel drive (AWD) (e.g., "RWD").

  • Name
    fuel
    Type
    string
    Description

    The type of fuel the vehicle uses (e.g., "Flexible-Fuel").

  • Name
    color
    Type
    string
    Description

    The exterior color of the vehicle (e.g., "Black").

  • Name
    vehicle_specs
    Type
    object
    Description

    Contains detailed specifications of the vehicle. The full response matches that of the Vehicle Specifications API.

Gyakran ismételt kérdések

Request

GET
/v1/us-platedecoder
curl -G https://api.carsxe.com/v1/us-platedecoder \
  -d key=CARSXE_API_KEY \
  -d plate=H37SFS \
  -d state=NJ
  -d decodeVIN=true

Response

{
    "success": true,
    "input": {
        "plate": "H37SFS",
        "state": "NJ"
    },
    "vin": "1GNSCGKC0JR318026",
    "year": "2018",
    "make": "Chevrolet",
    "model": "Suburban",
    "trim": "LS",
    "description": "2018 Chevrolet Suburban",
    "engine_size": "5.3L V8 OHV 16V",
    "body_style": "SUV",
    "transmission": "Automatic",
    "drive_type": "RWD",
    "fuel_type": "Flexible-Fuel",
    "color": "Black",
    "vehicle_specs": {
        "attributes": {
            "year": "2018",
            "make": "Chevrolet",
            "model": "Suburban",
            "trim": "LS 2WD",
            "style": "SPORT UTILITY 4-DR",
            "type": "",
            "size": "",
            "category": "",
            "made_in": "UNITED STATES",
            "made_in_city": "",
            "doors": "",
            "fuel_type": "",
            "fuel_capacity": "31.00 gallon",
            "city_mileage": "16 miles/gallon",
            "highway_mileage": "23 miles/gallon",
            "engine": "5.3L V8 OHV 16V",
            "engine_size": "",
            "engine_cylinders": "",
            "transmission": "6-Speed Automatic",
            "transmission_short": "6A",
            "transmission_type": "",
            "transmission_speeds": "",
            "drivetrain": "RWD",
            "anti_brake_system": "4-Wheel ABS",
            "steering_type": "R&P",
            "curb_weight": "",
            "gross_vehicle_weight_rating": "",
            "overall_height": "74.40 in.",
            "overall_length": "224.40 in.",
            "overall_width": "80.50 in.",
            "wheelbase_length": "130.00 in.",
            "standard_seating": "8",
            "invoice_price": "$47,141 USD",
            "delivery_charges": "$1,295 USD",
            "manufacturer_suggested_retail_price": "$50,150 USD",
            "production_seq_number": "318026",
            "front_brake_type": "Disc",
            "rear_brake_type": "Disc",
            "turning_diameter": "",
            "front_suspension": "Ind",
            "rear_suspension": "Ind",
            "front_spring_type": "",
            "rear_spring_type": "",
            "tires": "P265/65R18",
            "front_headroom": "42.80 in.",
            "rear_headroom": "39.10 in.",
            "front_legroom": "45.30 in.",
            "rear_legroom": "39.70 in.",
            "front_shoulder_room": "64.80 in.",
            "rear_shoulder_room": "65.10 in.",
            "front_hip_room": "60.80 in.",
            "rear_hip_room": "60.30 in.",
            "interior_trim": [
                "Cocoa/Dune, cloth",
                "Jet Black, cloth"
            ],
            "exterior_color": [
                "Black",
                "Blue Velvet Metallic",
                "Havana Metallic",
                "Iridescent Pearl Tricoat",
                "Pepperdust Metallic",
                "Satin Steel Metallic",
                "Silver Ice Metallic",
                "Siren Red Tintcoat",
                "Summit White",
                "Tungsten Metallic"
            ],
            "curb_weight_manual": "",
            "ground_clearance": "7.90 in.",
            "track_front": "",
            "track_rear": "",
            "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": ""
        },
        "colors": [
            {
                "category": "Interior",
                "name": "Cocoa/Dune, cloth"
            },
            {
                "category": "Interior",
                "name": "Jet Black, cloth"
            },
            {
                "category": "Exterior",
                "name": "Black"
            },
            {
                "category": "Exterior",
                "name": "Blue Velvet Metallic"
            },
            {
                "category": "Exterior",
                "name": "Havana Metallic"
            },
            {
                "category": "Exterior",
                "name": "Iridescent Pearl Tricoat"
            },
            {
                "category": "Exterior",
                "name": "Pepperdust Metallic"
            },
            {
                "category": "Exterior",
                "name": "Satin Steel Metallic"
            },
            {
                "category": "Exterior",
                "name": "Silver Ice Metallic"
            },
            {
                "category": "Exterior",
                "name": "Siren Red Tintcoat"
            },
            {
                "category": "Exterior",
                "name": "Summit White"
            },
            {
                "category": "Exterior",
                "name": "Tungsten Metallic"
            }
        ],
        "equipment": {
            "4wd_awd": "N/A",
            "abs_brakes": "Std.",
            "adjustable_foot_pedals": "N/A",
            "air_conditioning": "N/A",
            "alloy_wheels": "Std.",
            "am_fm_radio": "N/A",
            "automatic_headlights": "N/A",
            "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": "N/A",
            "cd_player": "N/A",
            "child_safety_door_locks": "Std.",
            "chrome_wheels": "N/A",
            "cruise_control": "Std.",
            "daytime_running_lights": "N/A",
            "deep_tinted_glass": "N/A",
            "driver_airbag": "Std.",
            "driver_multi_adjustable_power_seat": "Std.",
            "dvd_player": "N/A",
            "electrochromic_exterior_rearview_mirror": "N/A",
            "electrochromic_interior_rearview_mirror": "N/A",
            "electronic_brake_assistance": "N/A",
            "electronic_parking_aid": "N/A",
            "first_aid_kit": "N/A",
            "fog_lights": "N/A",
            "front_air_dam": "N/A",
            "front_cooled_seat": "N/A",
            "front_heated_seat": "N/A",
            "front_power_lumbar_support": "Std.",
            "front_power_memory_seat": "N/A",
            "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": "N/A",
            "glass_rear_window_on_convertible": "N/A",
            "heated_exterior_mirror": "N/A",
            "heated_steering_wheel": "N/A",
            "high_intensity_discharge_headlights": "N/A",
            "interval_wipers": "N/A",
            "keyless_entry": "N/A",
            "leather_seat": "N/A",
            "leather_steering_wheel": "N/A",
            "limited_slip_differential": "N/A",
            "load_bearing_exterior_rack": "N/A",
            "locking_differential": "N/A",
            "locking_pickup_truck_tailgate": "N/A",
            "manual_sunroof": "N/A",
            "navigation_aid": "N/A",
            "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": "N/A",
            "power_door_locks": "N/A",
            "power_sliding_side_van_door": "N/A",
            "power_sunroof": "N/A",
            "power_trunk_lid": "N/A",
            "power_windows": "Std.",
            "rain_sensing_wipers": "N/A",
            "rear_spoiler": "N/A",
            "rear_window_defogger": "N/A",
            "rear_wiper": "N/A",
            "remote_ignition": "N/A",
            "removable_top": "N/A",
            "run_flat_tires": "N/A",
            "running_boards": "N/A",
            "second_row_folding_seat": "N/A",
            "second_row_heated_seat": "N/A",
            "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": "N/A",
            "separate_driver_front_passenger_climate_controls": "N/A",
            "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": "N/A",
            "subwoofer": "N/A",
            "tachometer": "N/A",
            "telematics_system": "N/A",
            "telescopic_steering_column": "N/A",
            "third_row_removable_seat": "N/A",
            "tilt_steering": "N/A",
            "tilt_steering_column": "N/A",
            "tire_pressure_monitor": "N/A",
            "tow_hitch_receiver": "N/A",
            "traction_control": "N/A",
            "trip_computer": "N/A",
            "trunk_anti_trap_device": "N/A",
            "vehicle_anti_theft": "Std.",
            "vehicle_stability_control_system": "N/A",
            "voice_activated_telephone": "N/A",
            "wind_deflector_for_convertibles": "N/A"
        },
        "warranties": [
            {
                "type": "Basic",
                "miles": "36,000 mile",
                "months": "36 month"
            },
            {
                "type": "Powertrain",
                "miles": "60,000 mile",
                "months": "60 month"
            },
            {
                "type": "Rust",
                "months": "72 month",
                "miles": "100,000 mile"
            }
        ]
    }
}