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}

View in Browser

https://api.auto.dev/build/1FTFW3LDXRFB40317

Parameters

PropTypeDefault
vin
string
-

Example Request

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

Response Structure

Example Response

{
  "build": {
    "vin": "1FTFW3LDXRFB40317",
    "year": 2024,
    "make": "Ford",
    "model": "F-150",
    "trim": "XLT",
    "series": "XLT",
    "style": "4D SuperCrew",
    "drivetrain": "4WD",
    "engine": "3.5L V-6 gasoline direct injection, DOHC, twin turbocharged, regular unleaded, engine with 400HP",
    "transmission": "10-speed automatic",
    "confidence": 0.99,
    "interiorColor": {
      "Black Onyx": "#1C1C1C"
    },
    "exteriorColor": {
      "Iconic Silver Metallic": "#C0C0C0"
    },
    "options": {
      "53A": "XLT Mid Equipment Group",
      "99N": "Iconic Silver Metallic",
      "FX4": "FX4 Off-Road Package",
      "86M": "Trailer Tow Package"
    },
    "optionsMsrp": 4295
  }
}

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/1FTFW3LDXRFB40317",
  "requestId": "b2c3d4e5f6g7h8i9"
}

VIN Decode Failed

{
  "status": 400,
  "error": "Unable to decode vehicle information from VIN",
  "code": "VIN_DECODE_FAILED",
  "path": "/build/1FMDE0AP0SLA20048",
  "requestId": "976d19586b52612e"
}

Interactive API Reference

Ready to test this endpoint? Use our interactive API playground to make live requests and see real responses.

Try OEM Build Data API

Test this endpoint with your API key and explore live responses

Plan Availability

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

See pricing for plan details and signup.

Was this API reference helpful?