# ForgeMesh Gas Mileage Lookup

> ForgeMesh Gas Mileage Lookup is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns authoritative city/highway/combined MPG, fuel type, greenhouse-gas score, and estimated annual fuel cost for any US light-duty vehicle model year 1984 or newer, accepting VIN, make/model/year, or a specific variant ID.

## Facts

- Endpoint: POST https://x402.forgemesh.io/gas-mileage-lookup
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-gas-mileage-lookup-63c298ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LjFUQxfUP6Gzi6YR3kmxI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forgemesh-gas-mileage-lookup-63c298ff -d '<json body>'
```

Example prompt: What's the city, highway, and combined MPG for a 2021 Toyota RAV4 Hybrid, and how much would I spend on gas per year driving it?

## When to prefer this

Choose this endpoint when you need official EPA-sourced fuel economy data (city/highway/combined MPG), greenhouse-gas scores, or annual fuel cost estimates for any US light-duty vehicle from 1984 onward. It is ideal for automotive research agents, car-buying assistants, and personal finance agents that need standardized fuel efficiency data. It accepts VINs directly (no separate VIN decoder needed) and handles fuzzy model name matching, making it more robust than raw database queries.

## Known failure modes

- Vehicle model year before 1984 returns no data — only 1984 and newer are covered
- Ambiguous make/model/year combination returns multiple variants requiring a follow-up with vehicle_id
- Invalid or unrecognized VIN returns a decode error
- Non-US vehicles or heavy-duty trucks may not be in the EPA dataset
- Misspelled make or model may fail if fuzzy matching cannot resolve it

## How this service works

Gas mileage checker: authoritative city/highway/combined MPG for any US light-duty vehicle model year 1984 or newer, with fuel type, greenhouse-gas score, and estimated annual fuel spend. VIN input is decoded automatically; fuzzy model matching bridges naming differences. For automotive and budgeting agents.

## Output

Returns city MPG, highway MPG, combined MPG, fuel type (e.g. regular gasoline, diesel, electric), EPA greenhouse-gas score, and estimated annual fuel expenditure in dollars for the matched vehicle. If a VIN is supplied it is decoded automatically. If the model name is ambiguous, other available variants are listed with their IDs so the caller can refine the query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "vin": {
   "type": "string",
   "description": "VIN — decoded automatically (alternative to make/model/model_year)"
  },
  "make": {
   "type": "string",
   "description": "e.g. Honda"
  },
  "model": {
   "type": "string",
   "description": "e.g. Accord"
  },
  "model_year": {
   "type": "string",
   "description": "4-digit year, 1984+"
  },
  "vehicle_id": {
   "type": "integer",
   "description": "exact variant id from other_variants"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-gas-mileage-lookup-63c298ff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)
