docs.vin

etch

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

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

Identity

Nounetch
PillarData (facets: 3 data · 3 services · 3 commerce)
Capabilities9 — 0 live · 9 sandbox · 0 declared
EntitiesReconditioning
Doorsaggregator.vin
SDKVin.etch.* from apis.vin
Address/catalog/etch#{action} — the anchor IS the wire name minus etch.

Events

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

Discover & read

status

etch.status · GET /etches/status · gate none · sandbox · answers EtchStatus@1

FieldTypeRequiredNotes
vinstringno—

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

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

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.157Z · HTTP 200
{
  "type": "OK",
  "answers": "EtchStatus@1",
  "value": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "etch": {
      "jobId": "ETJ-421c766d",
      "stage": "inbound",
      "status": "not-started",
      "applied": false,
      "registered": false
    }
  },
  "evidence": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "etch": {
      "jobId": "ETJ-421c766d",
      "stage": "inbound",
      "status": "not-started",
      "applied": false,
      "registered": false
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "etch-bay-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

verify

etch.verify · GET /etches/verify · gate none · sandbox · answers EtchVerify@1

FieldTypeRequiredNotes
vinstringno—

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

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

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.163Z · HTTP 200
{
  "type": "OK",
  "answers": "EtchVerify@1",
  "value": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "verification": {
      "status": "no-etch-on-file"
    }
  },
  "evidence": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "verification": {
      "status": "no-etch-on-file"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "etch-bay-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

registryLookup

etch.registryLookup · GET /etches/registry-lookup · gate none · sandbox · answers EtchRegistryLookup@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await etch.registryLookup({"vin":"1C4RJHBG7PC502106"})
GET /etches/registry-lookup
curl 'https://apis.vin/etches/registry-lookup?vin=1C4RJHBG7PC502106'

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.155Z · HTTP 200
{
  "type": "OK",
  "answers": "EtchRegistryLookup@1",
  "value": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "registry": {
      "status": "no-registration-on-file"
    }
  },
  "evidence": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "registry": {
      "status": "no-registration-on-file"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "etch-bay-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Quote & price

quote

etch.quote · POST /etches/quote · gate offer · sandbox · answers EtchQuote@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) · /1C4RJHBG7PC502106 (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 — Etch.quoteRequested@1 · Etch.quoted@1.

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

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

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.154Z · HTTP 200
{
  "type": "OK",
  "answers": "EtchQuote@1",
  "value": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "quote": {
      "status": "no-etch-menu-posted"
    }
  },
  "evidence": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "quote": {
      "status": "no-etch-menu-posted"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "etch-bay-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

apply

etch.apply · POST /etches/apply · gate offer · sandbox · answers EtchApply@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) · /1C4RJHBG7PC502106 (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 — Etch.applied@1 · Etch.applyFailed@1 · Etch.applyRequested@1.

the SDK — etch.apply
import { etch } from 'apis.vin'

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

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.141Z · HTTP 200
{
  "type": "OK",
  "answers": "EtchApply@1",
  "value": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "work": {
      "id": "ETJ-421c766d",
      "operation": "apply",
      "status": "scheduled",
      "method": "chemical-stencil-etch",
      "markId": "ETC-7883ed63"
    }
  },
  "evidence": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "work": {
      "id": "ETJ-421c766d",
      "operation": "apply",
      "status": "scheduled",
      "method": "chemical-stencil-etch",
      "markId": "ETC-7883ed63"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "etch-bay-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

order

etch.order · POST /etches/order · gate offer · sandbox · answers EtchOrder@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) · /1C4RJHBG7PC502106 (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 — Etch.completed@1 · Etch.dispatched@1 · Etch.ordered@1 · ServiceOrder.settled@1.

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

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

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.143Z · HTTP 200
{
  "type": "OK",
  "answers": "EtchOrder@1",
  "value": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "order": {
      "status": "no-etch-menu-posted"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "order": {
      "status": "no-etch-menu-posted"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "etch-bay-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

register

etch.register · POST /etches/register · gate offer · sandbox · answers EtchRegister@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) · /1C4RJHBG7PC502106 (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 — Etch.registerRequested@1 · Etch.registered@1.

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

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

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.155Z · HTTP 200
{
  "type": "OK",
  "answers": "EtchRegister@1",
  "value": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "registration": {
      "status": "no-etch-on-file"
    }
  },
  "evidence": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "registration": {
      "status": "no-etch-on-file"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "etch-bay-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

etch.pay · POST /etches/pay · gate offer · sandbox · answers EtchPay@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) · /1C4RJHBG7PC502106 (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 — Etch.paid@1 · Etch.payFailed@1 · Etch.payRequested@1.

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

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

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.150Z · HTTP 200
{
  "type": "OK",
  "answers": "EtchPay@1",
  "value": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "payment": {
      "status": "no-etch-menu-posted"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "payment": {
      "status": "no-etch-menu-posted"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "etch-bay-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

perform

etch.perform · POST /etches/perform · gate offer · sandbox · answers EtchPerform@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) · /1C4RJHBG7PC502106 (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 — Etch.performFailed@1 · Etch.performRequested@1 · Etch.performed@1.

the SDK — etch.perform
import { etch } from 'apis.vin'

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

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.150Z · HTTP 200
{
  "type": "OK",
  "answers": "EtchPerform@1",
  "value": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "step": {
      "id": "ETJ-421c766d",
      "operation": "perform",
      "status": "performed",
      "method": "chemical-stencil-etch",
      "markId": "ETC-7883ed63"
    }
  },
  "evidence": {
    "vin": "1C4RJHBG7PC502106",
    "noun": "etch",
    "asOf": "2026-08-10",
    "glass": "intact",
    "id": "RCN-3e1aae6c",
    "inspectionId": "INSP-df66df2f",
    "items": [],
    "status": "not-started",
    "step": {
      "id": "ETJ-421c766d",
      "operation": "perform",
      "status": "performed",
      "method": "chemical-stencil-etch",
      "markId": "ETC-7883ed63"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "etch-bay-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.

Reconditioning

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

estimate

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

factoryWarranty

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

On this page

Identity
Events
Discover & read
status
verify
registryLookup
Quote & price
quote
Apply & book
apply
order
register
Pay & settle
pay
Fulfill & operate
perform
Data model
Reconditioning