API Reference | DriveDecision

Base URL

https://api.drivedecision.com/v1

Authentication

All API requests require authentication via Bearer token. Include your API key in the Authorization header:

bash

Authorization: Bearer YOUR_API_KEY

Endpoints

Vehicles

Get vehicle information and listings

GET/vehiclesList all makes

GET/vehicles/{make}List models for a make

GET/vehicles/{make}/{model}Get model details

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

View full documentation

Complaints

Access vehicle complaint records

GET/complaints/{make}/{model}/{year}Get complaints

GET/complaints/{make}/{model}/{year}/categoriesBy category

GET/complaints/{id}Single complaint

View full documentation

Statistics

Aggregated reliability metrics

GET/statistics/{make}/{model}Model statistics

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

GET/statistics/compareCompare vehicles

View full documentation

Response Format

All responses follow a consistent JSON structure:

Success Response

{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "hasMore": true
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded your rate limit. Please upgrade your plan.",
    "retryAfter": 60
  }
}

Error Codes

Code	HTTP	Description
`INVALID_API_KEY`	401	API key is invalid or missing
`RATE_LIMIT_EXCEEDED`	429	Too many requests
`NOT_FOUND`	404	Resource not found
`INVALID_PARAMETER`	400	Invalid request parameter
`QUOTA_EXCEEDED`	403	Monthly quota exceeded
`INTERNAL_ERROR`	500	Server error