docs.vin

fuelEconomy

The fuelEconomy noun — identity, lifecycle, events, and every capability as an anchored section: 5 capabilities, 3 live, 2 sandbox, 0 declared.

fuelEconomy is one of the estate's 317 automotive nouns — a job a car needs done. It carries 5 capabilities: 3 live, 2 sandbox, 0 declared · doors aggregator.vin.

Identity

NounfuelEconomy
PillarData (facets: 5 data)
Capabilities5 — 3 live · 2 sandbox · 0 declared
EntitiesVehicle
Doorsaggregator.vin
SDKVin.fuelEconomy.* from apis.vin
Address/catalog/fuelEconomy#{action} — the anchor IS the wire name minus fuelEconomy.

Discover & read

lookup

fuelEconomy.lookup · GET /fuel-economies/lookup · gate none · live · answers FuelEconomyLookup@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GTW7BFP7L1247147 (the VIN lens).

Try it — live: answers on the wire today. A sandbox key still selects the deterministic simulated mode — drive the full outcome range with the magic triggers.

the SDK — fuelEconomy.lookup
import { fuelEconomy } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuelEconomy.lookup({"vin":"1GTW7BFP7L1247147"})
GET /fuel-economies/lookup
curl 'https://apis.vin/fuel-economies/lookup?vin=1GTW7BFP7L1247147'

compare

fuelEconomy.compare · GET /fuel-economies/compare · gate key · sandbox · answers FuelEconomyCompare@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GTW7BFP7L1247147 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

