Usage notes

Code snippets

curl "https://api.oanor.com/fueleconomy-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/fueleconomy-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/fueleconomy-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/fueleconomy-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Official US EPA fuel-economy ratings — the data behind the window sticker on every car sold in the US since 1984. Browse the catalogue step by step: /v1/years = the model years available; /v1/makes?year=2020 = the makes for a year; /v1/models?year=2020&make=Honda = the models for a year & make; /v1/trims?year=2020&make=Honda&model=Accord = the engine/transmission trims for a model, each with the vehicle id needed for the detail call (use the exact model name returned by /v1/models); /v1/vehicle?id=38313 = a vehicle's full fuel-economy record — city, highway and combined MPG, fuel type, engine (cylinders & displacement), transmission, vehicle class, estimated annual fuel cost, CO2 tailpipe emissions (g/mile), barrels of petroleum per year and the 5-year fuel-cost savings vs. an average vehicle. Ideal for car-shopping tools, fleet and emissions analysis, and sustainability calculators. Data is public-domain from the US EPA & DOE. Covers US-market vehicles.",
        "source": "FuelEconomy.gov — US EPA / DOE (fueleconomy.gov)",
        "endpoints": [
            "/v1/years",
            "/v1/makes",
            "/v1/models",
            "/v1/trims",
            "/v1/vehicle",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T16:24:02.981Z",
        "request_id": "0f12f771-4d78-4b0e-821d-1184512297e5"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}