{"uid":"cap_XMBic4V1K2RmzYFwlQMyD","slug":"2s-vehicle-fuel-economy-lookup-a0420b75","name":"2s Vehicle Fuel Economy Lookup","description":"Official US EPA/DOE fuel-economy, fuel-cost, and emissions data for a vehicle by year + make + model. Because a model-year often has several powertrain configurations (engine/transmission), this returns one entry per configuration, each with: MPG city/highway/combined (or MPGe for EVs), CO2 tailpipe grams/mile, estimated annual fuel cost (USD), annual petroleum use (barrels), EPA greenhouse-gas score (1-10), 5-year savings vs the average new vehicle, plus transmission, drivetrain, cylinders, displacement, fuel type, EPA size class, and electric range for EV/PHEV. Authoritative EPA test figures — the real ratings an agent should not estimate. Keyless, public-domain (FuelEconomy.gov), covers model years 1984+.","url":"https://2s.io/api/vehicle/fuel-economy","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["year","make","model"],"properties":{"make":{"type":"string","description":"Vehicle make, e.g. Honda."},"year":{"type":"integer","description":"4-digit model year (1984+)."},"model":{"type":"string","description":"Vehicle model, e.g. Accord."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"make":"Honda","year":2022,"model":"Accord"}}},"response":{"data":{"ok":true,"meta":{"query":{"make":"Honda","year":2022,"model":"Accord"},"total":1},"items":[{"id":"44565","make":"Honda","year":2022,"drive":"Front-Wheel Drive","model":"Accord","source":{"url":"https://www.fueleconomy.gov/feg/ws/","license":"US Government work, public domain.","provider":"US EPA / DOE — FuelEconomy.gov"},"mpgCity":30,"fuelType":"Regular Gasoline","ghgScore":7,"cylinders":4,"mpgHighway":38,"description":"Auto (variable gear ratios), 4 cyl, 1.5 L, Turbo","mpgCombined":33,"transmission":"Automatic (variable gear ratios)","vehicleClass":"Large Cars","displacementL":1.5,"co2GramsPerMile":268,"electricRangeMi":null,"annualFuelCostUSD":1900,"annualPetroleumBarrels":9.015454545454546,"fiveYearSavingsVsAvgUSD":1500}],"total":1,"source":{"url":"https://www.fueleconomy.gov/feg/ws/","license":"US Government work, public domain.","provider":"US EPA / DOE — FuelEconomy.gov"}},"meta":{"cost":{"usd":0.0018,"tier":0},"caller":"x402","version":null,"endpoint":"vehicle.fuel-economy","settlement":{"txHash":"0x31a6834c1f2715a5fdab6af30ab704ff1e81f0de67cbef003880668572d7f9d2","network":"eip155:8453","success":true}}}},"exampleRequest":{"make":"Honda","year":2022,"model":"Accord"},"tags":["x402"],"displayCostAmount":"0.0018","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0018/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ul0URZClXkR_hl1OIWA0n","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0045","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns EPA/DOE fuel economy data (MPG, CO2, annual cost, GHG score) for a specific vehicle by year, make, and model.","exampleAgentPrompt":"What's the EPA fuel economy rating for a 2022 Honda Accord — city and highway MPG, annual fuel cost, and CO2 per mile?","exampleUseCases":null,"resultDescription":"An array of matching vehicle trim configurations with city MPG, highway MPG, combined MPG, fuel type, GHG score (0-10), CO2 grams per mile, cylinders, engine displacement in liters, transmission type, drive type, vehicle class, annual fuel cost in USD, five-year savings vs average vehicle, annual petroleum barrels consumed, and electric range if applicable. Also includes source metadata from FuelEconomy.gov with license info.","failureModes":["Vehicle not found for given year/make/model combination — items array returns empty","Year before 1984 not supported — likely returns empty or error","Misspelled make or model returns no results","Missing required query parameters (year, make, or model) returns validation error","Payment failure via x402 results in 402 response with no data"],"whenToPreferThis":"Use this endpoint when you need official EPA/DOE ground-truth fuel economy data for a specific vehicle — especially for MPG figures, CO2 emissions, GHG scores, or annual cost estimates. Prefer over scraped or estimated sources when regulatory accuracy or official government data is required. Ideal for vehicle comparison tools, purchase decision support, or environmental impact calculations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:45:08.326Z","isFirstParty":false}