dealerOfRecord

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

Identity

Events

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

• DealerOfRecord.registered@1 — emitted by register

Apply & book

register

dealerOfRecord.register · POST /dealer-of-records/register · gate key · sandbox · answers DealerOfRecordRegister@1

No input — this capability takes no request body.

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

import { dealerOfRecord } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await dealerOfRecord.register()

curl -X POST https://apis.vin/dealer-of-records/register \
  -H 'content-type: application/json' \
  -d '{}'

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.

{
  "type": "OK",
  "answers": "DealerOfRecordRegister@1",
  "value": {
    "noun": "dealerOfRecord",
    "asOf": "2026-08-10",
    "dealerId": "DLR-b9066ade",
    "rooftopIds": [
      "DLR-b9066ade"
    ],
    "dealerLicense": "DL-7bcdd2ef",
    "auctionStanding": "active",
    "registration": {
      "dealerOfRecordId": "DLR-b9066ade",
      "name": "The Estate Store",
      "licenseId": "DL-7bcdd2ef",
      "registeredOn": "2026-08-10",
      "status": "registered"
    }
  },
  "evidence": {
    "noun": "dealerOfRecord",
    "asOf": "2026-08-10",
    "dealerId": "DLR-b9066ade",
    "rooftopIds": [
      "DLR-b9066ade"
    ],
    "dealerLicense": "DL-7bcdd2ef",
    "auctionStanding": "active",
    "registration": {
      "dealerOfRecordId": "DLR-b9066ade",
      "name": "The Estate Store",
      "licenseId": "DL-7bcdd2ef",
      "registeredOn": "2026-08-10",
      "status": "registered"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "back-office-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.

Dealer

Modeled

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

DealerOfRecord · Class model

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