API Reference | DriveDecision

Get Model Statistics

Returns aggregated reliability statistics for a specific vehicle model across all years.

GET/statistics/{make}/{model}

Path Parameters

makestringrequired

The manufacturer slug

modelstringrequired

The model slug

Query Parameters

year_frominteger

Start year for analysis (default: all available)

year_tointeger

End year for analysis (default: current year)

Example Request

bash

curl -X GET "https://api.drivedecision.com/v1/statistics/honda/civic?year_from=2020&year_to=2024" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

json

{
  "success": true,
  "data": {
    "vehicle": {
      "make": "Honda",
      "model": "Civic"
    },
    "period": {
      "from": 2020,
      "to": 2024
    },
    "overall_score": 8.1,
    "total_complaints": 438,
    "average_complaints_per_year": 87.6,
    "reliability_trend": "improving",
    "trend_percentage": 12.5,
    "category_breakdown": {
      "electrical": { "count": 125, "percentage": 28.5, "trend": "stable" },
      "engine": { "count": 97, "percentage": 22.1, "trend": "improving" },
      "transmission": { "count": 69, "percentage": 15.8, "trend": "stable" },
      "brakes": { "count": 54, "percentage": 12.3, "trend": "improving" },
      "other": { "count": 93, "percentage": 21.2, "trend": "stable" }
    },
    "mileage_analysis": {
      "avg_failure_mileage": 45200,
      "median_failure_mileage": 38500,
      "most_problematic_range": "30000-50000"
    },
    "repair_cost_analysis": {
      "avg_repair_cost": 875,
      "median_repair_cost": 550,
      "expensive_repairs_percentage": 15.2
    }
  }
}

Get Reliability Trends

Returns year-over-year reliability trends showing how the vehicle has improved or degraded over time.

GET/statistics/{make}/{model}/trends

Example Request

bash

curl -X GET "https://api.drivedecision.com/v1/statistics/honda/civic/trends" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

json

{
  "success": true,
  "data": {
    "vehicle": {
      "make": "Honda",
      "model": "Civic"
    },
    "yearly_trends": [
      { "year": 2024, "score": 9.2, "complaints": 12, "trend": "excellent" },
      { "year": 2023, "score": 8.8, "complaints": 47, "trend": "good" },
      { "year": 2022, "score": 8.2, "complaints": 89, "trend": "good" },
      { "year": 2021, "score": 7.5, "complaints": 134, "trend": "average" },
      { "year": 2020, "score": 7.2, "complaints": 156, "trend": "average" },
      { "year": 2019, "score": 8.5, "complaints": 98, "trend": "good" },
      { "year": 2018, "score": 8.1, "complaints": 112, "trend": "good" }
    ],
    "generation_analysis": [
      {
        "generation": "11th (2022-present)",
        "avg_score": 8.7,
        "total_complaints": 148,
        "notable_issues": ["Infotainment bugs", "Sensor calibration"]
      },
      {
        "generation": "10th (2016-2021)",
        "avg_score": 7.8,
        "total_complaints": 1245,
        "notable_issues": ["CVT issues", "AC problems", "Oil dilution"]
      }
    ],
    "recommendation": {
      "best_years": [2024, 2023, 2019],
      "years_to_avoid": [2020, 2021],
      "reasoning": "2020-2021 had higher than average transmission complaints. 2022+ redesign addressed most issues."
    }
  }
}

Compare Vehicles

Compare reliability metrics between two or more vehicles. Useful for helping users make purchasing decisions.

GET/statistics/compare

Query Parameters

vehiclesstringrequired

Comma-separated list of vehicles in format make/model/year (e.g., "honda/civic/2023,toyota/corolla/2023")

categoriesstring

Comma-separated categories to compare (default: all)

Example Request

bash

curl -X GET "https://api.drivedecision.com/v1/statistics/compare?vehicles=honda/civic/2023,toyota/corolla/2023,mazda/mazda3/2023" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

json

{
  "success": true,
  "data": {
    "comparison": [
      {
        "vehicle": {
          "make": "Honda",
          "model": "Civic",
          "year": 2023
        },
        "reliability_score": 8.8,
        "total_complaints": 47,
        "rank": 2,
        "strengths": ["Engine reliability", "Fuel economy", "Build quality"],
        "weaknesses": ["Infotainment bugs", "Road noise"],
        "category_scores": {
          "engine": 9.2,
          "transmission": 8.5,
          "electrical": 7.8,
          "brakes": 9.0,
          "overall": 8.8
        }
      },
      {
        "vehicle": {
          "make": "Toyota",
          "model": "Corolla",
          "year": 2023
        },
        "reliability_score": 9.1,
        "total_complaints": 32,
        "rank": 1,
        "strengths": ["Overall reliability", "Low maintenance cost", "Resale value"],
        "weaknesses": ["Underpowered engine", "Basic interior"],
        "category_scores": {
          "engine": 9.5,
          "transmission": 9.2,
          "electrical": 8.8,
          "brakes": 9.1,
          "overall": 9.1
        }
      },
      {
        "vehicle": {
          "make": "Mazda",
          "model": "Mazda3",
          "year": 2023
        },
        "reliability_score": 8.5,
        "total_complaints": 58,
        "rank": 3,
        "strengths": ["Driving dynamics", "Interior quality", "Styling"],
        "weaknesses": ["Rear visibility", "Infotainment learning curve"],
        "category_scores": {
          "engine": 8.8,
          "transmission": 8.6,
          "electrical": 8.0,
          "brakes": 8.5,
          "overall": 8.5
        }
      }
    ],
    "recommendation": {
      "best_overall": "toyota/corolla/2023",
      "best_value": "honda/civic/2023",
      "most_fun_to_drive": "mazda/mazda3/2023",
      "summary": "Toyota Corolla leads in pure reliability. Honda Civic offers the best balance of features and reliability. Mazda3 is ideal for drivers prioritizing engagement over absolute dependability."
    }
  }
}