docs.vin

suspension

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

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

Identity

Nounsuspension
PillarData (facets: 10 data · 10 services · 6 commerce)
Capabilities26 — 2 live · 24 sandbox · 0 declared
EntitiesRepairOrder
Doorsaggregator.vin
SDKVin.suspension.* from apis.vin
Address/catalog/suspension#{action} — the anchor IS the wire name minus suspension.

Events

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

Discover & read

decode

suspension.decode · GET /suspensions/decode · gate none · live · answers SuspensionDecode@1

FieldTypeRequiredNotes
vinstringno—

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

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

spec

suspension.spec · GET /suspensions/spec · gate none · live · answers SuspensionSpec@1

FieldTypeRequiredNotes
vinstringno—

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

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

history

suspension.history · GET /suspensions/history · gate none · sandbox · answers SuspensionHistory@1

FieldTypeRequiredNotes
vinstringno—

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

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

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:17.842Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionHistory@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "events": [
      {
        "date": "2024-03-14",
        "kind": "maintenance",
        "description": "scheduled suspension service"
      },
      {
        "date": "2024-11-02",
        "kind": "maintenance",
        "description": "scheduled suspension service"
      }
    ],
    "count": 2
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "events": [
      {
        "date": "2024-03-14",
        "kind": "maintenance",
        "description": "scheduled suspension service"
      },
      {
        "date": "2024-11-02",
        "kind": "maintenance",
        "description": "scheduled suspension service"
      }
    ],
    "count": 2
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

status

suspension.status · GET /suspensions/status · gate none · sandbox · answers SuspensionStatus@1

FieldTypeRequiredNotes
vinstringno—

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

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

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:17.870Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionStatus@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "findings": []
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "findings": []
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

healthCheck

suspension.healthCheck · GET /suspensions/health-check · gate none · sandbox · answers SuspensionHealthCheck@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await suspension.healthCheck({"vin":"1FT8W3DT5NEC59455"})
GET /suspensions/health-check
curl 'https://apis.vin/suspensions/health-check?vin=1FT8W3DT5NEC59455'

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:17.842Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionHealthCheck@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "findings": []
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "findings": []
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

measure

suspension.measure · GET /suspensions/measure · gate key · sandbox · answers SuspensionMeasure@1

FieldTypeRequiredNotes
vinstringno—

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

the SDK — suspension.measure
import { suspension } from 'apis.vin'

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

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:17.847Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionMeasure@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "measurement": "measure",
    "reading": 57,
    "unit": "index",
    "withinSpec": true
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "measurement": "measure",
    "reading": 57,
    "unit": "index",
    "withinSpec": true
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

alignmentRead

suspension.alignmentRead · GET /suspensions/alignment-read · gate none · sandbox · answers SuspensionAlignmentRead@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await suspension.alignmentRead({"vin":"1FT8W3DT5NEC59455"})
GET /suspensions/alignment-read
curl 'https://apis.vin/suspensions/alignment-read?vin=1FT8W3DT5NEC59455'

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:17.810Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionAlignmentRead@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "measurement": "alignmentRead",
    "reading": 53,
    "unit": "index",
    "withinSpec": true
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "measurement": "alignmentRead",
    "reading": 53,
    "unit": "index",
    "withinSpec": true
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

conditionRead

suspension.conditionRead · GET /suspensions/condition-read · gate none · sandbox · answers SuspensionConditionRead@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await suspension.conditionRead({"vin":"1FT8W3DT5NEC59455"})
GET /suspensions/condition-read
curl 'https://apis.vin/suspensions/condition-read?vin=1FT8W3DT5NEC59455'

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:17.817Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionConditionRead@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "findings": []
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "findings": []
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

wearPredict

suspension.wearPredict · GET /suspensions/wear-predict · gate none · sandbox · answers SuspensionWearPredict@1

