FuelEconomy.gov

Look up official EPA fuel economy data from FuelEconomy.gov, the U.S. government's own source: any car from 1984 on with its city, highway and combined MPG, annual fuel cost, CO2 and smog ratings; the fuel prices the ratings are costed at; the mileage real drivers report; and the federal clean vehicle tax credits for new and used EVs, plug-in hybrids and fuel cell vehicles. No account or API key is required.

Actions

Action	What it does
Compare vehicles	Put two to five vehicles side by side on fuel economy, annual fuel cost and tailpipe CO2, and name the winner on each.
Estimate fuel cost	Work out what a vehicle costs you to fuel, for your own mileage and city/highway split, at today's published fuel price or one you supply.
Find a vehicle	Look up a car's official EPA ratings by year, make and model: city, highway and combined MPG, annual fuel cost, CO2, the EPA scores, and the engine and transmission behind them.
Get fuel prices	Get the national fuel prices FuelEconomy.gov costs its ratings with: regular, midgrade and premium gasoline, diesel, E85, electricity, compressed natural gas and propane.
Get shared MPG summary	Get the fuel economy drivers actually report for a vehicle through FuelEconomy.gov's My MPG: the average, the best and worst, the city/highway split and how many drivers it is based on.
Get vehicle	Get one vehicle's full EPA record by its id: fuel economy, annual fuel cost, CO2, petroleum use, the fuel economy and greenhouse gas scores, interior volume, and the electric or plug-in hybrid figures when the vehicle has them.
Get vehicle emissions	Get a vehicle's emission records: its EPA smog rating out of 10, the emission standard it was certified to, and whether it is a SmartWay vehicle.
List makes	List the manufacturers EPA rated for one model year: the first step of the year → make → model → trim walk that leads to a vehicle id.
List model years	List every model year EPA publishes ratings for, newest first.
List models	List the models a make had in one model year, spelled the way EPA spells them ('Civic 4Dr', 'CR-V AWD'), which is the spelling the other actions need.
List new vehicle tax credits	List the federal clean vehicle tax credits for new electric, plug-in hybrid and fuel cell vehicles: the credit amount, the MSRP cap, whether the vehicle is assembled in North America, and the purchase dates the credit covers.
List shared MPG makes	List the makes drivers have shared fuel economy for.
List shared MPG models	List a make's models that drivers have shared fuel economy for, ready to feed into 'List shared MPG vehicles'.
List shared MPG reports	List the individual driver reports behind a vehicle's shared fuel economy: each driver's average MPG, their city/highway split, their state and when they last updated it.
List shared MPG vehicles	List every vehicle record of one model that drivers have shared fuel economy for: one per model year and engine, each a full EPA record whose id feeds the shared MPG summary and reports.
List trims	List a model's trims (each engine, transmission and drive combination EPA rated separately) with the vehicle id that every other action takes.
List used vehicle tax credits	List the vehicles eligible for the federal pre-owned clean vehicle credit, by make, model, model year and technology.

Compare vehicles

Put two to five vehicles side by side on fuel economy, annual fuel cost and tailpipe CO2, and name the winner on each. Feed it the ids from 'List trims' or 'Find a vehicle'.

Inputs

Vehicle IDsvehicle_idslistRequired: The vehicles to compare (two to five ids). Accepts a list or a comma-separated string.

Outputs

best_combined_mpgobject
lowest_annual_fuel_costobject
lowest_co2object
vehicle_countnumber
vehicle_idslist
vehicleslist

Example output

