# ForgeMesh Vehicle Fuel Economy

> ForgeMesh Vehicle Fuel Economy 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).

Looks up official US EPA fuel-economy data (city/highway/combined MPG, fuel type, annual fuel cost, CO2 emissions, greenhouse-gas score) for any US light-duty vehicle from 1984 onward by VIN, year/make/model, or variant ID.

## Facts

- Endpoint: POST https://x402.forgemesh.io/vehicle-fuel-economy
- 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-vehicle-fuel-economy-5e29f5e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TCK16adnSFyDKbKwV2_o7

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-vehicle-fuel-economy-5e29f5e2 -d '<json body>'
```

Example prompt: What's the EPA fuel economy for a 2021 Toyota Camry — give me the city, highway, and combined MPG, the estimated annual fuel cost, and the greenhouse-gas score for all available engine variants.

## When to prefer this

Use this endpoint when you need official US EPA fuel-economy figures — especially city/highway/combined MPG, annual fuel cost estimates, CO2 per mile, or greenhouse-gas scores — for any US light-duty vehicle from 1984 onward. Prefer this over general vehicle info APIs when the goal is cost-of-ownership analysis, fleet emissions auditing, or car-shopping comparisons. It supports VIN decoding for used-car scenarios and returns sibling variants so agents can pinpoint the exact engine/transmission configuration.

## Known failure modes

- VIN not found or not a US light-duty vehicle — returns error or empty result
- Year/make/model combination does not exist in EPA database (pre-1984 or non-US vehicle)
- Ambiguous model returns multiple variants without selecting one — agent must specify vehicle_id to narrow down
- Invalid model_year format (non-4-digit or out of range) causes validation error
- Partial input (e.g. make only without model or year) may return no results

## How this service works

Official fuel-economy lookup for US light-duty vehicles back to 1984: city, highway, and combined MPG, fuel type, estimated annual fuel cost, tailpipe CO2 grams per mile, and greenhouse-gas score — by year/make/model, VIN, or exact variant id. Sibling engine/transmission variants are listed so agents can price the exact configuration. For cost-of-ownership, shopping, and fleet agents.

## Output

Returns city, highway, and combined MPG ratings, fuel type, EPA-estimated annual fuel cost in USD, tailpipe CO2 grams per mile, greenhouse-gas score (1–10), and a list of sibling engine/transmission variants with their own IDs so the agent can look up the exact configuration.

## 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-vehicle-fuel-economy-5e29f5e2/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)