Skip to main content
DriveDecision™

Vehicles

Get vehicle information, available makes, models, and year ranges.

List All Makes

Returns a list of all vehicle manufacturers available in the database.

GET/vehicles

Example Request

bash
curl -X GET "https://api.drivedecision.com/v1/vehicles" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

json
{
  "success": true,
  "data": {
    "makes": [
      { "name": "Acura", "slug": "acura", "model_count": 15 },
      { "name": "Audi", "slug": "audi", "model_count": 22 },
      { "name": "BMW", "slug": "bmw", "model_count": 28 },
      { "name": "Chevrolet", "slug": "chevrolet", "model_count": 45 },
      { "name": "Ford", "slug": "ford", "model_count": 42 },
      { "name": "Honda", "slug": "honda", "model_count": 18 },
      { "name": "Toyota", "slug": "toyota", "model_count": 35 }
    ]
  },
  "meta": {
    "total": 25
  }
}

List Models for Make

Returns all models available for a specific manufacturer.

GET/vehicles/{make}

Path Parameters

makestringrequired

The manufacturer slug (e.g., "honda", "toyota")

Example Request

bash
curl -X GET "https://api.drivedecision.com/v1/vehicles/honda" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

json
{
  "success": true,
  "data": {
    "make": "Honda",
    "models": [
      { "name": "Accord", "slug": "accord", "years": [1990, 2024], "complaint_count": 1245 },
      { "name": "Civic", "slug": "civic", "years": [1985, 2024], "complaint_count": 2103 },
      { "name": "CR-V", "slug": "cr-v", "years": [1997, 2024], "complaint_count": 876 },
      { "name": "Pilot", "slug": "pilot", "years": [2003, 2024], "complaint_count": 543 }
    ]
  }
}

Get Model Details

Returns detailed information about a specific vehicle model, including year-by-year breakdown.

GET/vehicles/{make}/{model}

Path Parameters

makestringrequired

The manufacturer slug

modelstringrequired

The model slug (e.g., "civic", "accord")

Example Request

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

Response

json
{
  "success": true,
  "data": {
    "make": "Honda",
    "model": "Civic",
    "slug": "civic",
    "years_available": [1985, 1986, ..., 2023, 2024],
    "total_complaints": 2103,
    "reliability_rating": 8.1,
    "year_breakdown": [
      { "year": 2024, "complaints": 12, "rating": 9.2 },
      { "year": 2023, "complaints": 47, "rating": 8.8 },
      { "year": 2022, "complaints": 89, "rating": 8.2 },
      { "year": 2021, "complaints": 134, "rating": 7.5 },
      { "year": 2020, "complaints": 156, "rating": 7.2 }
    ],
    "most_common_issues": [
      { "category": "electrical", "percentage": 28.5 },
      { "category": "engine", "percentage": 22.1 },
      { "category": "transmission", "percentage": 15.8 }
    ]
  }
}

Get Specific Year

Returns detailed information for a specific make/model/year combination.

GET/vehicles/{make}/{model}/{year}

Path Parameters

makestringrequired

The manufacturer slug

modelstringrequired

The model slug

yearintegerrequired

The model year (e.g., 2023)

Query Parameters

includestring

Comma-separated fields to include: complaints, recalls, ratings

Example Request

bash
curl -X GET "https://api.drivedecision.com/v1/vehicles/honda/civic/2023?include=complaints,ratings" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

json
{
  "success": true,
  "data": {
    "make": "Honda",
    "model": "Civic",
    "year": 2023,
    "reliability_score": 8.8,
    "complaint_summary": {
      "total": 47,
      "categories": {
        "electrical": 15,
        "engine": 12,
        "brakes": 8,
        "transmission": 7,
        "other": 5
      }
    },
    "average_mileage_at_failure": 24500,
    "common_issues": [
      {
        "id": "issue_123",
        "category": "electrical",
        "description": "Infotainment system freezing and requiring restart",
        "frequency": "common",
        "avg_repair_cost": 450,
        "report_count": 8
      },
      {
        "id": "issue_124",
        "category": "engine",
        "description": "Engine hesitation during acceleration",
        "frequency": "occasional",
        "avg_repair_cost": 850,
        "report_count": 5
      }
    ]
  }
}