{
  "best_combined_mpg": {
    "annual_fuel_cost_usd": 600,
    "city_mpg": 137,
    "co2_tailpipe_grams_per_mile": 0,
    "combined_mpg": 130,
    "fuel": "Electricity",
    "fuel_economy_score": 10,
    "greenhouse_gas_score": 10,
    "highway_mpg": 124,
    "id": 47908,
    "make": "Tesla",
    "model": "Model 3 Long Range AWD",
    "mpg_unit": "MPGe",
    "name": "2024 Tesla Model 3 Long Range AWD",
    "primary_fuel": "Electricity",
    "technology": "EV",
    "url": "https://www.fueleconomy.gov/feg/noframes/47908.shtml",
    "vehicle_class": "Midsize Cars",
    "year": 2024
  },
  "lowest_annual_fuel_cost": {
    "annual_fuel_cost_usd": 600,
    "city_mpg": 137,
    "co2_tailpipe_grams_per_mile": 0,
    "combined_mpg": 130,
    "fuel": "Electricity",
    "fuel_economy_score": 10,
    "greenhouse_gas_score": 10,
    "highway_mpg": 124,
    "id": 47908,
    "make": "Tesla",
    "model": "Model 3 Long Range AWD",
    "mpg_unit": "MPGe",
    "name": "2024 Tesla Model 3 Long Range AWD",
    "primary_fuel": "Electricity",
    "technology": "EV",
    "url": "https://www.fueleconomy.gov/feg/noframes/47908.shtml",
    "vehicle_class": "Midsize Cars",
    "year": 2024
  },
  "lowest_co2": {
    "annual_fuel_cost_usd": 600,
    "city_mpg": 137,
    "co2_tailpipe_grams_per_mile": 0,
    "combined_mpg": 130,
    "fuel": "Electricity",
    "fuel_economy_score": 10,
    "greenhouse_gas_score": 10,
    "highway_mpg": 124,
    "id": 47908,
    "make": "Tesla",
    "model": "Model 3 Long Range AWD",
    "mpg_unit": "MPGe",
    "name": "2024 Tesla Model 3 Long Range AWD",
    "primary_fuel": "Electricity",
    "technology": "EV",
    "url": "https://www.fueleconomy.gov/feg/noframes/47908.shtml",
    "vehicle_class": "Midsize Cars",
    "year": 2024
  },
  "vehicle_count": 2,
  "vehicle_ids": [
    47069,
    47908
  ],
  "vehicles": [
    {
      "annual_fuel_cost_usd": 1800,
      "city_mpg": 31,
      "co2_tailpipe_grams_per_mile": 260,
      "combined_mpg": 34,
      "fuel": "Regular",
      "fuel_economy_score": 7,
      "greenhouse_gas_score": 7,
      "highway_mpg": 38,
      "id": 47069,
      "make": "Honda",
      "model": "Civic 4Dr",
      "mpg_unit": "MPG",
      "name": "2024 Honda Civic 4Dr",
      "primary_fuel": "Regular Gasoline",
      "technology": null,
      "url": "https://www.fueleconomy.gov/feg/noframes/47069.shtml",
      "vehicle_class": "Midsize Cars",
      "year": 2024
    },
    {
      "annual_fuel_cost_usd": 600,
      "city_mpg": 137,
      "co2_tailpipe_grams_per_mile": 0,
      "combined_mpg": 130,
      "fuel": "Electricity",
      "fuel_economy_score": 10,
      "greenhouse_gas_score": 10,
      "highway_mpg": 124,
      "id": 47908,
      "make": "Tesla",
      "model": "Model 3 Long Range AWD",
      "mpg_unit": "MPGe",
      "name": "2024 Tesla Model 3 Long Range AWD",
      "primary_fuel": "Electricity",
      "technology": "EV",
      "url": "https://www.fueleconomy.gov/feg/noframes/47908.shtml",
      "vehicle_class": "Midsize Cars",
      "year": 2024
    }
  ]
}

Estimate fuel cost

Work out what a vehicle costs you to fuel, for your own mileage and city/highway split, at today's published fuel price or one you supply. Returns the yearly and monthly cost, the cost per mile, the fuel used and the CO2 that goes with it. EPA's own figure assumes 15,000 miles a year at 55% city.

Inputs

Vehicle IDvehicle_idtextRequired: The EPA vehicle record id. Get one from 'List trims', 'Find a vehicle' or any action that returns vehicles.
Miles driven a yearannual_milesnumber: How far the vehicle is driven in a year. Defaults to EPA's 15,000.From 1.0 to 1000000.0. Default: 15000.0.
City driving (%)city_driving_percentnumber: The share of those miles driven in town. Defaults to EPA's 55%.From 0 to 100. Default: 55.0.
Which fuelfueltext: For a flex-fuel or plug-in vehicle, which of its two fuels to cost. Defaults to the main one.One of: primary (The main fuel (default)), alternative (The alternative fuel (E85, electricity, CNG, propane)). Default: primary.
Fuel pricefuel_pricenumber: Your own price per gallon (or per kWh for an electric vehicle). Leave empty to use the current national price FuelEconomy.gov publishes.From 0.01 to 1000.0.

Outputs

annual_co2_metric_tonsnumber
annual_fuel_cost_usdnumber
annual_milesnumber
city_driving_percentnumber
cost_per_mile_usdnumber
effective_mpgnumber
epa_annual_fuel_cost_usdnumber
fueltext
fuel_choicetext
fuel_price_sourcetext
fuel_price_unittext
fuel_price_usdnumber
fuel_units_usednumber
monthly_fuel_cost_usdnumber
vehicleobject
vehicle_idnumber

Example output

