Reference

Get Vehicle Specifications

Read the guide

Get detailed vehicle specifications including engine details, features, measurements, colors, options, and complete technical data for any vehicle by VIN.

GET
/specs/{vin}

Authorization

AuthorizationBearer <token>

Use your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY

In: header

Path Parameters

vinstring

17-character Vehicle Identification Number

Match^[A-HJ-NPR-Z0-9]{17}$

Query Parameters

ambiguity?boolean

Whether to allow a best-guess answer for a VIN that matches several styles. By default (false) the answer does not guess: style is null, trim is null unless our sources settle it (specs is null on /specs), and trims and styles list the possibilities. true allows a single best-guess pick. Also accepted as the X-Ambiguity header.

Defaultfalse

Response Body

curl -X GET "https://api.auto.dev/specs/string?ambiguity=false"

{
  "vehicle": {
    "vin": "1FTFW3LDXRFB40317",
    "year": 2019,
    "make": "Porsche",
    "model": "911",
    "manufacturer": "Dr Ing HCF Porsch Ag"
  },
  "specs": {
    "name": "GT3 RS 2dr Coupe (4.0L 6cyl 7AM)",
    "price": {
      "baseMsrp": 187500,
      "baseInvoice": 168750
    },
    "totalSeating": 2,
    "color": {
      "exterior": [
        {
          "name": "Lizard Green",
          "rgb": "87,178,44"
        },
        {
          "name": "Miami Blue",
          "rgb": "3,161,192"
        },
        {
          "name": "Racing Yellow",
          "rgb": "229,200,38"
        },
        {
          "name": "Guards Red",
          "rgb": "175,26,28"
        }
      ],
      "interior": [
        {
          "name": "Black, leather/sueded microfiber",
          "rgb": "0,0,0"
        },
        {
          "name": "Black/Lizard Green, leather/sueded microfiber",
          "rgb": "0,0,0"
        }
      ]
    },
    "features": {
      "engine": {
        "torque": "346 lb-ft @ 6000 rpm",
        "baseEngineSize": "4.0 L",
        "horsepower": "520 hp @ 8250 rpm",
        "valves": "24",
        "baseEngineType": "gas",
        "directInjection": true,
        "valveTiming": "Variable",
        "cylinders": "flat 6",
        "camType": "Double overhead cam (DOHC)"
      },
      "fuel": {
        "epaCombinedMpg": "16 MPG",
        "epaCity/highwayMpg": "15/19 MPG",
        "rangeInMiles (city/hwy)": "253.5/321.1 mi.",
        "fuelTankCapacity": "16.9 gal.",
        "fuelType": "premium unleaded (required)"
      },
      "measurements": {
        "maximumCargoCapacity": "4.4 cu.ft.",
        "countryOfFinalAssembly": "Germany",
        "wheelbase": "96.6 in.",
        "curbWeight": "3153 lbs.",
        "grossWeight": "3953 lbs.",
        "cargoCapacity,AllSeatsInPlace": "4.4 cu.ft.",
        "maximumPayload": "800 lbs.",
        "overallWidthWithMirrors": "77.9 in.",
        "length": "179.4 in.",
        "manufacturer060MphAccelerationTime": "3.0 seconds",
        "turningCircle": "36.4 ft.",
        "height": "51.1 in.",
        "overallWidthWithoutMirrors": "74.0 in."
      },
      "driveTrain": {
        "driveType": "rear wheel drive",
        "rearLockingDifferential": true,
        "rearLimitedSlipDifferential": true,
        "transmission": "7-speed automated manual"
      },
      "warranty": {
        "basic": "4 yr./ 50000 mi.",
        "drivetrain": "4 yr./ 50000 mi.",
        "freeMaintenance": "1 yr./ 10000 mi.",
        "rust": "12 yr./ unlimited mi.",
        "roadsideAssistance": "4 yr./ 50000 mi."
      },
      "safety": {
        "4WheelAbs": true,
        "daytimeRunningLights": true,
        "engineImmobilizer": true,
        "postCollisionSafetySystem": true,
        "frontHeadAirbags": true,
        "dualFrontSideMountedAirbags": true,
        "passengerAirbagOccupantSensingDeactivation": true,
        "stabilityControl": true,
        "tirePressureMonitoring": true,
        "tractionControl": true
      },
      "frontseats": {
        "heightAdjustablePassengerSeat": true,
        "heightAdjustableDriverSeat": true,
        "sportFrontSeats": true,
        "2WayPowerPassengerSeat": true,
        "leather/suededMicrofiber": true,
        "2WayPowerDriverSeat": true
      }
    },
    "orderedFeatures": [
      {
        "category": "Fuel",
        "categoryGroup": "Mechanical",
        "features": {
          "fuelType": "Premium unleaded (required)",
          "epaCity/highwayMpg": "15/19 MPG",
          "epaCombinedMpg": "16 MPG",
          "rangeInMiles (city/hwy)": "253.5/321.1 mi.",
          "fuelTankCapacity": "16.9 gal."
        }
      },
      {
        "category": "Engine",
        "categoryGroup": "Mechanical",
        "features": {
          "baseEngineSize": "4.0 L",
          "cylinders": "Flat 6",
          "baseEngineType": "Gas",
          "horsepower": "520 hp @ 8250 rpm",
          "torque": "346 lb-ft @ 6000 rpm",
          "valves": "24",
          "camType": "Double overhead cam (DOHC)",
          "valveTiming": "Variable",
          "directInjection": true
        }
      }
    ],
    "typeCategories": {
      "performancesports": {
        "id": 10,
        "name": "Performance/Sports"
      },
      "coupe": {
        "id": 2,
        "name": "Coupe"
      },
      "luxury": {
        "id": 8,
        "name": "Luxury"
      }
    },
    "styleAttributes": {
      "electric": false,
      "pluginElectric": false,
      "truck": false
    }
  }
}

