docs.vin

factoryWarranty

The factoryWarranty noun — identity, lifecycle, events, and every capability as an anchored section: 9 capabilities, 2 live, 7 sandbox, 0 declared.

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

Identity

NounfactoryWarranty
PillarData (facets: 5 data · 3 services · 1 commerce)
Capabilities9 — 2 live · 7 sandbox · 0 declared
EntitiesProtectionProduct
Doorsaggregator.vin
SDKVin.factoryWarranty.* from apis.vin
Address/catalog/factoryWarranty#{action} — the anchor IS the wire name minus factoryWarranty.

Events

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

Discover & read

coverageLookup

factoryWarranty.coverageLookup · GET /factory-warranties/coverage-lookup · gate none · live · answers FactoryWarrantyCoverageLookup@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await factoryWarranty.coverageLookup({"vin":"JF2SKAXC8LH527462"})
GET /factory-warranties/coverage-lookup
curl 'https://apis.vin/factory-warranties/coverage-lookup?vin=JF2SKAXC8LH527462'

startDateLookup

factoryWarranty.startDateLookup · GET /factory-warranties/start-date-lookup · gate none · sandbox · answers FactoryWarrantyStartDateLookup@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await factoryWarranty.startDateLookup({"vin":"JF2SKAXC8LH527462"})
GET /factory-warranties/start-date-lookup
curl 'https://apis.vin/factory-warranties/start-date-lookup?vin=JF2SKAXC8LH527462'

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:11.425Z · HTTP 200
{
  "type": "OK",
  "answers": "FactoryWarrantyStartDateLookup@1",
  "value": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "startDate": {
      "status": "no-in-service-date-on-file",
      "standing": "active"
    }
  },
  "evidence": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "startDate": {
      "status": "no-in-service-date-on-file",
      "standing": "active"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "window-sticker-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

termsLookup

factoryWarranty.termsLookup · GET /factory-warranties/terms-lookup · gate none · live · answers FactoryWarrantyTermsLookup@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await factoryWarranty.termsLookup({"vin":"JF2SKAXC8LH527462"})
GET /factory-warranties/terms-lookup
curl 'https://apis.vin/factory-warranties/terms-lookup?vin=JF2SKAXC8LH527462'

remainingCheck

factoryWarranty.remainingCheck · GET /factory-warranties/remaining-check · gate none · sandbox · answers FactoryWarrantyRemainingCheck@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await factoryWarranty.remainingCheck({"vin":"JF2SKAXC8LH527462"})
GET /factory-warranties/remaining-check
curl 'https://apis.vin/factory-warranties/remaining-check?vin=JF2SKAXC8LH527462'

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:11.423Z · HTTP 200
{
  "type": "OK",
  "answers": "FactoryWarrantyRemainingCheck@1",
  "value": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "remaining": {
      "standing": "active",
      "odometer": 38767,
      "powertrainMilesLeft": 21233,
      "bumperMilesLeft": 0
    }
  },
  "evidence": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "remaining": {
      "standing": "active",
      "odometer": 38767,
      "powertrainMilesLeft": 21233,
      "bumperMilesLeft": 0
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "window-sticker-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

upgrade

factoryWarranty.upgrade · POST /factory-warranties/upgrade · gate offer · sandbox · answers FactoryWarrantyUpgrade@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) · /JF2SKAXC8LH527462 (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 — FactoryWarranty.upgraded@1.

the SDK — factoryWarranty.upgrade
import { factoryWarranty } from 'apis.vin'

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

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:11.431Z · HTTP 200
{
  "type": "OK",
  "answers": "FactoryWarrantyUpgrade@1",
  "value": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "upgrade": {
      "kind": "factory-coverage-extension",
      "id": "PP-3d8f268f",
      "productType": "VSC",
      "planCode": "VSC-PLAT",
      "terms": [
        {
          "termMonths": 36,
          "termMiles": 36000,
          "retailCents": 219500
        },
        {
          "termMonths": 48,
          "termMiles": 50000,
          "retailCents": 249500
        },
        {
          "termMonths": 60,
          "termMiles": 75000,
          "retailCents": 279500
        }
      ],
      "tier": "super-prime"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "upgrade": {
      "kind": "factory-coverage-extension",
      "id": "PP-3d8f268f",
      "productType": "VSC",
      "planCode": "VSC-PLAT",
      "terms": [
        {
          "termMonths": 36,
          "termMiles": 36000,
          "retailCents": 219500
        },
        {
          "termMonths": 48,
          "termMiles": 50000,
          "retailCents": 249500
        },
        {
          "termMonths": 60,
          "termMiles": 75000,
          "retailCents": 279500
        }
      ],
      "tier": "super-prime"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "window-sticker-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

register

factoryWarranty.register · POST /factory-warranties/register · gate offer · sandbox · answers FactoryWarrantyRegister@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) · /JF2SKAXC8LH527462 (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 — FactoryWarranty.registered@1.

the SDK — factoryWarranty.register
import { factoryWarranty } from 'apis.vin'

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

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:11.422Z · HTTP 200
{
  "type": "OK",
  "answers": "FactoryWarrantyRegister@1",
  "value": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "registration": {
      "id": "FW-6165ee8b",
      "status": "registered",
      "holderId": "ID-11f17424"
    }
  },
  "evidence": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "registration": {
      "id": "FW-6165ee8b",
      "status": "registered",
      "holderId": "ID-11f17424"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "window-sticker-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Authorize & resolve

mileageAttest

factoryWarranty.mileageAttest · POST /factory-warranties/mileage-attest · gate key · sandbox · answers FactoryWarrantyMileageAttest@1

No input — this capability takes no request body.

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

the SDK — factoryWarranty.mileageAttest
import { factoryWarranty } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await factoryWarranty.mileageAttest()
POST /factory-warranties/mileage-attest
curl -X POST https://apis.vin/factory-warranties/mileage-attest \
  -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.

receipt · executed 2026-08-16T14:50:09.816Z · HTTP 200
{
  "type": "OK",
  "answers": "FactoryWarrantyMileageAttest@1",
  "value": {
    "vin": "1HGCM82633A004352",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-f812092e",
    "dealId": "DL-4ade9a56",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "attestation": {
      "id": "MA-0299f875",
      "odometer": 32490,
      "basis": "world-odometer",
      "status": "attested"
    }
  },
  "evidence": {
    "vin": "1HGCM82633A004352",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-f812092e",
    "dealId": "DL-4ade9a56",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "attestation": {
      "id": "MA-0299f875",
      "odometer": 32490,
      "basis": "world-odometer",
      "status": "attested"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "window-sticker-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Lifecycle & state

activate

factoryWarranty.activate · POST /factory-warranties/activate · gate offer · sandbox · answers FactoryWarrantyActivate@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) · /JF2SKAXC8LH527462 (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 — FactoryWarranty.activated@1.

the SDK — factoryWarranty.activate
import { factoryWarranty } from 'apis.vin'

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

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:11.421Z · HTTP 200
{
  "type": "OK",
  "answers": "FactoryWarrantyActivate@1",
  "value": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "activation": {
      "status": "already-in-force",
      "standing": "active"
    }
  },
  "evidence": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "activation": {
      "status": "already-in-force",
      "standing": "active"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "window-sticker-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

transfer

factoryWarranty.transfer · POST /factory-warranties/transfer · gate offer · sandbox · answers FactoryWarrantyTransfer@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) · /JF2SKAXC8LH527462 (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 — FactoryWarranty.transferred@1.

the SDK — factoryWarranty.transfer
import { factoryWarranty } from 'apis.vin'

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

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:11.430Z · HTTP 200
{
  "type": "OK",
  "answers": "FactoryWarrantyTransfer@1",
  "value": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "transfer": {
      "status": "transferred",
      "toHolderId": "ID-11f17424",
      "transferable": true,
      "standing": "active"
    }
  },
  "evidence": {
    "vin": "JF2SKAXC8LH527462",
    "noun": "factoryWarranty",
    "asOf": "2026-08-10",
    "id": "FW-6165ee8b",
    "dealId": "DL-9465f159",
    "holderId": "ID-11f17424",
    "product": "FACTORY_WARRANTY",
    "term": "36000-miles",
    "premium": 0,
    "transfer": {
      "status": "transferred",
      "toHolderId": "ID-11f17424",
      "transferable": true,
      "standing": "active"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "window-sticker-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.

ProtectionProduct

Modeled

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

FactoryWarranty · Class model

FactoryWarranty · State machine

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

etch

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

features

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

On this page

Identity
Events
Discover & read
coverageLookup
startDateLookup
termsLookup
remainingCheck
upgrade
Apply & book
register
Authorize & resolve
mileageAttest
Lifecycle & state
activate
transfer
Data model
ProtectionProduct
Modeled