{
  "annual_co2_metric_tons": 3.12,
  "annual_fuel_cost_usd": 1152.95,
  "annual_miles": 12000.0,
  "city_driving_percent": 70.0,
  "cost_per_mile_usd": 0.0961,
  "effective_mpg": 32.9,
  "epa_annual_fuel_cost_usd": 1800,
  "fuel": "Regular Gasoline",
  "fuel_choice": "primary",
  "fuel_price_source": "the current FuelEconomy.gov price",
  "fuel_price_unit": "gallon",
  "fuel_price_usd": 3.16,
  "fuel_units_used": 364.9,
  "monthly_fuel_cost_usd": 96.08,
  "vehicle": {
    "annual_fuel_cost_usd": 1800,
    "city_mpg": 31,
    "co2_tailpipe_grams_per_mile": 260,
    "combined_mpg": 34,
    "fuel": "Regular",
    "fuel_economy_score": 7,
    "greenhouse_gas_score": 7,
    "highway_mpg": 38,
    "id": 47069,
    "make": "Honda",
    "model": "Civic 4Dr",
    "mpg_unit": "MPG",
    "name": "2024 Honda Civic 4Dr",
    "primary_fuel": "Regular Gasoline",
    "technology": null,
    "url": "https://www.fueleconomy.gov/feg/noframes/47069.shtml",
    "vehicle_class": "Midsize Cars",
    "year": 2024
  },
  "vehicle_id": 47069
}

Find a vehicle

Look up a car's official EPA ratings by year, make and model: city, highway and combined MPG, annual fuel cost, CO2, the EPA scores, and the engine and transmission behind them. Pick a trim for one exact vehicle, or leave it empty to get every trim of the model with its own ratings.

Inputs

Model yearyeartextRequired: The vehicle's model year. The list comes straight from EPA's catalogue, which starts at 1984.
MakemaketextRequired: The manufacturer, from the makes EPA rated that model year.
ModelmodeltextRequired: The model, spelled the way EPA spells it: the list holds the exact names ('Civic 4Dr', 'CR-V AWD').
Trimvehicle_idtext: The engine, transmission and drive combination. Leave empty to return every trim of this model.

Outputs

foundtrue/false
maketext
modeltext
trim_countnumber
truncatedtrue/false
vehicleobject
vehicle_countnumber
vehicleslist
yearnumber

Example output

