docs.vin

chargerHardware

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

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

Identity

NounchargerHardware
PillarData (facets: 5 data · 5 services · 4 commerce)
Capabilities14 — 0 live · 14 sandbox · 0 declared
EntitiesServiceOrder
Doorsaggregator.vin
SDKVin.chargerHardware.* from apis.vin
Address/catalog/chargerHardware#{action} — the anchor IS the wire name minus chargerHardware.

Events

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

Discover & read

spec

chargerHardware.spec · GET /charger-hardwares/spec · gate none · sandbox · answers ChargerHardwareSpec@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await chargerHardware.spec({"vin":"3GCUKFED1SG157755"})
GET /charger-hardwares/spec
curl 'https://apis.vin/charger-hardwares/spec?vin=3GCUKFED1SG157755'

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:08.988Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareSpec@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "spec": {
      "maxKw": 150,
      "connectors": {
        "dc": "CCS",
        "ac": "J1772"
      },
      "stallsTotal": 12
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "spec": {
      "maxKw": 150,
      "connectors": {
        "dc": "CCS",
        "ac": "J1772"
      },
      "stallsTotal": 12
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

faultRead

chargerHardware.faultRead · GET /charger-hardwares/fault-read · gate none · sandbox · answers ChargerHardwareFaultRead@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await chargerHardware.faultRead({"vin":"3GCUKFED1SG157755"})
GET /charger-hardwares/fault-read
curl 'https://apis.vin/charger-hardwares/fault-read?vin=3GCUKFED1SG157755'

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:08.949Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareFaultRead@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "fault": {
      "status": "no-fault",
      "readiness": "ready"
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "fault": {
      "status": "no-fault",
      "readiness": "ready"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

statusRead

chargerHardware.statusRead · GET /charger-hardwares/status-read · gate none · sandbox · answers ChargerHardwareStatusRead@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await chargerHardware.statusRead({"vin":"3GCUKFED1SG157755"})
GET /charger-hardwares/status-read
curl 'https://apis.vin/charger-hardwares/status-read?vin=3GCUKFED1SG157755'

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:08.988Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareStatusRead@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "charger": {
      "id": "CHG-738ff67e",
      "standing": "operational",
      "maxKw": 150,
      "firmwareVersion": "4.9.0",
      "stallsTotal": 12
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "charger": {
      "id": "CHG-738ff67e",
      "standing": "operational",
      "maxKw": 150,
      "firmwareVersion": "4.9.0",
      "stallsTotal": 12
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

uptimeRead

chargerHardware.uptimeRead · GET /charger-hardwares/uptime-read · gate none · sandbox · answers ChargerHardwareUptimeRead@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await chargerHardware.uptimeRead({"vin":"3GCUKFED1SG157755"})
GET /charger-hardwares/uptime-read
curl 'https://apis.vin/charger-hardwares/uptime-read?vin=3GCUKFED1SG157755'

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:08.988Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareUptimeRead@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "uptime": {
      "uptimePct": 99.6,
      "windowDays": 30
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "uptime": {
      "uptimePct": 99.6,
      "windowDays": 30
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

utilizationRead

chargerHardware.utilizationRead · GET /charger-hardwares/utilization-read · gate none · sandbox · answers ChargerHardwareUtilizationRead@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await chargerHardware.utilizationRead({"vin":"3GCUKFED1SG157755"})
GET /charger-hardwares/utilization-read
curl 'https://apis.vin/charger-hardwares/utilization-read?vin=3GCUKFED1SG157755'

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:08.988Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareUtilizationRead@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "utilization": {
      "sessionsPerDay": 28,
      "kwhPerSession": 43,
      "windowDays": 30
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "utilization": {
      "sessionsPerDay": 28,
      "kwhPerSession": 43,
      "windowDays": 30
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

order

chargerHardware.order · POST /charger-hardwares/order · gate offer · sandbox · answers ChargerHardwareOrder@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) · /3GCUKFED1SG157755 (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 — ChargerHardware.ordered@1 · Order.placed@1 · ServiceOrder.settled@1.

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

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

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:08.952Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareOrder@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "order": {
      "id": "ORD-ec3c1ffc",
      "item": "charging station",
      "status": "placed",
      "amountCents": 240000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "order": {
      "id": "ORD-ec3c1ffc",
      "item": "charging station",
      "status": "placed",
      "amountCents": 240000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

provision

chargerHardware.provision · POST /charger-hardwares/provision · gate offer · sandbox · answers ChargerHardwareProvision@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) · /3GCUKFED1SG157755 (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 — ChargerHardware.provisioned@1.

the SDK — chargerHardware.provision
import { chargerHardware } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await chargerHardware.provision({"vin":"3GCUKFED1SG157755"})
POST /charger-hardwares/provision
curl -X POST https://apis.vin/charger-hardwares/provision \
  -H 'content-type: application/json' \
  -d '{"vin":"3GCUKFED1SG157755"}'

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:08.971Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareProvision@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "action": {
      "name": "provision",
      "status": "completed"
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "action": {
      "name": "provision",
      "status": "completed"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

chargerHardware.pay · POST /charger-hardwares/pay · gate offer · sandbox · answers ChargerHardwarePay@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) · /3GCUKFED1SG157755 (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 — ChargerHardware.charged@1 · ServiceOrder.settled@1.

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

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

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:08.953Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwarePay@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "payment": {
      "id": "PAY-7b1e6dda",
      "status": "settled",
      "amountCents": 240000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "payment": {
      "id": "PAY-7b1e6dda",
      "status": "settled",
      "amountCents": 240000,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

repair

chargerHardware.repair · POST /charger-hardwares/repair · gate offer · sandbox · answers ChargerHardwareRepair@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) · /3GCUKFED1SG157755 (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 — ChargerHardware.repaired@1.

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

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

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:08.975Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareRepair@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "repair": {
      "status": "no-repair-needed"
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "repair": {
      "status": "no-repair-needed"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

firmwareUpdate

chargerHardware.firmwareUpdate · POST /charger-hardwares/firmware-update · gate offer · sandbox · answers ChargerHardwareFirmwareUpdate@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) · /3GCUKFED1SG157755 (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 — ChargerHardware.firmwareUpdated@1.

the SDK — chargerHardware.firmwareUpdate
import { chargerHardware } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await chargerHardware.firmwareUpdate({"vin":"3GCUKFED1SG157755"})
POST /charger-hardwares/firmware-update
curl -X POST https://apis.vin/charger-hardwares/firmware-update \
  -H 'content-type: application/json' \
  -d '{"vin":"3GCUKFED1SG157755"}'

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:08.952Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareFirmwareUpdate@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "firmware": {
      "target": "charger-hardware",
      "version": "4.9.0",
      "status": "applied"
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "firmware": {
      "target": "charger-hardware",
      "version": "4.9.0",
      "status": "applied"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Lifecycle & state

reset

chargerHardware.reset · POST /charger-hardwares/reset · gate offer · sandbox · answers ChargerHardwareReset@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) · /3GCUKFED1SG157755 (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 — ChargerHardware.reset@1.

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

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

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:08.988Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareReset@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "action": {
      "name": "reset",
      "status": "completed"
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "action": {
      "name": "reset",
      "status": "completed"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

lease

chargerHardware.lease · POST /charger-hardwares/lease · gate offer · sandbox · answers ChargerHardwareLease@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) · /3GCUKFED1SG157755 (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 — ChargerHardware.leased@1.

the SDK — chargerHardware.lease
import { chargerHardware } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await chargerHardware.lease({"vin":"3GCUKFED1SG157755"})
POST /charger-hardwares/lease
curl -X POST https://apis.vin/charger-hardwares/lease \
  -H 'content-type: application/json' \
  -d '{"vin":"3GCUKFED1SG157755"}'

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:08.952Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareLease@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "lease": {
      "id": "LSE-9b2a2a02",
      "monthlyCents": 9500,
      "termMonths": 36,
      "currency": "USD",
      "status": "active"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "lease": {
      "id": "LSE-9b2a2a02",
      "monthlyCents": 9500,
      "termMonths": 36,
      "currency": "USD",
      "status": "active"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

maintain

chargerHardware.maintain · POST /charger-hardwares/maintain · gate offer · sandbox · answers ChargerHardwareMaintain@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) · /3GCUKFED1SG157755 (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 — ChargerHardware.maintained@1.

the SDK — chargerHardware.maintain
import { chargerHardware } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await chargerHardware.maintain({"vin":"3GCUKFED1SG157755"})
POST /charger-hardwares/maintain
curl -X POST https://apis.vin/charger-hardwares/maintain \
  -H 'content-type: application/json' \
  -d '{"vin":"3GCUKFED1SG157755"}'

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:08.952Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareMaintain@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "workOrder": {
      "id": "MNT-a687fdf5",
      "operation": "maintain",
      "status": "scheduled",
      "costCents": 12500,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "workOrder": {
      "id": "MNT-a687fdf5",
      "operation": "maintain",
      "status": "scheduled",
      "costCents": 12500,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

revenueShare

chargerHardware.revenueShare · POST /charger-hardwares/revenue-share · gate offer · sandbox · answers ChargerHardwareRevenueShare@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) · /3GCUKFED1SG157755 (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 — ChargerHardware.revenueShared@1.

the SDK — chargerHardware.revenueShare
import { chargerHardware } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await chargerHardware.revenueShare({"vin":"3GCUKFED1SG157755"})
POST /charger-hardwares/revenue-share
curl -X POST https://apis.vin/charger-hardwares/revenue-share \
  -H 'content-type: application/json' \
  -d '{"vin":"3GCUKFED1SG157755"}'

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:08.988Z · HTTP 200
{
  "type": "OK",
  "answers": "ChargerHardwareRevenueShare@1",
  "value": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "revenueShare": {
      "grossCents": 1517040,
      "hostShareCents": 455112,
      "networkShareCents": 1061928,
      "windowDays": 30,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "3GCUKFED1SG157755",
    "noun": "chargerHardware",
    "asOf": "2026-08-10",
    "readiness": "ready",
    "chargerId": "CHG-738ff67e",
    "revenueShare": {
      "grossCents": 1517040,
      "hostShareCents": 455112,
      "networkShareCents": 1061928,
      "windowDays": 30,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "charge-connect-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.

ServiceOrder

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

charger

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

charging

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

On this page

Identity
Events
Discover & read
spec
faultRead
statusRead
uptimeRead
utilizationRead
Apply & book
order
provision
Pay & settle
pay
Fulfill & operate
repair
firmwareUpdate
Lifecycle & state
reset
More actions
lease
maintain
revenueShare
Data model
ServiceOrder