EPA Fuel Economy API
MPG, range and emissions.
mpg_city, mpg_highway, mpg_combined, EV range, annual fuel cost, CO2 per mile and the greenhouse-gas score — sourced from fueleconomy.gov, inline on the same UUID as each car's specs.
Free plan: 100 API calls/mo — no card.
Key endpoints
Economy fields ride inline on each car object — no separate economy call.
GET
/v1/cars
|
List cars with economy fields inline — filter by make, model, year, body, fuel type and EV-only. |
GET
/v1/cars/{uuid}
|
Single car by UUID — full specs plus mpg, range, annual fuel cost, CO2, GHG score and EPA class. |
Base URL: https://api.vehdb.com/v1
Fuel economy fields
Sourced from fueleconomy.gov (public domain), exposed inline on the car object.
| Field | Type | Description |
|---|---|---|
mpg_city |
integer | EPA city fuel economy (MPG, or MPGe for EVs) |
mpg_highway |
integer | EPA highway fuel economy (MPG / MPGe) |
mpg_combined |
integer | EPA combined fuel economy (MPG / MPGe) |
epa_range_miles |
integer | EPA driving range in miles (electric vehicles) |
annual_fuel_cost |
integer | Estimated annual fuel cost in USD |
co2_gpm |
integer | Tailpipe CO2 emissions in grams per mile |
ghg_score |
integer | EPA greenhouse-gas score (1–10) |
five_year_fuel_savings |
integer | Estimated 5-year fuel savings vs. the average new vehicle (USD) |
epa_class |
string | EPA vehicle size class (e.g. Midsize Cars, Small SUV) |
Cost and emissions, answered inline
Specs say what the car is. EPA economy says what it costs to run and what it emits.
Running cost up front
mpg_combined, annual_fuel_cost and five_year_fuel_savings let you surface true cost of ownership without a second data source.
Emissions for compliance
co2_gpm and ghg_score give grams-per-mile and the EPA greenhouse-gas rating — ready for sustainability, ESG and fleet-emissions use cases.
EV range, same shape
epa_range_miles fills in for battery-electric vehicles, with co2_gpm at 0 and mpg fields using the MPGe equivalent.
See the Cars API, our data sources, and the vehicle data glossary.
Example response
A consistent data + meta shape with economy fields inline.
{
"data": [
{
"uuid": "c3d4e5f6-a7b8-9012-cdef-345678901234",
"make": "Tesla",
"model": "Model 3",
"year": 2025,
"fuel_type_name": "BATTERY ELECTRIC VEHICLE (BEV)",
"mpg_city": 138,
"mpg_highway": 126,
"mpg_combined": 132,
"epa_range_miles": 363,
"annual_fuel_cost": 600,
"co2_gpm": 0,
"ghg_score": 10,
"five_year_fuel_savings": 6500,
"epa_class": "Compact Cars"
}
],
"meta": { "current_page": 1, "last_page": 1, "per_page": 20, "total": 1 }
}
Fuel Economy API FAQ
Common questions about VehDB's EPA fuel economy API.
Also see the Cars and Recalls & Safety APIs, our data sources, or the API overview.
Your AI agent's vehicle-data tools —
not glue code.
VehDB ships a native Model Context Protocol server. Claude, Cursor or any MCP client queries cars, recalls, fuel economy and tire fitment as first-class tools — no wrappers, no scraping, no glue code to maintain.
- Native MCP tools — search_vehicles, tire_sizes_for_vehicle, recalls, my_lists — callable by Claude, Cursor or any agent.
- OAuth2 for AI providers plus simple Bearer tokens. Same auth, same data as the REST API and workspace.
- No scraping, no function-calling boilerplate, no schema drift — the agent gets typed, documented tools.
{ "mcpServers": {
"vehdb": { "url": "https://mcp.vehdb.com/mcp" }
} }