{
  "found": true,
  "make": "Honda",
  "model": "Civic 4Dr",
  "trim_count": 5,
  "truncated": false,
  "vehicle": {
    "alternative_fuel": null,
    "alternative_fuel_mpg": null,
    "annual_fuel_cost_alternative_usd": null,
    "annual_fuel_cost_usd": 1800,
    "annual_petroleum_barrels": 8.75,
    "annual_petroleum_barrels_alternative": null,
    "base_model": "Civic",
    "co2_grams_per_mile": 260,
    "co2_grams_per_mile_alternative": null,
    "co2_tailpipe_grams_per_mile": 260,
    "co2_tailpipe_grams_per_mile_alternative": null,
    "created_on": "2023-10-19",
    "cylinder_deactivation": false,
    "cylinders": 4,
    "drive": "Front-Wheel Drive",
    "electric": null,
    "emissions": [
      {
        "emission_standard": "Federal Tier 3 Bin 30",
        "emission_standard_code": "T3B30",
        "engine_family_id": "RHNXV01.5EEB",
        "sales_area": "Federal, all altitudes",
        "sales_area_code": 3,
        "smartway": "No",
        "smartway_code": -1,
        "smog_rating": 7,
        "smog_rating_alternative_fuel": null,
        "vehicle_id": 47069
      }
    ],
    "engine_description": "SIDI",
    "engine_displacement_liters": 1.5,
    "five_year_savings_usd": 2000,
    "fuel": "Regular",
    "fuel_economy_score": 7,
    "gas_guzzler_note": null,
    "gas_guzzler_tax": false,
    "greenhouse_gas_score": 7,
    "greenhouse_gas_score_alternative": null,
    "has_shared_mpg_data": true,
    "hydrogen": null,
    "id": 47069,
    "interior": {
      "luggage_volume_2door_cubic_feet": null,
      "luggage_volume_4door_cubic_feet": 15,
      "luggage_volume_hatchback_cubic_feet": null,
      "passenger_volume_2door_cubic_feet": null,
      "passenger_volume_4door_cubic_feet": 99,
      "passenger_volume_hatchback_cubic_feet": null
    },
    "make": "Honda",
    "manufacturer_code": "HNX",
    "model": "Civic 4Dr",
    "modified_on": "2024-02-06",
    "mpg": {
      "city": 31,
      "city_unadjusted": 41.2,
      "city_unrounded": 31.0089,
      "combined": 34,
      "combined_unrounded": 33.9179,
      "highway": 38,
      "highway_unadjusted": 56.5,
      "highway_unrounded": 38.3105
    },
    "mpg_revised": false,
    "name": "2024 Honda Civic 4Dr",
    "plug_in_hybrid": null,
    "primary_fuel": "Regular Gasoline",
    "range": null,
    "start_stop_technology": true,
    "supercharged": false,
    "technology": null,
    "technology_description": null,
    "transmission": "Automatic (AV-S7)",
    "transmission_description": null,
    "turbocharged": true,
    "url": "https://www.fueleconomy.gov/feg/noframes/47069.shtml",
    "vehicle_class": "Midsize Cars",
    "year": 2024
  },
  "vehicle_count": 1,
  "vehicles": [
    {
      "alternative_fuel": null,
      "alternative_fuel_mpg": null,
      "annual_fuel_cost_alternative_usd": null,
      "annual_fuel_cost_usd": 1800,
      "annual_petroleum_barrels": 8.75,
      "annual_petroleum_barrels_alternative": null,
      "base_model": "Civic",
      "co2_grams_per_mile": 260,
      "co2_grams_per_mile_alternative": null,
      "co2_tailpipe_grams_per_mile": 260,
      "co2_tailpipe_grams_per_mile_alternative": null,
      "created_on": "2023-10-19",
      "cylinder_deactivation": false,
      "cylinders": 4,
      "drive": "Front-Wheel Drive",
      "electric": null,
      "emissions": [
        {
          "emission_standard": "Federal Tier 3 Bin 30",
          "emission_standard_code": "T3B30",
          "engine_family_id": "RHNXV01.5EEB",
          "sales_area": "Federal, all altitudes",
          "sales_area_code": 3,
          "smartway": "No",
          "smartway_code": -1,
          "smog_rating": 7,
          "smog_rating_alternative_fuel": null,
          "vehicle_id": 47069
        }
      ],
      "engine_description": "SIDI",
      "engine_displacement_liters": 1.5,
      "five_year_savings_usd": 2000,
      "fuel": "Regular",
      "fuel_economy_score": 7,
      "gas_guzzler_note": null,
      "gas_guzzler_tax": false,
      "greenhouse_gas_score": 7,
      "greenhouse_gas_score_alternative": null,
      "has_shared_mpg_data": true,
      "hydrogen": null,
      "id": 47069,
      "interior": {
        "luggage_volume_2door_cubic_feet": null,
        "luggage_volume_4door_cubic_feet": 15,
        "luggage_volume_hatchback_cubic_feet": null,
        "passenger_volume_2door_cubic_feet": null,
        "passenger_volume_4door_cubic_feet": 99,
        "passenger_volume_hatchback_cubic_feet": null
      },
      "make": "Honda",
      "manufacturer_code": "HNX",
      "model": "Civic 4Dr",
      "modified_on": "2024-02-06",
      "mpg": {
        "city": 31,
        "city_unadjusted": 41.2,
        "city_unrounded": 31.0089,
        "combined": 34,
        "combined_unrounded": 33.9179,
        "highway": 38,
        "highway_unadjusted": 56.5,
        "highway_unrounded": 38.3105
      },
      "mpg_revised": false,
      "name": "2024 Honda Civic 4Dr",
      "plug_in_hybrid": null,
      "primary_fuel": "Regular Gasoline",
      "range": null,
      "start_stop_technology": true,
      "supercharged": false,
      "technology": null,
      "technology_description": null,
      "transmission": "Automatic (AV-S7)",
      "transmission_description": null,
      "turbocharged": true,
      "url": "https://www.fueleconomy.gov/feg/noframes/47069.shtml",
      "vehicle_class": "Midsize Cars",
      "year": 2024
    }
  ],
  "year": 2024
}

Get fuel prices

Get the national fuel prices FuelEconomy.gov costs its ratings with: regular, midgrade and premium gasoline, diesel, E85, electricity, compressed natural gas and propane. Gasoline and diesel are updated weekly, the alternative fuels quarterly.

Inputs

None.

Outputs

fuelslist
pricesobject

Example output

{
  "fuels": [
    {
      "fuel": "regular",
      "label": "Regular gasoline",
      "price_usd": 3.16,
      "unit": "gallon"
    },
    {
      "fuel": "electric",
      "label": "Electricity",
      "price_usd": 0.15,
      "unit": "kWh"
    }
  ],
  "prices": {
    "cng": 2.79,
    "diesel": 3.6,
    "e85": 2.71,
    "electric": 0.15,
    "lpg": 3.15,
    "midgrade": 3.62,
    "premium": 3.98,
    "regular": 3.16
  }
}

Get shared MPG summary

Get the fuel economy drivers actually report for a vehicle through FuelEconomy.gov's My MPG: the average, the best and worst, the city/highway split and how many drivers it is based on. Says so plainly when nobody has shared any.