No input — this capability takes no request body.

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await suspension.wearPredict()
GET /suspensions/wear-predict
curl 'https://apis.vin/suspensions/wear-predict'

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-16T14:50:10.056Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionWearPredict@1",
  "value": {
    "vin": "1HGCM82633A004352",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "remainingLifePct": 86,
    "failureRiskPct": 6,
    "horizonMiles": 12000
  },
  "evidence": {
    "vin": "1HGCM82633A004352",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "remainingLifePct": 86,
    "failureRiskPct": 6,
    "horizonMiles": 12000
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Quote & price

quote

suspension.quote · POST /suspensions/quote · gate offer · sandbox · answers SuspensionQuote@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) · /1FT8W3DT5NEC59455 (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 — Suspension.quoted@1.

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

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

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:17.849Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionQuote@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "band": "pass",
    "estimateId": "EST-cc76883e",
    "laborCents": 50600,
    "partsCents": 41400,
    "subtotalCents": 92000,
    "partSource": "aftermarket",
    "currency": "USD"
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "band": "pass",
    "estimateId": "EST-cc76883e",
    "laborCents": 50600,
    "partsCents": 41400,
    "subtotalCents": 92000,
    "partSource": "aftermarket",
    "currency": "USD"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

estimate

suspension.estimate · POST /suspensions/estimate · gate offer · sandbox · answers SuspensionEstimate@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) · /1FT8W3DT5NEC59455 (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 — Suspension.estimateRequested@1 · Suspension.estimated@1.

the SDK — suspension.estimate
import { suspension } from 'apis.vin'

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

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:17.830Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionEstimate@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "band": "pass",
    "estimateId": "EST-85a0844c",
    "laborCents": 50600,
    "partsCents": 41400,
    "subtotalCents": 92000,
    "partSource": "aftermarket",
    "currency": "USD"
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "band": "pass",
    "estimateId": "EST-85a0844c",
    "laborCents": 50600,
    "partsCents": 41400,
    "subtotalCents": 92000,
    "partSource": "aftermarket",
    "currency": "USD"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

order

suspension.order · POST /suspensions/order · gate offer · sandbox · answers SuspensionOrder@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) · /1FT8W3DT5NEC59455 (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 — Order.placed@1 · ServiceOrder.settled@1 · Suspension.completed@1 · Suspension.dispatched@1 · Suspension.ordered@1.

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

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

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:17.849Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionOrder@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-f8f59a3a",
      "operation": "order",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-f8f59a3a",
      "operation": "order",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

suspension.pay · POST /suspensions/pay · gate offer · sandbox · answers SuspensionPay@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) · /1FT8W3DT5NEC59455 (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 — ServiceOrder.settled@1 · Suspension.charged@1 · Suspension.paid@1 · Suspension.payFailed@1 · Suspension.payRequested@1.

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

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

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:17.849Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionPay@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "payment": {
      "id": "PAY-b0712d24",
      "status": "settled",
      "amountCents": 46000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "payment": {
      "id": "PAY-b0712d24",
      "status": "settled",
      "amountCents": 46000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

refund

suspension.refund · POST /suspensions/refund · gate offer · sandbox · answers SuspensionRefund@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) · /1FT8W3DT5NEC59455 (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 — Suspension.refunded@1.

the SDK — suspension.refund
import { suspension } from 'apis.vin'

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

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:17.849Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionRefund@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "refund": {
      "id": "RF-bf310ec8",
      "status": "issued",
      "amountCents": 9200,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "refund": {
      "id": "RF-bf310ec8",
      "status": "issued",
      "amountCents": 9200,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

repair

suspension.repair · POST /suspensions/repair · gate offer · sandbox · answers SuspensionRepair@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) · /1FT8W3DT5NEC59455 (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 — Suspension.repaired@1.

the SDK — suspension.repair
import { suspension } from 'apis.vin'

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

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:17.857Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionRepair@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-ec0fbabf",
      "operation": "repair",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-ec0fbabf",
      "operation": "repair",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

replace

suspension.replace · POST /suspensions/replace · gate offer · sandbox · answers SuspensionReplace@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) · /1FT8W3DT5NEC59455 (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 — Suspension.replaced@1.

the SDK — suspension.replace
import { suspension } from 'apis.vin'

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

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:17.857Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionReplace@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-dc55f33e",
      "operation": "replace",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-dc55f33e",
      "operation": "replace",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

diagnose

suspension.diagnose · POST /suspensions/diagnose · gate offer · sandbox · answers SuspensionDiagnose@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) · /1FT8W3DT5NEC59455 (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 — Suspension.diagnosed@1.

the SDK — suspension.diagnose
import { suspension } from 'apis.vin'

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

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:17.826Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionDiagnose@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "faults": [],
    "faultCount": 0
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "faults": [],
    "faultCount": 0
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

inspect

suspension.inspect · POST /suspensions/inspect · gate offer · sandbox · answers SuspensionInspect@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) · /1FT8W3DT5NEC59455 (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 — Suspension.inspectRequested@1 · Suspension.inspected@1.

the SDK — suspension.inspect
import { suspension } from 'apis.vin'

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

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:17.842Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionInspect@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "findings": []
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "findings": []
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

bushingReplace

suspension.bushingReplace · POST /suspensions/bushing-replace · gate offer · sandbox · answers SuspensionBushingReplace@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) · /1FT8W3DT5NEC59455 (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 — Suspension.bushingReplaceFailed@1 · Suspension.bushingReplaceRequested@1 · Suspension.bushingReplaced@1.

the SDK — suspension.bushingReplace
import { suspension } from 'apis.vin'

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

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:17.811Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionBushingReplace@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-6d8fbf3c",
      "operation": "bushingReplace",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-6d8fbf3c",
      "operation": "bushingReplace",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

shockReplace

suspension.shockReplace · POST /suspensions/shock-replace · gate offer · sandbox · answers SuspensionShockReplace@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) · /1FT8W3DT5NEC59455 (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 — Suspension.shockReplaced@1.

the SDK — suspension.shockReplace
import { suspension } from 'apis.vin'

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

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:17.863Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionShockReplace@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-f900fdc8",
      "operation": "shockReplace",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-f900fdc8",
      "operation": "shockReplace",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

springReplace

suspension.springReplace · POST /suspensions/spring-replace · gate offer · sandbox · answers SuspensionSpringReplace@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) · /1FT8W3DT5NEC59455 (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 — Suspension.springReplaced@1.

the SDK — suspension.springReplace
import { suspension } from 'apis.vin'

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

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:17.870Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionSpringReplace@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-e1cf4fb9",
      "operation": "springReplace",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-e1cf4fb9",
      "operation": "springReplace",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

strutReplace

suspension.strutReplace · POST /suspensions/strut-replace · gate offer · sandbox · answers SuspensionStrutReplace@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) · /1FT8W3DT5NEC59455 (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 — Suspension.strutReplaceFailed@1 · Suspension.strutReplaceRequested@1 · Suspension.strutReplaced@1.

the SDK — suspension.strutReplace
import { suspension } from 'apis.vin'

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

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:17.878Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionStrutReplace@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-722e11c4",
      "operation": "strutReplace",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-722e11c4",
      "operation": "strutReplace",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Authorize & resolve

warrantyClaim

suspension.warrantyClaim · POST /suspensions/warranty-claim · gate offer · sandbox · answers SuspensionWarrantyClaim@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) · /1FT8W3DT5NEC59455 (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 — Suspension.warrantyClaimFiled@1 · WarrantyClaim.approved@1 · WarrantyClaim.reimbursed@1.

the SDK — suspension.warrantyClaim
import { suspension } from 'apis.vin'

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

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:17.890Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionWarrantyClaim@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "warranty": "active",
    "claim": {
      "id": "WC-8208640e",
      "decision": "approved"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "warranty": "active",
    "claim": {
      "id": "WC-8208640e",
      "decision": "approved"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

warrantyCheck

suspension.warrantyCheck · GET /suspensions/warranty-check · gate none · sandbox · answers SuspensionWarrantyCheck@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await suspension.warrantyCheck({"vin":"1FT8W3DT5NEC59455"})
GET /suspensions/warranty-check
curl 'https://apis.vin/suspensions/warranty-check?vin=1FT8W3DT5NEC59455'

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:17.885Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionWarrantyCheck@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "warranty": "active",
    "void": false,
    "coverageMilesLeft": 36819
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "warranty": "active",
    "void": false,
    "coverageMilesLeft": 36819
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

align

suspension.align · POST /suspensions/align · gate offer · sandbox · answers SuspensionAlign@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) · /1FT8W3DT5NEC59455 (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 — Suspension.alignFailed@1 · Suspension.alignRequested@1 · Suspension.aligned@1.

the SDK — suspension.align
import { suspension } from 'apis.vin'

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

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:17.808Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionAlign@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-665c63b3",
      "operation": "align",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-665c63b3",
      "operation": "align",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

level

suspension.level · POST /suspensions/level · gate offer · sandbox · answers SuspensionLevel@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) · /1FT8W3DT5NEC59455 (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 — Suspension.levelRequested@1 · Suspension.leveled@1.

the SDK — suspension.level
import { suspension } from 'apis.vin'

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

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:17.847Z · HTTP 200
{
  "type": "OK",
  "answers": "SuspensionLevel@1",
  "value": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-92f7ccf0",
      "operation": "level",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1FT8W3DT5NEC59455",
    "system": "suspension",
    "asOf": "2026-08-10",
    "verdict": "pass",
    "workOrder": {
      "id": "WO-92f7ccf0",
      "operation": "level",
      "status": "scheduled",
      "costCents": 46000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "wear-systems-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.

storage

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

taxes

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

On this page

Identity
Events
Discover & read
decode
spec
history
status
healthCheck
measure
alignmentRead
conditionRead
wearPredict
Quote & price
quote
estimate
Apply & book
order
Pay & settle
pay
refund
Fulfill & operate
repair
replace
diagnose
inspect
bushingReplace
shockReplace
springReplace
strutReplace
Authorize & resolve
warrantyClaim
warrantyCheck
More actions
align
level
Data model
RepairOrder