Auto.dev

Specifications API

Comprehensive vehicle specifications including engine details, features, measurements, and options by VIN

Get detailed vehicle specifications including engine details, features, measurements, colors, options, and complete technical data for any vehicle by VIN. Access comprehensive spec data organized by category for easy integration.

Endpoint

GET https://api.auto.dev/specs/{vin}

Parameters

PropTypeDefault
vin
string
-

Example Request

curl -X GET "https://api.auto.dev/specs/WP0AF2A99KS165242" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Structure

Example Response

{
  "vehicle": {
    "vin": "WP0AF2A99KS165242",
    "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
    }
  }
}

Feature Categories

The API returns comprehensive feature data organized into the following categories through the orderedFeatures array:

Use Cases

  • Vehicle Comparison Tools: Compare detailed specifications across multiple vehicles for purchase decisions with organized feature categories
  • Automotive Marketplaces: Display comprehensive vehicle features and specifications in listings with proper categorization
  • Configuration Builders: Help customers select vehicle options and packages based on available features and categories

Error Responses

Invalid VIN

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

VIN Not Found

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

Plan Availability

  • Starter: ❌ Not available
  • Growth: ✅ Available
  • Scale: ✅ Available

See pricing for plan details and signup.

Was this API reference helpful?