Inputs

Vehicle IDvehicle_idtextRequired: The EPA vehicle record id. Get one from 'List trims', 'Find a vehicle' or any action that returns vehicles.

Outputs

average_mpgnumber
city_percentnumber
foundtrue/false
highway_percentnumber
maximum_mpgnumber
minimum_mpgnumber
record_countnumber
vehicle_idnumber

Example output

{
  "average_mpg": 48.635,
  "city_percent": 45,
  "found": true,
  "highway_percent": 55,
  "maximum_mpg": 74,
  "minimum_mpg": 30,
  "record_count": 202,
  "vehicle_id": 26425
}

Get vehicle

Get one vehicle's full EPA record by its id: fuel economy, annual fuel cost, CO2, petroleum use, the fuel economy and greenhouse gas scores, interior volume, and the electric or plug-in hybrid figures when the vehicle has them.

Inputs

Vehicle IDvehicle_idtextRequired: The EPA vehicle record id. Get one from 'List trims', 'Find a vehicle' or any action that returns vehicles.

Outputs

vehicleobject
vehicle_idnumber

Example output

{
  "vehicle": {
    "alternative_fuel": null,
    "alternative_fuel_mpg": null,
    "annual_fuel_cost_alternative_usd": null,
    "annual_fuel_cost_usd": 1800,
    "annual_petroleum_barrels": 8.75,
    "annual_petroleum_barrels_alternative": null,
    "base_model": "Civic",
    "co2_grams_per_mile": 260,
    "co2_grams_per_mile_alternative": null,
    "co2_tailpipe_grams_per_mile": 260,
    "co2_tailpipe_grams_per_mile_alternative": null,
    "created_on": "2023-10-19",
    "cylinder_deactivation": false,
    "cylinders": 4,
    "drive": "Front-Wheel Drive",
    "electric": null,
    "emissions": [
      {
        "emission_standard": "Federal Tier 3 Bin 30",
        "emission_standard_code": "T3B30",
        "engine_family_id": "RHNXV01.5EEB",
        "sales_area": "Federal, all altitudes",
        "sales_area_code": 3,
        "smartway": "No",
        "smartway_code": -1,
        "smog_rating": 7,
        "smog_rating_alternative_fuel": null,
        "vehicle_id": 47069
      }
    ],
    "engine_description": "SIDI",
    "engine_displacement_liters": 1.5,
    "five_year_savings_usd": 2000,
    "fuel": "Regular",
    "fuel_economy_score": 7,
    "gas_guzzler_note": null,
    "gas_guzzler_tax": false,
    "greenhouse_gas_score": 7,
    "greenhouse_gas_score_alternative": null,
    "has_shared_mpg_data": true,
    "hydrogen": null,
    "id": 47069,
    "interior": {
      "luggage_volume_2door_cubic_feet": null,
      "luggage_volume_4door_cubic_feet": 15,
      "luggage_volume_hatchback_cubic_feet": null,
      "passenger_volume_2door_cubic_feet": null,
      "passenger_volume_4door_cubic_feet": 99,
      "passenger_volume_hatchback_cubic_feet": null
    },
    "make": "Honda",
    "manufacturer_code": "HNX",
    "model": "Civic 4Dr",
    "modified_on": "2024-02-06",
    "mpg": {
      "city": 31,
      "city_unadjusted": 41.2,
      "city_unrounded": 31.0089,
      "combined": 34,
      "combined_unrounded": 33.9179,
      "highway": 38,
      "highway_unadjusted": 56.5,
      "highway_unrounded": 38.3105
    },
    "mpg_revised": false,
    "name": "2024 Honda Civic 4Dr",
    "plug_in_hybrid": null,
    "primary_fuel": "Regular Gasoline",
    "range": null,
    "start_stop_technology": true,
    "supercharged": false,
    "technology": null,
    "technology_description": null,
    "transmission": "Automatic (AV-S7)",
    "transmission_description": null,
    "turbocharged": true,
    "url": "https://www.fueleconomy.gov/feg/noframes/47069.shtml",
    "vehicle_class": "Midsize Cars",
    "year": 2024
  },
  "vehicle_id": 47069
}

Get vehicle emissions

Get a vehicle's emission records: its EPA smog rating out of 10, the emission standard it was certified to, and whether it is a SmartWay vehicle. One record per sales area, because a car certified for California and for the rest of the country is rated separately in each.

Inputs

Vehicle IDvehicle_idtextRequired: The EPA vehicle record id. Get one from 'List trims', 'Find a vehicle' or any action that returns vehicles.

Outputs

best_smog_ratingnumber
emission_countnumber
emissionslist
is_smartwaytrue/false
vehicle_idnumber

