docs.vin

fuel

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

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

Identity

Nounfuel
PillarData (facets: 5 data · 3 services · 4 commerce)
Capabilities12 — 0 live · 12 sandbox · 0 declared
EntitiesUsage
Doorsaggregator.vin
SDKVin.fuel.* from apis.vin
Address/catalog/fuel#{action} — the anchor IS the wire name minus fuel.

Events

The vocabulary this noun can append to the record — 17 past-tense, versioned event types, each linked to the capability that emits it:

Discover & read

history

fuel.history · GET /fuels/history · gate none · sandbox · answers FuelHistory@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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 — fuel.history
import { fuel } from 'apis.vin'

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

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.925Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelHistory@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "fills": [
      {
        "date": "2026-07-20",
        "grade": "regular-87",
        "gallons": 12,
        "amountCents": 4188,
        "currency": "USD"
      },
      {
        "date": "2026-07-27",
        "grade": "regular-87",
        "gallons": 12.8,
        "amountCents": 4467,
        "currency": "USD"
      },
      {
        "date": "2026-08-03",
        "grade": "regular-87",
        "gallons": 10.4,
        "amountCents": 3630,
        "currency": "USD"
      }
    ]
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "fills": [
      {
        "date": "2026-07-20",
        "grade": "regular-87",
        "gallons": 12,
        "amountCents": 4188,
        "currency": "USD"
      },
      {
        "date": "2026-07-27",
        "grade": "regular-87",
        "gallons": 12.8,
        "amountCents": 4467,
        "currency": "USD"
      },
      {
        "date": "2026-08-03",
        "grade": "regular-87",
        "gallons": 10.4,
        "amountCents": 3630,
        "currency": "USD"
      }
    ]
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

gradeLookup

