Auto.dev

OEM Build Data API

Retrieve complete vehicle build information including trim, colors, options, and MSRP data

Retrieve complete vehicle build information based on the VIN, including exact trim details, drivetrain, engine specifications, interior/exterior colors, factory options, and MSRP data. This comprehensive API provides the most detailed vehicle information available from OEM build records.

Endpoint

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

Parameters

PropTypeDefault
vin
string
-

Example Request

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

Response Structure

Example Response

{
  "build": {
    "vin": "WP0AF2A99KS165242",
    "year": 2019,
    "make": "Porsche",
    "model": "911",
    "trim": "GT3 RS Coupe",
    "series": "GT3 RS",
    "style": "2D Coupe",
    "drivetrain": "RWD",
    "engine": "4L H-6 gasoline direct injection, DOHC, VarioCam Plus variable valve control, premium unleaded, engine with 520HP",
    "transmission": "PDK 7-speed auto-shift manual",
    "confidence": 0.995,
    "interiorColor": {
      "Black": "#000000"
    },
    "exteriorColor": {
      "GT Silver Metallic": "#A2A2A2"
    },
    "options": {
      "474": "Front Axle Lift System",
      "QR5": "Chrono Package with Preparation For Lap Trigger",
      "U2": "GT Silver Metallic",
      "XDH": "Wheels Painted in Satin Platinum"
    },
    "optionsMsrp": 8950
  }
}

Use Cases

  • Appraisal Services: Factor in factory options and original colors for accurate vehicle valuations
  • Insurance Underwriting: Use confidence scores and build specifications for risk assessment
  • Parts & Service: Match exact factory option codes for correct parts ordering

Error Responses

Invalid VIN

{
  "status": 400,
  "error": "VIN must be exactly 17 characters containing only letters and numbers (excluding I, O, Q)",
  "code": "INVALID_VIN_FORMAT",
  "path": "/build/123Invalid",
  "requestId": "a1b2c3d4e5f6g7h8"
}

VIN Not Found

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

Plan Availability

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

See pricing for plan details and signup.

Was this API reference helpful?