# FuelEconomy.gov API: Get fuel economy

> Returns official MPG or MPGe, range, annual fuel cost, five-year savings and emissions for every matching version of a vehicle. Costs use current fuel prices and 15,000 miles per year; plug-in hybrid costs include gasoline and electricity.

Unofficial. Not affiliated with or endorsed by FuelEconomy.gov.

- Page: https://fous.com/methods/fueleconomy.gov/get-fuel-economy
- Method: `fueleconomy.gov/get_fuel_economy`, version 1
- Website: fueleconomy.gov
- Returns: MPG/MPGe, range, annual fuel cost, fuel prices, five-year savings, CO2, greenhouse gas score
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `make` | string | yes | `"Toyota"` | Vehicle make, for example Toyota. |
| `year` | integer | yes | `2022` | Model year, for example 2022. |
| `model` | string | yes | `"RAV4"` | Model name, for example RAV4 or Model 3. |
| `version` | string | no | `"2.5 L AWD"` | Optional words identifying trim, engine, transmission or drive, for example Hybrid AWD. Default "". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "make": "Toyota",
  "year": 2022,
  "model": "RAV4",
  "version": "2.5 L AWD"
}
```

Its output:

```json
{
  "versions": [
    {
      "make": "Toyota",
      "year": 2022,
      "drive": "All-Wheel Drive",
      "model": "RAV4 AWD",
      "engine": "2.5 L, 4 cylinders, SIDI & PFI",
      "city_mpg": 25,
      "page_url": "https://www.fueleconomy.gov/feg/Find.do?action=sbs&id=45005",
      "city_mpge": null,
      "fuel_type": "Regular",
      "vehicle_id": "45005",
      "highway_mpg": 33,
      "range_miles": null,
      "combined_mpg": 28,
      "highway_mpge": null,
      "transmission": "Automatic (S8)",
      "combined_mpge": null,
      "fuel_price_unit": "gallon",
      "co2_grams_per_mile": 319,
      "vehicle_description": "2022 Toyota RAV4 AWD, 2.5 L, 4 cylinders, SIDI & PFI, Automatic (S8), All-Wheel Drive",
      "annual_fuel_cost_usd": 2300,
      "annual_miles_assumed": 15000,
      "electric_range_miles": null,
      "greenhouse_gas_score": 6,
      "five_year_savings_usd": 0,
      "fuel_price_usd_per_unit": 4.28,
      "secondary_fuel_price_unit": null,
      "secondary_fuel_price_usd_per_unit": null
    },
    {
      "make": "Toyota",
      "year": 2022,
      "drive": "All-Wheel Drive",
      "model": "RAV4 AWD",
      "engine": "2.5 L, 4 cylinders, SIDI & PFI; Stop-Start",
      "city_mpg": 27,
      "page_url": "https://www.fueleconomy.gov/feg/Find.do?action=sbs&id=45006",
      "city_mpge": null,
      "fuel_type": "Regular",
      "vehicle_id": "45006",
      "highway_mpg": 33,
      "range_miles": null,
      "combined_mpg": 29,
      "highway_mpge": null,
      "transmission": "Automatic (S8)",
      "combined_mpge": null,
      "fuel_price_unit": "gallon",
      "co2_grams_per_mile": 301,
      "vehicle_description": "2022 Toyota RAV4 AWD, 2.5 L, 4 cylinders, SIDI & PFI; Stop-Start, Automatic (S8), All-Wheel Drive",
      "annual_fuel_cost_usd": 2200,
      "annual_miles_assumed": 15000,
      "electric_range_miles": null,
      "greenhouse_gas_score": 6,
      "five_year_savings_usd": 500,
      "fuel_price_usd_per_unit": 4.28,
      "secondary_fuel_price_unit": null,
      "secondary_fuel_price_usd_per_unit": null
    },
    {
      "make": "Toyota",
      "year": 2022,
      "drive": "All-Wheel Drive",
      "model": "RAV4 AWD LE",
      "engine": "2.5 L, 4 cylinders, SIDI & PFI",
      "city_mpg": 27,
      "page_url": "https://www.fueleconomy.gov/feg/Find.do?action=sbs&id=45008",
      "city_mpge": null,
      "fuel_type": "Regular",
      "vehicle_id": "45008",
      "highway_mpg": 34,
      "range_miles": null,
      "combined_mpg": 30,
      "highway_mpge": null,
      "transmission": "Automatic (S8)",
      "combined_mpge": null,
      "fuel_price_unit": "gallon",
      "co2_grams_per_mile": 296,
      "vehicle_description": "2022 Toyota RAV4 AWD LE, 2.5 L, 4 cylinders, SIDI & PFI, Automatic (S8), All-Wheel Drive",
      "annual_fuel_cost_usd": 2150,
      "annual_miles_assumed": 15000,
      "electric_range_miles": null,
      "greenhouse_gas_score": 6,
      "five_year_savings_usd": 750,
      "fuel_price_usd_per_unit": 4.28,
      "secondary_fuel_price_unit": null,
      "secondary_fuel_price_usd_per_unit": null
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"fueleconomy.gov/get_fuel_economy","input":{"make":"Toyota","year":2022,"model":"RAV4","version":"2.5 L AWD"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What is the MPG and annual fuel cost for a 2022 Toyota RAV4 Hybrid AWD?
- Show me the fuel economy, range, and five-year savings for the 2023 Tesla Model 3.
- How many miles per gallon does a 2021 Honda Civic get, and what would it cost to fuel per year?
- Compare the MPGe and CO2 emissions for a 2024 Ford Mustang Mach-E on fueleconomy.gov.
- Find the estimated range and greenhouse gas score for a 2020 Chevrolet Bolt EV.

## Input schema

```json
{
  "type": "object",
  "required": [
    "year",
    "make",
    "model"
  ],
  "properties": {
    "make": {
      "type": "string",
      "description": "Vehicle make, for example Toyota."
    },
    "year": {
      "type": "integer",
      "description": "Model year, for example 2022."
    },
    "model": {
      "type": "string",
      "description": "Model name, for example RAV4 or Model 3."
    },
    "version": {
      "type": "string",
      "default": "",
      "description": "Optional words identifying trim, engine, transmission or drive, for example Hybrid AWD."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "versions"
  ],
  "properties": {
    "versions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "make": {
            "type": "string"
          },
          "year": {
            "type": "integer"
          },
          "drive": {
            "type": [
              "string",
              "null"
            ]
          },
          "model": {
            "type": "string"
          },
          "engine": {
            "type": [
              "string",
              "null"
            ]
          },
          "city_mpg": {
            "type": [
              "number",
              "null"
            ]
          },
          "page_url": {
            "type": "string"
          },
          "city_mpge": {
            "type": [
              "number",
              "null"
            ]
          },
          "fuel_type": {
            "type": "string"
          },
          "vehicle_id": {
            "type": "string"
          },
          "highway_mpg": {
            "type": [
              "number",
              "null"
            ]
          },
          "range_miles": {
            "type": [
              "number",
              "null"
            ]
          },
          "combined_mpg": {
            "type": [
              "number",
              "null"
            ]
          },
          "highway_mpge": {
            "type": [
              "number",
              "null"
            ]
          },
          "transmission": {
            "type": [
              "string",
              "null"
            ]
          },
          "combined_mpge": {
            "type": [
              "number",
              "null"
            ]
          },
          "fuel_price_unit": {
            "type": [
              "string",
              "null"
            ]
          },
          "co2_grams_per_mile": {
            "type": [
              "number",
              "null"
            ]
          },
          "vehicle_description": {
            "type": "string"
          },
          "annual_fuel_cost_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "annual_miles_assumed": {
            "type": "integer"
          },
          "electric_range_miles": {
            "type": [
              "number",
              "null"
            ]
          },
          "greenhouse_gas_score": {
            "type": [
              "integer",
              "null"
            ]
          },
          "five_year_savings_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "fuel_price_usd_per_unit": {
            "type": [
              "number",
              "null"
            ]
          },
          "secondary_fuel_price_unit": {
            "type": [
              "string",
              "null"
            ]
          },
          "secondary_fuel_price_usd_per_unit": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [FuelEconomy.gov API: Compare cars](https://fous.com/methods/fueleconomy.gov/compare-cars.md): Compares the official fuel economy and estimated annual fuel cost of two to four cars by year, make and model, using FuelEconomy.gov. Selects a base version when no trim is given.
- [NHTSA API: Get safety ratings](https://fous.com/methods/nhtsa.gov/get-safety-ratings.md): Gets NHTSA 5-Star Safety Ratings for a car by make, model and model year. Returns each matching version; unrated versions have no stars.
- [CarGurus API: Get used car market value](https://fous.com/methods/cargurus.com/get-market-value.md): Gets the current average used asking price, the CarGurus price range and the 12-month price history for a model year (all trims), from CarGurus price trends.
- [EIA API: Get weekly fuel prices](https://fous.com/methods/eia.gov/get-fuel-prices.md): Gets the latest weekly EIA retail gasoline and on-highway diesel prices for a U.S. area, with changes from the prior week and from 52 weeks earlier.
- [Kelley Blue Book API: Get KBB car review](https://fous.com/methods/kbb.com/get-car-review.md): Gets Kelley Blue Book's expert and consumer ratings, trim prices with the KBB Fair Purchase Price, fuel economy, pros, cons and the expert review's opening verdict for a car model by year, make and model. Some details are unavailable for certain model years.
- [NHTSA API: List vehicle models](https://fous.com/methods/nhtsa.gov/list-vehicle-models.md): Lists the passenger car, SUV/minivan and truck models NHTSA has for a make and model year, alphabetically.
- [NHTSA API: Check vehicle recalls](https://fous.com/methods/nhtsa.gov/check-recalls.md): Lists NHTSA safety recalls for a vehicle model, given a model year, make and model or a 17-character VIN. Results cover the model, not whether a specific car has been repaired.
- [NHTSA API: Decode a vehicle VIN](https://fous.com/methods/nhtsa.gov/decode-vin.md): Identifies a vehicle from its 17-character VIN using NHTSA vehicle data. Missing details are returned as null; decoding errors and warnings are included.
- [All FuelEconomy.gov methods](https://fous.com/methods/fueleconomy.gov.md)