fuel.gradeLookup · GET /fuels/grade-lookup · gate none · sandbox · answers FuelGradeLookup@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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 — fuel.gradeLookup
import { fuel } from 'apis.vin'

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

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.915Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelGradeLookup@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "grade": {
      "required": "regular-87",
      "fuel": "gasoline",
      "tankCapacityGal": "14.8",
      "basis": "wave-4-fuel-system-sheet"
    }
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "grade": {
      "required": "regular-87",
      "fuel": "gasoline",
      "tankCapacityGal": "14.8",
      "basis": "wave-4-fuel-system-sheet"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

stationLocate

fuel.stationLocate · GET /fuels/station-locate · gate none · sandbox · answers FuelStationLocate@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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 — fuel.stationLocate
import { fuel } from 'apis.vin'

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

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.947Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelStationLocate@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "stations": [
      {
        "id": "FUEL-ISLAND",
        "kind": "dealer-fuel-island",
        "dealerId": "DLR-b9066ade",
        "onSite": true,
        "distanceMiles": 0
      },
      {
        "id": "STN-1455498d",
        "kind": "independent-station",
        "onSite": false,
        "distanceMiles": 3
      }
    ]
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "stations": [
      {
        "id": "FUEL-ISLAND",
        "kind": "dealer-fuel-island",
        "dealerId": "DLR-b9066ade",
        "onSite": true,
        "distanceMiles": 0
      },
      {
        "id": "STN-1455498d",
        "kind": "independent-station",
        "onSite": false,
        "distanceMiles": 3
      }
    ]
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Quote & price

quote

fuel.quote · POST /fuels/quote · gate offer · sandbox · answers FuelQuote@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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.

Emits — Fuel.quoteRequested@1 · Fuel.quoted@1.

the SDK — fuel.quote
import { fuel } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuel.quote({"vin":"1GKS2EKL4PR359207"})
POST /fuels/quote
curl -X POST https://apis.vin/fuels/quote \
  -H 'content-type: application/json' \
  -d '{"vin":"1GKS2EKL4PR359207"}'

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.947Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelQuote@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "quote": {
      "id": "FQ-fd134699",
      "grade": "regular-87",
      "gallons": 12.3,
      "levelPct": 17,
      "pricePerGallonCents": 349,
      "amountCents": 4293,
      "currency": "USD",
      "status": "quoted"
    }
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "quote": {
      "id": "FQ-fd134699",
      "grade": "regular-87",
      "gallons": 12.3,
      "levelPct": 17,
      "pricePerGallonCents": 349,
      "amountCents": 4293,
      "currency": "USD",
      "status": "quoted"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

price

fuel.price · GET /fuels/price · gate none · sandbox · answers FuelPrice@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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 — fuel.price
import { fuel } from 'apis.vin'

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

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.946Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelPrice@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "prices": {
      "perGallonCents": {
        "regular-87": 349,
        "midgrade-89": 389,
        "premium-91": 429,
        "diesel": 419
      },
      "currency": "USD",
      "unit": "per-gallon"
    }
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "prices": {
      "perGallonCents": {
        "regular-87": 349,
        "midgrade-89": 389,
        "premium-91": 429,
        "diesel": 419
      },
      "currency": "USD",
      "unit": "per-gallon"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

fuel.pay · POST /fuels/pay · gate offer · sandbox · answers FuelPay@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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.

Emits — Fuel.paid@1 · Fuel.payFailed@1 · Fuel.payRequested@1.

the SDK — fuel.pay
import { fuel } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuel.pay({"vin":"1GKS2EKL4PR359207"})
POST /fuels/pay
curl -X POST https://apis.vin/fuels/pay \
  -H 'content-type: application/json' \
  -d '{"vin":"1GKS2EKL4PR359207"}'

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.936Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelPay@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "payment": {
      "id": "PAY-56397f67",
      "status": "settled",
      "amountCents": 4293,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "payment": {
      "id": "PAY-56397f67",
      "status": "settled",
      "amountCents": 4293,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

reimburse

fuel.reimburse · POST /fuels/reimburse · gate offer · sandbox · answers FuelReimburse@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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.

Emits — Fuel.reimburseRequested@1 · Fuel.reimbursed@1.

the SDK — fuel.reimburse
import { fuel } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuel.reimburse({"vin":"1GKS2EKL4PR359207"})
POST /fuels/reimburse
curl -X POST https://apis.vin/fuels/reimburse \
  -H 'content-type: application/json' \
  -d '{"vin":"1GKS2EKL4PR359207"}'

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.947Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelReimburse@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "reimbursement": {
      "status": "denied",
      "reason": "coverage-expired"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "reimbursement": {
      "status": "denied",
      "reason": "coverage-expired"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

cardSettle

fuel.cardSettle · POST /fuels/card-settle · gate offer · sandbox · answers FuelCardSettle@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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.

Emits — Fuel.cardSettleFailed@1 · Fuel.cardSettleRequested@1 · Fuel.cardSettled@1.

the SDK — fuel.cardSettle
import { fuel } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuel.cardSettle({"vin":"1GKS2EKL4PR359207"})
POST /fuels/card-settle
curl -X POST https://apis.vin/fuels/card-settle \
  -H 'content-type: application/json' \
  -d '{"vin":"1GKS2EKL4PR359207"}'

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.914Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelCardSettle@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "settlement": {
      "id": "FCS-e1832c26",
      "instrument": "fleet-fuel-card",
      "status": "settled",
      "amountCents": 4293,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "settlement": {
      "id": "FCS-e1832c26",
      "instrument": "fleet-fuel-card",
      "status": "settled",
      "amountCents": 4293,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

deliver

fuel.deliver · POST /fuels/deliver · gate offer · sandbox · answers FuelDeliver@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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.

Emits — Fuel.deliverFailed@1 · Fuel.deliverRequested@1 · Fuel.delivered@1.

the SDK — fuel.deliver
import { fuel } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuel.deliver({"vin":"1GKS2EKL4PR359207"})
POST /fuels/deliver
curl -X POST https://apis.vin/fuels/deliver \
  -H 'content-type: application/json' \
  -d '{"vin":"1GKS2EKL4PR359207"}'

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.915Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelDeliver@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "delivery": {
      "status": "delivered",
      "gallons": 2,
      "amountCents": 7500,
      "currency": "USD",
      "basis": "wave-18-roadside-service-figure"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "delivery": {
      "status": "delivered",
      "gallons": 2,
      "amountCents": 7500,
      "currency": "USD",
      "basis": "wave-18-roadside-service-figure"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

consumption

fuel.consumption · GET /fuels/consumption · gate none · sandbox · answers FuelConsumption@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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 — fuel.consumption
import { fuel } from 'apis.vin'

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

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.915Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelConsumption@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "consumption": {
      "odometerMiles": 70730,
      "mpg": 24,
      "lifetimeGallons": 2947,
      "basis": "one-mileage-law"
    }
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "consumption": {
      "odometerMiles": 70730,
      "mpg": 24,
      "lifetimeGallons": 2947,
      "basis": "one-mileage-law"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

dispense

fuel.dispense · POST /fuels/dispense · gate offer · sandbox · answers FuelDispense@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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.

Emits — Fuel.dispenseRequested@1 · Fuel.dispensed@1.

the SDK — fuel.dispense
import { fuel } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuel.dispense({"vin":"1GKS2EKL4PR359207"})
POST /fuels/dispense
curl -X POST https://apis.vin/fuels/dispense \
  -H 'content-type: application/json' \
  -d '{"vin":"1GKS2EKL4PR359207"}'

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.915Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelDispense@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "work": {
      "operation": "fuel-dispense",
      "status": "dispensed",
      "grade": "regular-87",
      "gallons": 12.3,
      "amountCents": 4293,
      "currency": "USD",
      "levelAfterPct": 100
    }
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "work": {
      "operation": "fuel-dispense",
      "status": "dispensed",
      "grade": "regular-87",
      "gallons": 12.3,
      "amountCents": 4293,
      "currency": "USD",
      "levelAfterPct": 100
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

fill

fuel.fill · POST /fuels/fill · gate offer · sandbox · answers FuelFill@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2EKL4PR359207 (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.

Emits — Fuel.fillRequested@1 · Fuel.filled@1.

the SDK — fuel.fill
import { fuel } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fuel.fill({"vin":"1GKS2EKL4PR359207"})
POST /fuels/fill
curl -X POST https://apis.vin/fuels/fill \
  -H 'content-type: application/json' \
  -d '{"vin":"1GKS2EKL4PR359207"}'

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.915Z · HTTP 200
{
  "type": "OK",
  "answers": "FuelFill@1",
  "value": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "work": {
      "operation": "fuel-fill",
      "status": "filled",
      "grade": "regular-87",
      "gallons": 12.3,
      "amountCents": 4293,
      "currency": "USD",
      "levelAfterPct": 100
    }
  },
  "evidence": {
    "vin": "1GKS2EKL4PR359207",
    "noun": "fuel",
    "asOf": "2026-08-10",
    "work": {
      "operation": "fuel-fill",
      "status": "filled",
      "grade": "regular-87",
      "gallons": 12.3,
      "amountCents": 4293,
      "currency": "USD",
      "levelAfterPct": 100
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "courtesy-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

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.

Usage

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

fraudCase

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

fuelEconomy

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

On this page

Identity
Events
Discover & read
history
gradeLookup
stationLocate
Quote & price
quote
price
Pay & settle
pay
reimburse
cardSettle
Fulfill & operate
deliver
More actions
consumption
dispense
fill
Data model
Usage