{
  "vehicle": {
    "vin": "1HD1BWV10GB016330",
    "year": 2016,
    "make": "HARLEY-DAVIDSON",
    "model": "FLSTC103 / Heritage Softail Classic",
    "manufacturer": "Harley-Davidson Motor Co"
  },
  "specs": {
    "name": "2016 HARLEY-DAVIDSON Heritage Softail Classic FLSTC103",
    "price": null,
    "totalSeating": null,
    "color": null,
    "typeCategories": null,
    "styleAttributes": null,
    "orderedFeatures": null,
    "features": {
      "engine": {
        "torque": "",
        "baseEngineSize": "1.69L",
        "horsepower": "",
        "valves": "",
        "baseEngineType": "Gasoline",
        "directInjection": false,
        "valveTiming": "",
        "cylinders": "2",
        "camType": ""
      },
      "fuel": {
        "epaCombinedMpg": "",
        "epaCityHighwayMpg": "",
        "rangeInMilesCityHwy": "",
        "fuelTankCapacity": "",
        "fuelType": "Gasoline"
      },
      "driveTrain": {
        "driveType": "",
        "centerLimitedSlipDifferential": false,
        "transmission": ""
      },
      "measurements": {
        "maximumCargoCapacity": "",
        "countryOfFinalAssembly": "UNITED STATES (USA)",
        "wheelbase": "",
        "curbWeight": "",
        "grossWeight": "Class 1A: 3,000 lb or less (1,360 kg or less)",
        "cargoCapacityAllSeatsInPlace": "",
        "maximumPayload": "",
        "length": "",
        "maximumTowingCapacity": "",
        "turningCircle": "",
        "height": "",
        "overallWidthWithoutMirrors": ""
      },
      "frontseats": {
        "frontHeadRoom": "",
        "premiumCloth": false,
        "bucketFrontSeats": false,
        "the4WayManualPassengerSeatAdjustment": false,
        "heightAdjustableDriverSeat": false,
        "frontShoulderRoom": "",
        "driverSeatWithPowerAdjustableLumbarSupport": false,
        "the8WayPowerDriverSeat": false,
        "frontLegRoom": "",
        "frontHipRoom": ""
      },
      "rearseats": {},
      "warranty": {
        "basic": "",
        "drivetrain": "",
        "freeMaintenance": "",
        "rust": "",
        "roadsideAssistance": ""
      },
      "suspension": {},
      "tiresAndWheels": {},
      "powerFeature": {},
      "mechanicalOptions": {},
      "comfortConvenience": {},
      "exteriorOptions": {},
      "interiorOptions": {},
      "instrumentation": {
        "clock": false,
        "compass": false,
        "externalTemperatureDisplay": false,
        "tripComputer": false,
        "tachometer": false
      },
      "inCarEntertainment": {},
      "packages": {},
      "telematics": {},
      "safety": {}
    }
  },
  "missing": [
    {
      "field": "price",
      "reason": "no_vin_record"
    },
    {
      "field": "totalSeating",
      "reason": "no_vin_record"
    },
    {
      "field": "color",
      "reason": "no_vin_record"
    },
    {
      "field": "typeCategories",
      "reason": "no_vin_record"
    },
    {
      "field": "styleAttributes",
      "reason": "no_vin_record"
    },
    {
      "field": "orderedFeatures",
      "reason": "no_vin_record"
    }
  ],
  "reason": "class_not_covered",
  "retryable": false
}

{
  "status": 400,
  "error": "VIN must be 17 characters long",
  "code": "INVALID_VIN_FORMAT",
  "path": "/specs/123Invalid",
  "requestId": "966d9900bef4356c-IAD"
}

{
  "status": 404,
  "error": "No vehicle data found for the provided VIN",
  "code": "VIN_NOT_FOUND",
  "path": "/specs/1FTFW3LDXRFB40317",
  "requestId": "f8g7h6i5j4k3l2m1"
}

Get Vehicle Photos

Previous Page

Get Vehicle Recalls

Next Page