Example output

{
  "best_smog_rating": 7,
  "emission_count": 1,
  "emissions": [
    {
      "emission_standard": "Federal Tier 3 Bin 30",
      "emission_standard_code": "T3B30",
      "engine_family_id": "RHNXV01.5EEB",
      "sales_area": "Federal, all altitudes",
      "sales_area_code": 3,
      "smartway": "No",
      "smartway_code": -1,
      "smog_rating": 7,
      "smog_rating_alternative_fuel": null,
      "vehicle_id": 47069
    }
  ],
  "is_smartway": false,
  "vehicle_id": 47069
}

List makes

List the manufacturers EPA rated for one model year: the first step of the year → make → model → trim walk that leads to a vehicle id.

Inputs

Model yearyeartextRequired: The vehicle's model year. The list comes straight from EPA's catalogue, which starts at 1984.

Outputs

make_countnumber
makeslist
yearnumber

Example output

{
  "make_count": 2,
  "makes": [
    {
      "label": "Honda",
      "value": "Honda"
    },
    {
      "label": "Tesla",
      "value": "Tesla"
    }
  ],
  "year": 2024
}

List model years

List every model year EPA publishes ratings for, newest first. The catalogue starts at 1984 and runs a year or two ahead of the calendar.

Inputs

None.

Outputs

earliest_yearnumber
latest_yearnumber
year_countnumber
yearslist

Example output

{
  "earliest_year": 2024,
  "latest_year": 2026,
  "year_count": 3,
  "years": [
    2026,
    2025,
    2024
  ]
}

List models

List the models a make had in one model year, spelled the way EPA spells them ('Civic 4Dr', 'CR-V AWD'), which is the spelling the other actions need.

Inputs

Model yearyeartextRequired: The vehicle's model year. The list comes straight from EPA's catalogue, which starts at 1984.
MakemaketextRequired: The manufacturer, from the makes EPA rated that model year.

Outputs

maketext
model_countnumber
modelslist
yearnumber

Example output

{
  "make": "Honda",
  "model_count": 2,
  "models": [
    {
      "label": "Civic 4Dr",
      "value": "Civic 4Dr"
    },
    {
      "label": "CR-V AWD",
      "value": "CR-V AWD"
    }
  ],
  "year": 2024
}

List new vehicle tax credits

List the federal clean vehicle tax credits for new electric, plug-in hybrid and fuel cell vehicles: the credit amount, the MSRP cap, whether the vehicle is assembled in North America, and the purchase dates the credit covers. Filter by make, model, model year, technology, or a purchase date.

Inputs

Makemaketext: Only list vehicles whose make contains this text. Leave empty for every make.
Modelmodeltext: Only list vehicles whose model contains this text. Leave empty for every model.
Model yearyearnumber: Only list vehicles of this model year. Leave empty for all.From 1984 to 2100.
Vehicle technologytechnologiestext: Only list these kinds of vehicle. Leave empty for all of them.One or more of: EV (All-electric), FCV (Hydrogen fuel cell), Plug-in Hybrid.
Placed in service onplaced_in_service_ondate: Only list credits that cover a vehicle put into service on this date. Leave empty to ignore dates.
Number of resultslimitnumber: How many records to return, newest model year first. Defaults to 50.From 1 to 500. Default: 50.

Outputs

credit_countnumber
creditslist
filtersobject
largest_credit_usdnumber
match_countnumber
truncatedtrue/false

Example output

{
  "credit_count": 1,
  "credits": [
    {
      "assembled_in_north_america": "Yes",
      "base_model": "Model Y",
      "created_on": "2025-01-01",
      "credit_usd": 7500,
      "id": 250,
      "make": "Tesla",
      "manufacturer": "Tesla",
      "model": "Model Y All-Wheel Drive",
      "modified_on": "2025-01-01",
      "msrp_limit_usd": 80000,
      "placed_in_service_from": "2025-01-01",
      "placed_in_service_through": "2025-12-31",
      "technology": "EV",
      "technology_description": "Electric vehicle",
      "year": 2025
    }
  ],
  "filters": {
    "make": "Tesla",
    "model": null,
    "placed_in_service_on": null,
    "technologies": [
      "EV"
    ],
    "year": null
  },
  "largest_credit_usd": 7500,
  "match_count": 1,
  "truncated": false
}

List shared MPG makes

List the makes drivers have shared fuel economy for. This is a different, older catalogue from the ratings one; it reaches back to makes that no longer exist.

Inputs

None.

Outputs

make_countnumber
makeslist

Example output

{
  "make_count": 2,
  "makes": [
    {
      "label": "Honda",
      "value": "Honda"
    },
    {
      "label": "Toyota",
      "value": "Toyota"
    }
  ]
}

