docs.vin

oilChange

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

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

Identity

NounoilChange
PillarServices (facets: 5 data · 6 services · 4 commerce)
Capabilities15 — 0 live · 15 sandbox · 0 declared
EntitiesRepairOrder
Doorsaggregator.vin
SDKVin.oilChange.* from apis.vin
Address/catalog/oilChange#{action} — the anchor IS the wire name minus oilChange.

Events

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

Discover & read

spec

oilChange.spec · GET /oil-changes/spec · gate none · sandbox · answers OilChangeSpec@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await oilChange.spec({"vin":"1FMCU9JAXSUB45535"})
GET /oil-changes/spec
curl 'https://apis.vin/oil-changes/spec?vin=1FMCU9JAXSUB45535'

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:14.655Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeSpec@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "spec": {
      "oilGrade": "0W-20",
      "oilCapacityTenthsQt": 48,
      "coolant": "long-life",
      "intervalMiles": 7500
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "spec": {
      "oilGrade": "0W-20",
      "oilCapacityTenthsQt": 48,
      "coolant": "long-life",
      "intervalMiles": 7500
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

history

oilChange.history · GET /oil-changes/history · gate none · sandbox · answers OilChangeHistory@1

FieldTypeRequiredNotes
vinstringno—

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

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

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:14.630Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeHistory@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "events": [
      {
        "date": "2024-03-14",
        "kind": "routine",
        "description": "routine oil change record"
      }
    ]
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "events": [
      {
        "date": "2024-03-14",
        "kind": "routine",
        "description": "routine oil change record"
      }
    ]
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

gradeLookup

oilChange.gradeLookup · GET /oil-changes/grade-lookup · gate none · sandbox · answers OilChangeGradeLookup@1

FieldTypeRequiredNotes
vinstringno—

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

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

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:14.629Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeGradeLookup@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "grade": {
      "oilGrade": "0W-20",
      "capacityTenthsQt": 48
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "grade": {
      "oilGrade": "0W-20",
      "capacityTenthsQt": 48
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Quote & price

quote

oilChange.quote · POST /oil-changes/quote · gate offer · sandbox · answers OilChangeQuote@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) · /1FMCU9JAXSUB45535 (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 — OilChange.quoteRequested@1 · OilChange.quoted@1.

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

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

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:14.655Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeQuote@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "quote": {
      "id": "OQ-e712fe2b",
      "amountCents": 8900,
      "currency": "USD",
      "status": "extended"
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "quote": {
      "id": "OQ-e712fe2b",
      "amountCents": 8900,
      "currency": "USD",
      "status": "extended"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

order

oilChange.order · POST /oil-changes/order · gate offer · sandbox · answers OilChangeOrder@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) · /1FMCU9JAXSUB45535 (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 — OilChange.completed@1 · OilChange.dispatched@1 · OilChange.ordered@1 · ServiceOrder.settled@1.

the SDK — oilChange.order
import { oilChange } from 'apis.vin'

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

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:14.654Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeOrder@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "order": {
      "id": "ORD-a46a7d73",
      "service": "oil change",
      "status": "placed",
      "amountCents": 8900,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "order": {
      "id": "ORD-a46a7d73",
      "service": "oil change",
      "status": "placed",
      "amountCents": 8900,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

schedule

oilChange.schedule · POST /oil-changes/schedule · gate offer · sandbox · answers OilChangeSchedule@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) · /1FMCU9JAXSUB45535 (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 — OilChange.scheduleRequested@1 · OilChange.scheduled@1.

the SDK — oilChange.schedule
import { oilChange } from 'apis.vin'

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

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:14.655Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeSchedule@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "appointment": {
      "id": "APT-aa1cddbb",
      "date": "2026-08-12",
      "status": "scheduled"
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "appointment": {
      "id": "APT-aa1cddbb",
      "date": "2026-08-12",
      "status": "scheduled"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

oilChange.pay · POST /oil-changes/pay · gate offer · sandbox · answers OilChangePay@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) · /1FMCU9JAXSUB45535 (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 — OilChange.paid@1 · OilChange.payFailed@1 · OilChange.payRequested@1.

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

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

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:14.655Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangePay@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "payment": {
      "id": "PAY-0485ea2d",
      "status": "settled",
      "amountCents": 8900,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "payment": {
      "id": "PAY-0485ea2d",
      "status": "settled",
      "amountCents": 8900,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

packageBuy

oilChange.packageBuy · POST /oil-changes/package-buy · gate offer · sandbox · answers OilChangePackageBuy@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) · /1FMCU9JAXSUB45535 (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 — OilChange.packageBought@1 · OilChange.packageBuyRequested@1.

the SDK — oilChange.packageBuy
import { oilChange } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await oilChange.packageBuy({"vin":"1FMCU9JAXSUB45535"})
POST /oil-changes/package-buy
curl -X POST https://apis.vin/oil-changes/package-buy \
  -H 'content-type: application/json' \
  -d '{"vin":"1FMCU9JAXSUB45535"}'

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:14.654Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangePackageBuy@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "package": {
      "id": "OP-2da3fdff",
      "services": 3,
      "amountCents": 23900,
      "currency": "USD",
      "status": "active"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "package": {
      "id": "OP-2da3fdff",
      "services": 3,
      "amountCents": 23900,
      "currency": "USD",
      "status": "active"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

perform

oilChange.perform · POST /oil-changes/perform · gate offer · sandbox · answers OilChangePerform@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) · /1FMCU9JAXSUB45535 (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 — OilChange.performFailed@1 · OilChange.performRequested@1 · OilChange.performed@1.

the SDK — oilChange.perform
import { oilChange } from 'apis.vin'

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

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:14.655Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangePerform@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "work": {
      "id": "OC-95ab1ac6",
      "operation": "perform",
      "status": "performed"
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "work": {
      "id": "OC-95ab1ac6",
      "operation": "perform",
      "status": "performed"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

filterReplace

oilChange.filterReplace · POST /oil-changes/filter-replace · gate offer · sandbox · answers OilChangeFilterReplace@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) · /1FMCU9JAXSUB45535 (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 — OilChange.filterReplaceFailed@1 · OilChange.filterReplaceRequested@1 · OilChange.filterReplaced@1.

the SDK — oilChange.filterReplace
import { oilChange } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await oilChange.filterReplace({"vin":"1FMCU9JAXSUB45535"})
POST /oil-changes/filter-replace
curl -X POST https://apis.vin/oil-changes/filter-replace \
  -H 'content-type: application/json' \
  -d '{"vin":"1FMCU9JAXSUB45535"}'

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:14.625Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeFilterReplace@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "work": {
      "id": "OC-3d6f878d",
      "operation": "filterReplace",
      "status": "replaced"
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "work": {
      "id": "OC-3d6f878d",
      "operation": "filterReplace",
      "status": "replaced"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Lifecycle & state

reset

oilChange.reset · POST /oil-changes/reset · gate offer · sandbox · answers OilChangeReset@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) · /1FMCU9JAXSUB45535 (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 — OilChange.resetRequested@1 · OilChange.reset@1.

the SDK — oilChange.reset
import { oilChange } from 'apis.vin'

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

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:14.655Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeReset@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "reset": {
      "status": "reset"
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "reset": {
      "status": "reset"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

drain

oilChange.drain · POST /oil-changes/drain · gate offer · sandbox · answers OilChangeDrain@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) · /1FMCU9JAXSUB45535 (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 — OilChange.drainRequested@1 · OilChange.drained@1.

the SDK — oilChange.drain
import { oilChange } from 'apis.vin'

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

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:14.624Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeDrain@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "work": {
      "id": "OC-5fcbaa0d",
      "operation": "drain",
      "status": "drained"
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "work": {
      "id": "OC-5fcbaa0d",
      "operation": "drain",
      "status": "drained"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

due

oilChange.due · GET /oil-changes/due · gate none · sandbox · answers OilChangeDue@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await oilChange.due({"vin":"1FMCU9JAXSUB45535"})
GET /oil-changes/due
curl 'https://apis.vin/oil-changes/due?vin=1FMCU9JAXSUB45535'

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:14.625Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeDue@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "due": {
      "dueNow": true,
      "intervalMiles": 7500,
      "currentMiles": 72198,
      "nextServiceMiles": 72198,
      "milesToNext": 0
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "due": {
      "dueNow": true,
      "intervalMiles": 7500,
      "currentMiles": 72198,
      "nextServiceMiles": 72198,
      "milesToNext": 0
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

lifeRemaining

oilChange.lifeRemaining · GET /oil-changes/life-remaining · gate key · sandbox · answers OilChangeLifeRemaining@1

FieldTypeRequiredNotes
vinstringno—

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

the SDK — oilChange.lifeRemaining
import { oilChange } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await oilChange.lifeRemaining({"vin":"1FMCU9JAXSUB45535"})
GET /oil-changes/life-remaining
curl 'https://apis.vin/oil-changes/life-remaining?vin=1FMCU9JAXSUB45535'

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:14.638Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeLifeRemaining@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "life": {
      "remainingPct": 0,
      "milesToNext": 0,
      "intervalMiles": 7500
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "life": {
      "remainingPct": 0,
      "milesToNext": 0,
      "intervalMiles": 7500
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

topOff

oilChange.topOff · POST /oil-changes/top-off · gate offer · sandbox · answers OilChangeTopOff@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) · /1FMCU9JAXSUB45535 (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 — OilChange.topOffRequested@1 · OilChange.toppedOff@1.

the SDK — oilChange.topOff
import { oilChange } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await oilChange.topOff({"vin":"1FMCU9JAXSUB45535"})
POST /oil-changes/top-off
curl -X POST https://apis.vin/oil-changes/top-off \
  -H 'content-type: application/json' \
  -d '{"vin":"1FMCU9JAXSUB45535"}'

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:14.661Z · HTTP 200
{
  "type": "OK",
  "answers": "OilChangeTopOff@1",
  "value": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "work": {
      "id": "OC-e6957715",
      "operation": "topOff",
      "status": "topped-off",
      "addedTenthsQt": 6
    }
  },
  "evidence": {
    "vin": "1FMCU9JAXSUB45535",
    "noun": "oilChange",
    "asOf": "2026-08-10",
    "dueNow": true,
    "work": {
      "id": "OC-e6957715",
      "operation": "topOff",
      "status": "topped-off",
      "addedTenthsQt": 6
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wrench-wear-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.

RepairOrder

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

offer

The offer noun — identity, lifecycle, events, and every capability as an anchored section: 15 capabilities, 1 live, 14 sandbox, 0 declared.

order

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

On this page

Identity
Events
Discover & read
spec
history
gradeLookup
Quote & price
quote
Apply & book
order
schedule
Pay & settle
pay
packageBuy
Fulfill & operate
perform
filterReplace
Lifecycle & state
reset
More actions
drain
due
lifeRemaining
topOff
Data model
RepairOrder