docs.vin

tco

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

tco is one of the estate's 317 automotive nouns — a job a car needs done. It carries 8 capabilities: 5 live, 3 sandbox, 0 declared · doors values.vin.

Identity

Nountco
PillarData (facets: 6 data · 1 services · 1 commerce)
Capabilities8 — 5 live · 3 sandbox · 0 declared
EntitiesAppraisal
Doorsvalues.vin
SDKVin.tco.* from apis.vin
Address/catalog/tco#{action} — the anchor IS the wire name minus tco.

Events

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

Discover & read

get

tco.get · GET /tcos/get · gate none · live · answers Tco@1

FieldTypeRequiredNotes
vinstringyes—
zipstringno—

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

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

compare

tco.compare · GET /tcos/compare · gate key · sandbox · answers TcoCompare@1

FieldTypeRequiredNotes
vinstringno—

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

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

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.919Z · HTTP 200
{
  "type": "OK",
  "answers": "TcoCompare@1",
  "value": {
    "vin": "1C4AJWAG3HL588759",
    "noun": "tco",
    "asOf": "2026-08-10",
    "appraisal": {
      "status": "no-appraisal-on-file"
    },
    "tco": {
      "items": [
        {
          "kind": "acquisition",
          "amountCents": 1850000,
          "basis": "acquisition-figure"
        },
        {
          "kind": "fuel-to-date",
          "amountCents": 829224,
          "basis": "posted-fuel-menu-over-the-one-odometer"
        },
        {
          "kind": "maintenance-to-date",
          "amountCents": 80100,
          "basis": "posted-interval-at-the-posted-service-line"
        }
      ],
      "totalCents": 2759324,
      "currency": "USD",
      "insurance": {
        "status": "no-premium-book-posted"
      }
    },
    "comparison": {
      "status": "no-class-book-posted"
    }
  },
  "evidence": {
    "vin": "1C4AJWAG3HL588759",
    "noun": "tco",
    "asOf": "2026-08-10",
    "appraisal": {
      "status": "no-appraisal-on-file"
    },
    "tco": {
      "items": [
        {
          "kind": "acquisition",
          "amountCents": 1850000,
          "basis": "acquisition-figure"
        },
        {
          "kind": "fuel-to-date",
          "amountCents": 829224,
          "basis": "posted-fuel-menu-over-the-one-odometer"
        },
        {
          "kind": "maintenance-to-date",
          "amountCents": 80100,
          "basis": "posted-interval-at-the-posted-service-line"
        }
      ],
      "totalCents": 2759324,
      "currency": "USD",
      "insurance": {
        "status": "no-premium-book-posted"
      }
    },
    "comparison": {
      "status": "no-class-book-posted"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "value-book-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Quote & price

calc

tco.calc · GET /tcos/calc · gate key · live · answers TcoCalc@1

FieldTypeRequiredNotes
vinstringno—

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

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

recompute

tco.recompute · POST /tcos/recompute · gate offer · sandbox · answers TcoRecompute@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 — values.vin serves this noun on its two routes: / (the landing) · /1C4AJWAG3HL588759 (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 — Tco.recomputed@1.

the SDK — tco.recompute
import { tco } from 'apis.vin'

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

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.927Z · HTTP 200
{
  "type": "OK",
  "answers": "TcoRecompute@1",
  "value": {
    "vin": "1C4AJWAG3HL588759",
    "noun": "tco",
    "asOf": "2026-08-10",
    "appraisal": {
      "status": "no-appraisal-on-file"
    },
    "recomputation": {
      "status": "recomputed",
      "totalCents": 2759324,
      "currency": "USD",
      "unchanged": true,
      "items": [
        {
          "kind": "acquisition",
          "amountCents": 1850000,
          "basis": "acquisition-figure"
        },
        {
          "kind": "fuel-to-date",
          "amountCents": 829224,
          "basis": "posted-fuel-menu-over-the-one-odometer"
        },
        {
          "kind": "maintenance-to-date",
          "amountCents": 80100,
          "basis": "posted-interval-at-the-posted-service-line"
        }
      ],
      "basis": "itemized-posted-components"
    }
  },
  "evidence": {
    "vin": "1C4AJWAG3HL588759",
    "noun": "tco",
    "asOf": "2026-08-10",
    "appraisal": {
      "status": "no-appraisal-on-file"
    },
    "recomputation": {
      "status": "recomputed",
      "totalCents": 2759324,
      "currency": "USD",
      "unchanged": true,
      "items": [
        {
          "kind": "acquisition",
          "amountCents": 1850000,
          "basis": "acquisition-figure"
        },
        {
          "kind": "fuel-to-date",
          "amountCents": 829224,
          "basis": "posted-fuel-menu-over-the-one-odometer"
        },
        {
          "kind": "maintenance-to-date",
          "amountCents": 80100,
          "basis": "posted-interval-at-the-posted-service-line"
        }
      ],
      "basis": "itemized-posted-components"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "value-book-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

fuelCostEstimate

tco.fuelCostEstimate · GET /tcos/fuel-cost-estimate · gate none · live · answers TcoFuelCostEstimate@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await tco.fuelCostEstimate({"vin":"1C4AJWAG3HL588759"})
GET /tcos/fuel-cost-estimate
curl 'https://apis.vin/tcos/fuel-cost-estimate?vin=1C4AJWAG3HL588759'

insuranceCostEstimate

tco.insuranceCostEstimate · GET /tcos/insurance-cost-estimate · gate none · live · answers TcoInsuranceCostEstimate@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await tco.insuranceCostEstimate({"vin":"1C4AJWAG3HL588759"})
GET /tcos/insurance-cost-estimate
curl 'https://apis.vin/tcos/insurance-cost-estimate?vin=1C4AJWAG3HL588759'

maintenanceCostEstimate

tco.maintenanceCostEstimate · GET /tcos/maintenance-cost-estimate · gate none · live · answers TcoMaintenanceCostEstimate@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await tco.maintenanceCostEstimate({"vin":"1C4AJWAG3HL588759"})
GET /tcos/maintenance-cost-estimate
curl 'https://apis.vin/tcos/maintenance-cost-estimate?vin=1C4AJWAG3HL588759'

Apply & book

subscribe

tco.subscribe · POST /tcos/subscribe · gate offer · sandbox · answers TcoSubscribe@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 — values.vin serves this noun on its two routes: / (the landing) · /1C4AJWAG3HL588759 (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 — Tco.subscribed@1.

the SDK — tco.subscribe
import { tco } from 'apis.vin'

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

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.930Z · HTTP 200
{
  "type": "OK",
  "answers": "TcoSubscribe@1",
  "value": {
    "vin": "1C4AJWAG3HL588759",
    "noun": "tco",
    "asOf": "2026-08-10",
    "appraisal": {
      "status": "no-appraisal-on-file"
    },
    "subscription": {
      "status": "subscribed",
      "id": "TSUB-d640fd67"
    }
  },
  "evidence": {
    "vin": "1C4AJWAG3HL588759",
    "noun": "tco",
    "asOf": "2026-08-10",
    "appraisal": {
      "status": "no-appraisal-on-file"
    },
    "subscription": {
      "status": "subscribed",
      "id": "TSUB-d640fd67"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "value-book-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.

Appraisal

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.

Tco · 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.

taxes

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

theft

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

On this page

Identity
Events
Discover & read
get
compare
Quote & price
calc
recompute
fuelCostEstimate
insuranceCostEstimate
maintenanceCostEstimate
Apply & book
subscribe
Data model
Appraisal
Modeled