RESTful Car Data API

Cars API

Q: How do I filter cars by make, model, year, or body type?

Use query parameters on the GET /api/v1/cars endpoint. For example: ?make=Toyota to filter by make, ?year_min=2020&year_max=2024 for a year range, ?body=SUV for body type, or combine multiple filters like ?make=Honda&body=Sedan&year_min=2022. All parameters can be used together.

Access 562 cars from 53 makes -- including 57+ electric and hybrid vehicles -- via a RESTful JSON API. Filter by make, model, year, body type, fuel type, drivetrain, and more.

Get Cars API Access View All APIs

Available Data Fields

Every car record returned by the API includes the following specification fields.

make model year trim body type fuel_type_name drive_type engine_displacement cylinders doors compatible tire sizes

API Endpoints

Query the car database using these RESTful endpoints. All responses are JSON with pagination support.

GET

/api/v1/cars

List all cars with pagination. Returns 20 results per page by default.

GET

/api/v1/cars/{uuid}

Get a single car by its UUID. Returns full specifications including compatible tire sizes.

GET

/api/v1/cars?make=Toyota

Filter cars by manufacturer. Returns all Toyota vehicles with pagination.

GET

/api/v1/cars?year_min=2020&year_max=2024

Filter by model year range. Supports min, max, or both for flexible year queries.

GET

/api/v1/cars?ev_only=1

Filter for electric and hybrid vehicles only. Returns BEV, PHEV, and HEV cars.

GET

/api/v1/cars?body=SUV

Filter by body type. Supports Sedan, SUV, Truck, Coupe, Hatchback, Wagon, Convertible, and more.

Example API Response

Each car object in the JSON response includes full specifications and metadata.

GET /api/v1/cars?make=Tesla&year_min=2024

{
  "data": [
    {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "make": "Tesla",
      "model": "Model Y",
      "year": 2024,
      "trim": "Long Range AWD",
      "body": "SUV",
      "fuel_type_name": "BATTERY ELECTRIC VEHICLE (BEV)",
      "drive_type": "AWD",
      "engine_displacement": null,
      "cylinders": null,
      "doors": 4,
      "tire_sizes": [
        "255/45R19",
        "255/40R20"
      ]
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 20,
    "total": 3
  }
}

Query Parameters

Use these parameters to filter, search, and paginate car results. All parameters are optional and can be combined.

Parameter	Type	Description
`make`	string	Filter by manufacturer name (e.g., Toyota, Ford, Tesla)
`model`	string	Filter by model name (e.g., Camry, F-150, Model Y)
`year_min`	integer	Minimum model year (inclusive)
`year_max`	integer	Maximum model year (inclusive)
`body`	string	Filter by body type (e.g., Sedan, SUV, Truck, Coupe, Hatchback)
`fuel_type`	string	Filter by fuel type name (e.g., GASOLINE, DIESEL, BATTERY ELECTRIC)
`drive_type`	string	Filter by drivetrain (e.g., FWD, RWD, AWD, 4WD)
`ev_only`	boolean	Set to 1 to return only electric and hybrid vehicles (BEV, PHEV, HEV)
`page`	integer	Page number for paginated results (default: 1)
`per_page`	integer	Results per page, max 100 (default: 20)

Cars API FAQ

Common questions about VehDB's Cars API.

The Cars API returns comprehensive specifications for each vehicle including: make, model, year, trim, body type, fuel_type_name, drive_type, engine_displacement, cylinders, doors, and compatible tire sizes. Each car is identified by a unique UUID for secure, stable references.

Use query parameters on the GET /api/v1/cars endpoint. For example: ?make=Toyota to filter by make, ?year_min=2020&year_max=2024 for a year range, ?body=SUV for body type, or combine multiple filters like ?make=Honda&body=Sedan&year_min=2022. All parameters can be used together.

Yes. The Cars API includes 57+ electric and hybrid vehicles. Use the ?ev_only=1 parameter to filter exclusively for battery electric (BEV), plug-in hybrid (PHEV), and traditional hybrid (HEV) vehicles. You can also filter by specific fuel types using the ?fuel_type parameter.

The Cars API returns JSON responses with paginated results. Each response includes a data array of car objects with full specifications, plus pagination metadata (current_page, last_page, per_page, total). Individual car lookups by UUID return a single car object with all fields.

Sign up for a VehDB account and choose a plan that includes API access. You'll receive an API key to authenticate your requests. Then make GET requests to https://vehdb.com/api/v1/cars with your API key in the Authorization header. The API supports filtering, pagination, and individual car lookups by UUID. See the API documentation for full details.

Explore More VehDB APIs

Access data for motorcycles, boats, and tire sizes through our other API endpoints.

Motorcycles API

Query motorcycle specifications by make, model, year, and type. Sport bikes, cruisers, touring, and more.

Boats API

Access power boat data including length, horsepower, hull type, and fuel specifications.

Tire Sizes API

Look up OEM and alternative tire sizes by vehicle make, model, and year via the API.

Back to API Overview

Get Cars API Access

Start building with 562 car specifications from 53 manufacturers. Includes 57+ electric and hybrid vehicles.

Get Started Free View Pricing Plans