List shared MPG models

List a make's models that drivers have shared fuel economy for, ready to feed into 'List shared MPG vehicles'.

Inputs

MakemaketextRequired: The manufacturer, from those with shared data.

Outputs

maketext
model_countnumber
modelslist

Example output

{
  "make": "Honda",
  "model_count": 2,
  "models": [
    {
      "label": "Fit",
      "value": "Fit"
    },
    {
      "label": "Insight",
      "value": "Insight"
    }
  ]
}

List shared MPG reports

List the individual driver reports behind a vehicle's shared fuel economy: each driver's average MPG, their city/highway split, their state and when they last updated it. Highest MPG first, because popular cars have hundreds of them.

Inputs

Vehicle IDvehicle_idtextRequired: The EPA vehicle record id. Get one from 'List trims', 'Find a vehicle' or any action that returns vehicles.
Number of reportslimitnumber: How many reports to return, highest MPG first. Defaults to 25.From 1 to 500. Default: 25.

Outputs

highest_mpgnumber
lowest_mpgnumber
report_countnumber
reportslist
total_report_countnumber
truncatedtrue/false
vehicle_idnumber

Example output

{
  "highest_mpg": 73.8,
  "lowest_mpg": 73.8,
  "report_count": 1,
  "reports": [
    {
      "city_percent": 50,
      "highway_percent": 50,
      "last_updated": "2011-04-10",
      "mpg": 73.8,
      "state": "MI",
      "vehicle_id": 26425
    }
  ],
  "total_report_count": 202,
  "truncated": true,
  "vehicle_id": 26425
}

List shared MPG vehicles

List every vehicle record of one model that drivers have shared fuel economy for: one per model year and engine, each a full EPA record whose id feeds the shared MPG summary and reports.

Inputs

MakemaketextRequired: The manufacturer, from those with shared data.
ModelmodeltextRequired: The model, from those with shared data.

Outputs

maketext
modeltext
vehicle_countnumber
vehicle_idslist
vehicleslist

Example output

{
  "make": "Honda",
  "model": "Fit",
  "vehicle_count": 1,
  "vehicle_ids": [
    47069
  ],
  "vehicles": [
    {
      "alternative_fuel": null,
      "alternative_fuel_mpg": null,
      "annual_fuel_cost_alternative_usd": null,
      "annual_fuel_cost_usd": 1800,
      "annual_petroleum_barrels": 8.75,
      "annual_petroleum_barrels_alternative": null,
      "base_model": "Civic",
      "co2_grams_per_mile": 260,
      "co2_grams_per_mile_alternative": null,
      "co2_tailpipe_grams_per_mile": 260,
      "co2_tailpipe_grams_per_mile_alternative": null,
      "created_on": "2023-10-19",
      "cylinder_deactivation": false,
      "cylinders": 4,
      "drive": "Front-Wheel Drive",
      "electric": null,
      "emissions": [
        {
          "emission_standard": "Federal Tier 3 Bin 30",
          "emission_standard_code": "T3B30",
          "engine_family_id": "RHNXV01.5EEB",
          "sales_area": "Federal, all altitudes",
          "sales_area_code": 3,
          "smartway": "No",
          "smartway_code": -1,
          "smog_rating": 7,
          "smog_rating_alternative_fuel": null,
          "vehicle_id": 47069
        }
      ],
      "engine_description": "SIDI",
      "engine_displacement_liters": 1.5,
      "five_year_savings_usd": 2000,
      "fuel": "Regular",
      "fuel_economy_score": 7,
      "gas_guzzler_note": null,
      "gas_guzzler_tax": false,
      "greenhouse_gas_score": 7,
      "greenhouse_gas_score_alternative": null,
      "has_shared_mpg_data": true,
      "hydrogen": null,
      "id": 47069,
      "interior": {
        "luggage_volume_2door_cubic_feet": null,
        "luggage_volume_4door_cubic_feet": 15,
        "luggage_volume_hatchback_cubic_feet": null,
        "passenger_volume_2door_cubic_feet": null,
        "passenger_volume_4door_cubic_feet": 99,
        "passenger_volume_hatchback_cubic_feet": null
      },
      "make": "Honda",
      "manufacturer_code": "HNX",
      "model": "Civic 4Dr",
      "modified_on": "2024-02-06",
      "mpg": {
        "city": 31,
        "city_unadjusted": 41.2,
        "city_unrounded": 31.0089,
        "combined": 34,
        "combined_unrounded": 33.9179,
        "highway": 38,
        "highway_unadjusted": 56.5,
        "highway_unrounded": 38.3105
      },
      "mpg_revised": false,
      "name": "2024 Honda Civic 4Dr",
      "plug_in_hybrid": null,
      "primary_fuel": "Regular Gasoline",
      "range": null,
      "start_stop_technology": true,
      "supercharged": false,
      "technology": null,
      "technology_description": null,
      "transmission": "Automatic (AV-S7)",
      "transmission_description": null,
      "turbocharged": true,
      "url": "https://www.fueleconomy.gov/feg/noframes/47069.shtml",
      "vehicle_class": "Midsize Cars",
      "year": 2024
    }
  ]
}

