VINaudit · Schema

VINaudit Vehicle Ownership Cost

JSON Schema for the VINaudit Vehicle Ownership Cost API response, returning itemized 5-year cost projections for depreciation, insurance, fuel, maintenance, repairs, and fees.

Vehicle HistoryVIN DecodingAutomotiveNMVTISVehicle SpecificationsMarket ValueRecall DataREST

Properties

Name Type Description
vin string Vehicle Identification Number
mileage_start integer Current vehicle mileage; -1 if unknown
mileage_year integer Annual mileage estimate used in fuel and maintenance calculations
vehicle string Full vehicle description (Year Make Model Trim)
depreciation_cost array Yearly depreciation costs (5 values, one per year)
insurance_cost array Yearly insurance costs (5 values, one per year)
fuel_cost array Yearly fuel costs (5 values, one per year)
maintenance_cost array Yearly routine maintenance costs (5 values, one per year)
repairs_cost array Yearly repair costs (5 values, one per year)
fees_cost array Yearly state fees and taxes (5 values, one per year)
total_cost array Yearly total costs (5 values, one per year)
total_cost_sum number Cumulative 5-year total cost of ownership
success boolean Whether the ownership cost calculation was successful
error string Error message or empty string if successful
View JSON Schema on GitHub

JSON Schema

vinaudit-vehicle-ownership-cost-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/vinaudit/main/json-schema/vinaudit-vehicle-ownership-cost-schema.json",
  "title": "VINaudit Vehicle Ownership Cost",
  "description": "JSON Schema for the VINaudit Vehicle Ownership Cost API response, returning itemized 5-year cost projections for depreciation, insurance, fuel, maintenance, repairs, and fees.",
  "type": "object",
  "properties": {
    "vin": {
      "type": "string",
      "description": "Vehicle Identification Number",
      "pattern": "^[A-HJ-NPR-Z0-9]{17}$"
    },
    "mileage_start": {
      "type": "integer",
      "description": "Current vehicle mileage; -1 if unknown"
    },
    "mileage_year": {
      "type": "integer",
      "description": "Annual mileage estimate used in fuel and maintenance calculations",
      "default": 15000,
      "minimum": 0
    },
    "vehicle": {
      "type": "string",
      "description": "Full vehicle description (Year Make Model Trim)"
    },
    "depreciation_cost": {
      "type": "array",
      "description": "Yearly depreciation costs (5 values, one per year)",
      "items": { "type": "number", "minimum": 0 },
      "minItems": 5,
      "maxItems": 5
    },
    "insurance_cost": {
      "type": "array",
      "description": "Yearly insurance costs (5 values, one per year)",
      "items": { "type": "number", "minimum": 0 },
      "minItems": 5,
      "maxItems": 5
    },
    "fuel_cost": {
      "type": "array",
      "description": "Yearly fuel costs (5 values, one per year)",
      "items": { "type": "number", "minimum": 0 },
      "minItems": 5,
      "maxItems": 5
    },
    "maintenance_cost": {
      "type": "array",
      "description": "Yearly routine maintenance costs (5 values, one per year)",
      "items": { "type": "number", "minimum": 0 },
      "minItems": 5,
      "maxItems": 5
    },
    "repairs_cost": {
      "type": "array",
      "description": "Yearly repair costs (5 values, one per year)",
      "items": { "type": "number", "minimum": 0 },
      "minItems": 5,
      "maxItems": 5
    },
    "fees_cost": {
      "type": "array",
      "description": "Yearly state fees and taxes (5 values, one per year)",
      "items": { "type": "number", "minimum": 0 },
      "minItems": 5,
      "maxItems": 5
    },
    "total_cost": {
      "type": "array",
      "description": "Yearly total costs (5 values, one per year)",
      "items": { "type": "number", "minimum": 0 },
      "minItems": 5,
      "maxItems": 5
    },
    "total_cost_sum": {
      "type": "number",
      "description": "Cumulative 5-year total cost of ownership",
      "minimum": 0
    },
    "success": {
      "type": "boolean",
      "description": "Whether the ownership cost calculation was successful"
    },
    "error": {
      "type": "string",
      "description": "Error message or empty string if successful"
    }
  },
  "required": ["success"]
}