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
Prop | Type | Default |
---|---|---|
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?