List trims

List a model's trims (each engine, transmission and drive combination EPA rated separately) with the vehicle id that every other action takes.

Inputs

Model yearyeartextRequired: The vehicle's model year. The list comes straight from EPA's catalogue, which starts at 1984.
MakemaketextRequired: The manufacturer, from the makes EPA rated that model year.
ModelmodeltextRequired: The model, spelled the way EPA spells it: the list holds the exact names ('Civic 4Dr', 'CR-V AWD').

Outputs

maketext
modeltext
trim_countnumber
trimslist
vehicle_idslist
yearnumber

Example output

{
  "make": "Honda",
  "model": "Civic 4Dr",
  "trim_count": 2,
  "trims": [
    {
      "trim": "Auto (AV-S7), 4 cyl, 1.5 L, Turbo",
      "vehicle_id": 47069
    },
    {
      "trim": "Man 6-spd, 4 cyl, 1.5 L, Turbo",
      "vehicle_id": 47070
    }
  ],
  "vehicle_ids": [
    47069,
    47070
  ],
  "year": 2024
}

List used vehicle tax credits

List the vehicles eligible for the federal pre-owned clean vehicle credit, by make, model, model year and technology. The credit is worth 30% of the sale price up to $4,000, so the list names the qualifying models rather than an amount.

Inputs

Makemaketext: Only list vehicles whose make contains this text. Leave empty for every make.
Modelmodeltext: Only list vehicles whose model contains this text. Leave empty for every model.
Model yearyearnumber: Only list vehicles of this model year. Leave empty for all.From 1984 to 2100.
Vehicle technologytechnologiestext: Only list these kinds of vehicle. Leave empty for all of them.One or more of: EV (All-electric), FCV (Hydrogen fuel cell), Plug-in Hybrid.
Number of resultslimitnumber: How many records to return, newest model year first. Defaults to 50.From 1 to 500. Default: 50.

Outputs

credit_countnumber
creditslist
filtersobject
match_countnumber
truncatedtrue/false

Example output

{
  "credit_count": 1,
  "credits": [
    {
      "created_on": "2023-06-01",
      "id": 501,
      "make": "Audi",
      "manufacturer": "Audi of America, LLC",
      "manufacturer_id": 4,
      "model": "e-tron",
      "modified_on": "2023-06-01",
      "technology": "EV",
      "technology_description": "Electric vehicle",
      "year": 2023
    }
  ],
  "filters": {
    "make": "Audi",
    "model": null,
    "technologies": [],
    "year": null
  },
  "match_count": 1,
  "truncated": false
}

ActionsCopy Anchor Link

Compare vehiclesCopy Anchor Link

Inputs

Outputs

Estimate fuel costCopy Anchor Link

Inputs

Outputs

Find a vehicleCopy Anchor Link

Inputs

Outputs

Get fuel pricesCopy Anchor Link

Inputs

Outputs

Get shared MPG summaryCopy Anchor Link

Inputs

Outputs

Get vehicleCopy Anchor Link

Inputs

Outputs

Get vehicle emissionsCopy Anchor Link

Inputs

Outputs

List makesCopy Anchor Link

Inputs

Outputs

List model yearsCopy Anchor Link

Inputs

Outputs

List modelsCopy Anchor Link

Inputs

Outputs

List new vehicle tax creditsCopy Anchor Link

Inputs

Outputs

List shared MPG makesCopy Anchor Link

Inputs

Outputs

List shared MPG modelsCopy Anchor Link

Inputs

Outputs

List shared MPG reportsCopy Anchor Link

Inputs

Outputs

List shared MPG vehiclesCopy Anchor Link

Inputs

Outputs

List trimsCopy Anchor Link

Inputs

Outputs

List used vehicle tax creditsCopy Anchor Link

Inputs

Outputs

On this page

Actions

Compare vehicles

Estimate fuel cost

Find a vehicle

Get fuel prices

Get shared MPG summary

Get vehicle

Get vehicle emissions

List makes

List model years

List models

List new vehicle tax credits

List shared MPG makes

List shared MPG models

List shared MPG reports

List shared MPG vehicles

List trims

List used vehicle tax credits