# 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.

App · Misc References · 17 actions. Web page: https://docs.lodol.com/docs/integrations/fueleconomy

## Actions

### 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 IDs (`vehicle_ids`, list, required): The vehicles to compare (two to five ids). Accepts a list or a comma-separated string.

**Outputs**

- `best_combined_mpg` (object)
- `lowest_annual_fuel_cost` (object)
- `lowest_co2` (object)
- `vehicle_count` (number)
- `vehicle_ids` (list)
- `vehicles` (list)

**Example output**

```json
{
  "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 ID (`vehicle_id`, text, required): The EPA vehicle record id. Get one from 'List trims', 'Find a vehicle' or any action that returns vehicles.
- Miles driven a year (`annual_miles`, number): 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_percent`, number): The share of those miles driven in town. Defaults to EPA's 55%. From 0 to 100. Default: `55.0`.
- Which fuel (`fuel`, text): 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 price (`fuel_price`, number): 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_tons` (number)
- `annual_fuel_cost_usd` (number)
- `annual_miles` (number)
- `city_driving_percent` (number)
- `cost_per_mile_usd` (number)
- `effective_mpg` (number)
- `epa_annual_fuel_cost_usd` (number)
- `fuel` (text)
- `fuel_choice` (text)
- `fuel_price_source` (text)
- `fuel_price_unit` (text)
- `fuel_price_usd` (number)
- `fuel_units_used` (number)
- `monthly_fuel_cost_usd` (number)
- `vehicle` (object)
- `vehicle_id` (number)

**Example output**

```json
{
  "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 year (`year`, text, required): The vehicle's model year. The list comes straight from EPA's catalogue, which starts at 1984.
- Make (`make`, text, required): The manufacturer, from the makes EPA rated that model year.
- Model (`model`, text, required): The model, spelled the way EPA spells it: the list holds the exact names ('Civic 4Dr', 'CR-V AWD').
- Trim (`vehicle_id`, text): The engine, transmission and drive combination. Leave empty to return every trim of this model.

**Outputs**

- `found` (true/false)
- `make` (text)
- `model` (text)
- `trim_count` (number)
- `truncated` (true/false)
- `vehicle` (object)
- `vehicle_count` (number)
- `vehicles` (list)
- `year` (number)

**Example output**

```json
{
  "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**

- `fuels` (list)
- `prices` (object)

**Example output**

```json
{
  "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 ID (`vehicle_id`, text, required): The EPA vehicle record id. Get one from 'List trims', 'Find a vehicle' or any action that returns vehicles.

**Outputs**

- `average_mpg` (number)
- `city_percent` (number)
- `found` (true/false)
- `highway_percent` (number)
- `maximum_mpg` (number)
- `minimum_mpg` (number)
- `record_count` (number)
- `vehicle_id` (number)

**Example output**

```json
{
  "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 ID (`vehicle_id`, text, required): The EPA vehicle record id. Get one from 'List trims', 'Find a vehicle' or any action that returns vehicles.

**Outputs**

- `vehicle` (object)
- `vehicle_id` (number)

**Example output**

```json
{
  "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 ID (`vehicle_id`, text, required): The EPA vehicle record id. Get one from 'List trims', 'Find a vehicle' or any action that returns vehicles.

**Outputs**

- `best_smog_rating` (number)
- `emission_count` (number)
- `emissions` (list)
- `is_smartway` (true/false)
- `vehicle_id` (number)

**Example output**

```json
{
  "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 year (`year`, text, required): The vehicle's model year. The list comes straight from EPA's catalogue, which starts at 1984.

**Outputs**

- `make_count` (number)
- `makes` (list)
- `year` (number)

**Example output**

```json
{
  "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_year` (number)
- `latest_year` (number)
- `year_count` (number)
- `years` (list)

**Example output**

```json
{
  "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 year (`year`, text, required): The vehicle's model year. The list comes straight from EPA's catalogue, which starts at 1984.
- Make (`make`, text, required): The manufacturer, from the makes EPA rated that model year.

**Outputs**

- `make` (text)
- `model_count` (number)
- `models` (list)
- `year` (number)

**Example output**

```json
{
  "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**

- Make (`make`, text): Only list vehicles whose make contains this text. Leave empty for every make.
- Model (`model`, text): Only list vehicles whose model contains this text. Leave empty for every model.
- Model year (`year`, number): Only list vehicles of this model year. Leave empty for all. From 1984 to 2100.
- Vehicle technology (`technologies`, text): 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 on (`placed_in_service_on`, date): Only list credits that cover a vehicle put into service on this date. Leave empty to ignore dates.
- Number of results (`limit`, number): How many records to return, newest model year first. Defaults to 50. From 1 to 500. Default: `50`.

**Outputs**

- `credit_count` (number)
- `credits` (list)
- `filters` (object)
- `largest_credit_usd` (number)
- `match_count` (number)
- `truncated` (true/false)

**Example output**

```json
{
  "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_count` (number)
- `makes` (list)

**Example output**

```json
{
  "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**

- Make (`make`, text, required): The manufacturer, from those with shared data.

**Outputs**

- `make` (text)
- `model_count` (number)
- `models` (list)

**Example output**

```json
{
  "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 ID (`vehicle_id`, text, required): The EPA vehicle record id. Get one from 'List trims', 'Find a vehicle' or any action that returns vehicles.
- Number of reports (`limit`, number): How many reports to return, highest MPG first. Defaults to 25. From 1 to 500. Default: `25`.

**Outputs**

- `highest_mpg` (number)
- `lowest_mpg` (number)
- `report_count` (number)
- `reports` (list)
- `total_report_count` (number)
- `truncated` (true/false)
- `vehicle_id` (number)

**Example output**

```json
{
  "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**

- Make (`make`, text, required): The manufacturer, from those with shared data.
- Model (`model`, text, required): The model, from those with shared data.

**Outputs**

- `make` (text)
- `model` (text)
- `vehicle_count` (number)
- `vehicle_ids` (list)
- `vehicles` (list)

**Example output**

```json
{
  "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 year (`year`, text, required): The vehicle's model year. The list comes straight from EPA's catalogue, which starts at 1984.
- Make (`make`, text, required): The manufacturer, from the makes EPA rated that model year.
- Model (`model`, text, required): The model, spelled the way EPA spells it: the list holds the exact names ('Civic 4Dr', 'CR-V AWD').

**Outputs**

- `make` (text)
- `model` (text)
- `trim_count` (number)
- `trims` (list)
- `vehicle_ids` (list)
- `year` (number)

**Example output**

```json
{
  "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**

- Make (`make`, text): Only list vehicles whose make contains this text. Leave empty for every make.
- Model (`model`, text): Only list vehicles whose model contains this text. Leave empty for every model.
- Model year (`year`, number): Only list vehicles of this model year. Leave empty for all. From 1984 to 2100.
- Vehicle technology (`technologies`, text): 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 results (`limit`, number): How many records to return, newest model year first. Defaults to 50. From 1 to 500. Default: `50`.

**Outputs**

- `credit_count` (number)
- `credits` (list)
- `filters` (object)
- `match_count` (number)
- `truncated` (true/false)

**Example output**

```json
{
  "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
}
```