the SDK — fuelEconomy.compare
import { fuelEconomy } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuelEconomy.compare({"vin":"1GTW7BFP7L1247147"})
GET /fuel-economies/compare
curl 'https://apis.vin/fuel-economies/compare?vin=1GTW7BFP7L1247147'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:11.956Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelEconomyCompare@1",
  "value": {
    "vin": "1GTW7BFP7L1247147",
    "noun": "fuelEconomy",
    "asOf": "2026-08-10",
    "vehicleId": "VEH-94e760b6",
    "year": 2025,
    "bodyStyle": "truck",
    "drivetrain": "rwd",
    "odometer": 87155,
    "condition": "clean",
    "currentOwnerId": "ID-11f17424",
    "compare": {
      "subject": {
        "modelYear": 2025,
        "bodyStyle": "truck",
        "cityMpg": 18,
        "highwayMpg": 28,
        "combinedMpg": 23,
        "co2GramsPerMile": 386,
        "rangeMiles": 340,
        "tankCapacityGal": "14.8",
        "basis": "one-model-fuel-card"
      },
      "other": {
        "modelYear": 2025,
        "bodyStyle": "sedan",
        "cityMpg": 26,
        "highwayMpg": 35,
        "combinedMpg": 31,
        "co2GramsPerMile": 287,
        "rangeMiles": 459,
        "tankCapacityGal": "14.8",
        "basis": "one-model-fuel-card"
      },
      "sameModelIdentity": false
    }
  },
  "evidence": {
    "vin": "1GTW7BFP7L1247147",
    "noun": "fuelEconomy",
    "asOf": "2026-08-10",
    "vehicleId": "VEH-94e760b6",
    "year": 2025,
    "bodyStyle": "truck",
    "drivetrain": "rwd",
    "odometer": 87155,
    "condition": "clean",
    "currentOwnerId": "ID-11f17424",
    "compare": {
      "subject": {
        "modelYear": 2025,
        "bodyStyle": "truck",
        "cityMpg": 18,
        "highwayMpg": 28,
        "combinedMpg": 23,
        "co2GramsPerMile": 386,
        "rangeMiles": 340,
        "tankCapacityGal": "14.8",
        "basis": "one-model-fuel-card"
      },
      "other": {
        "modelYear": 2025,
        "bodyStyle": "sedan",
        "cityMpg": 26,
        "highwayMpg": 35,
        "combinedMpg": 31,
        "co2GramsPerMile": 287,
        "rangeMiles": 459,
        "tankCapacityGal": "14.8",
        "basis": "one-model-fuel-card"
      },
      "sameModelIdentity": false
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "spec-sheet-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

co2Read

fuelEconomy.co2Read · GET /fuel-economies/co2-read · gate none · sandbox · answers FuelEconomyCo2Read@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GTW7BFP7L1247147 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

the SDK — fuelEconomy.co2Read
import { fuelEconomy } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuelEconomy.co2Read({"vin":"1GTW7BFP7L1247147"})
GET /fuel-economies/co2-read
curl 'https://apis.vin/fuel-economies/co2-read?vin=1GTW7BFP7L1247147'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-17T12:42:11.953Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelEconomyCo2Read@1",
  "value": {
    "vin": "1GTW7BFP7L1247147",
    "noun": "fuelEconomy",
    "asOf": "2026-08-10",
    "vehicleId": "VEH-94e760b6",
    "year": 2025,
    "bodyStyle": "truck",
    "drivetrain": "rwd",
    "odometer": 87155,
    "condition": "clean",
    "currentOwnerId": "ID-11f17424",
    "co2": {
      "gramsPerMile": 386,
      "cycle": "gasoline",
      "basis": "one-model-fuel-card"
    }
  },
  "evidence": {
    "vin": "1GTW7BFP7L1247147",
    "noun": "fuelEconomy",
    "asOf": "2026-08-10",
    "vehicleId": "VEH-94e760b6",
    "year": 2025,
    "bodyStyle": "truck",
    "drivetrain": "rwd",
    "odometer": 87155,
    "condition": "clean",
    "currentOwnerId": "ID-11f17424",
    "co2": {
      "gramsPerMile": 386,
      "cycle": "gasoline",
      "basis": "one-model-fuel-card"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "spec-sheet-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

mpgRead

fuelEconomy.mpgRead · GET /fuel-economies/mpg-read · gate none · live · answers FuelEconomyMpgRead@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GTW7BFP7L1247147 (the VIN lens).

Try it — live: answers on the wire today. A sandbox key still selects the deterministic simulated mode — drive the full outcome range with the magic triggers.

the SDK — fuelEconomy.mpgRead
import { fuelEconomy } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuelEconomy.mpgRead({"vin":"1GTW7BFP7L1247147"})
GET /fuel-economies/mpg-read
curl 'https://apis.vin/fuel-economies/mpg-read?vin=1GTW7BFP7L1247147'

rangeRead

fuelEconomy.rangeRead · GET /fuel-economies/range-read · gate none · live · answers FuelEconomyRangeRead@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GTW7BFP7L1247147 (the VIN lens).

Try it — live: answers on the wire today. A sandbox key still selects the deterministic simulated mode — drive the full outcome range with the magic triggers.

the SDK — fuelEconomy.rangeRead
import { fuelEconomy } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuelEconomy.rangeRead({"vin":"1GTW7BFP7L1247147"})
GET /fuel-economies/range-read
curl 'https://apis.vin/fuel-economies/range-read?vin=1GTW7BFP7L1247147'

Data model

The record shape behind this noun — one entity, each property an evidence field. See the whole estate model on the data model page.

Vehicle

Modeled

The noun drawn out — its record shape, its lifecycle, and how it is exercised end to end. 2 diagrams, rendered from the estate model.

FuelEconomy · Class model

FuelEconomy · Sequence

Generated from the catalog. Every capability, answer, gate, and entity on this page is a rendered descriptor — it cannot drift from the wire.

fuel

The fuel noun — identity, lifecycle, events, and every capability as an anchored section: 12 capabilities, 0 live, 12 sandbox, 0 declared.

garage

The garage noun — identity, lifecycle, events, and every capability as an anchored section: 2 capabilities, 0 live, 2 sandbox, 0 declared.

On this page

Identity
Discover & read
lookup
compare
co2Read
mpgRead
rangeRead
Data model
Vehicle
Modeled