docs.vin

ppfWrap

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

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

Identity

NounppfWrap
PillarServices (facets: 3 data · 5 services · 3 commerce)
Capabilities11 — 0 live · 11 sandbox · 0 declared
EntitiesReconditioning
Doorsaggregator.vin
SDKVin.ppfWrap.* from apis.vin
Address/catalog/ppfWrap#{action} — the anchor IS the wire name minus ppfWrap.

Events

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

Discover & read

spec

ppfWrap.spec · GET /ppf-wraps/spec · gate none · sandbox · answers PpfWrapSpec@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ppfWrap.spec({"vin":"1GKS2VKL5TR118525"})
GET /ppf-wraps/spec
curl 'https://apis.vin/ppf-wraps/spec?vin=1GKS2VKL5TR118525'

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:15.682Z · HTTP 200
{
  "type": "OK",
  "answers": "PpfWrapSpec@1",
  "value": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "film": {
      "id": "PPF-1de27ed0",
      "class": "matte"
    },
    "spec": {
      "thicknessMils": 8,
      "layers": [
        "clear-topcoat",
        "polyurethane-film",
        "acrylic-adhesive"
      ],
      "warrantyYears": 10,
      "selfHealing": true
    }
  },
  "evidence": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "film": {
      "id": "PPF-1de27ed0",
      "class": "matte"
    },
    "spec": {
      "thicknessMils": 8,
      "layers": [
        "clear-topcoat",
        "polyurethane-film",
        "acrylic-adhesive"
      ],
      "warrantyYears": 10,
      "selfHealing": true
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "recon-film-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

coverageLookup

ppfWrap.coverageLookup · GET /ppf-wraps/coverage-lookup · gate none · sandbox · answers PpfWrapCoverageLookup@1

FieldTypeRequiredNotes
vinstringno—

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

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

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:15.675Z · HTTP 200
{
  "type": "OK",
  "answers": "PpfWrapCoverageLookup@1",
  "value": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "coverage": {
      "tier": "full-body",
      "panels": 14,
      "sqft": 96,
      "amountCents": 599000,
      "basis": "posted-coverage-sheet"
    },
    "tiers": [
      {
        "tier": "full-front",
        "panels": 5,
        "sqft": 28,
        "amountCents": 189000
      },
      {
        "tier": "track-pack",
        "panels": 8,
        "sqft": 44,
        "amountCents": 249000
      },
      {
        "tier": "full-body",
        "panels": 14,
        "sqft": 96,
        "amountCents": 599000
      }
    ]
  },
  "evidence": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "coverage": {
      "tier": "full-body",
      "panels": 14,
      "sqft": 96,
      "amountCents": 599000,
      "basis": "posted-coverage-sheet"
    },
    "tiers": [
      {
        "tier": "full-front",
        "panels": 5,
        "sqft": 28,
        "amountCents": 189000
      },
      {
        "tier": "track-pack",
        "panels": 8,
        "sqft": 44,
        "amountCents": 249000
      },
      {
        "tier": "full-body",
        "panels": 14,
        "sqft": 96,
        "amountCents": 599000
      }
    ]
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "recon-film-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Quote & price

quote

ppfWrap.quote · POST /ppf-wraps/quote · gate offer · sandbox · answers PpfWrapQuote@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) · /1GKS2VKL5TR118525 (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 — PpfWrap.quoteRequested@1 · PpfWrap.quoted@1.

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

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

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:15.682Z · HTTP 200
{
  "type": "OK",
  "answers": "PpfWrapQuote@1",
  "value": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "quote": {
      "status": "blocked-paint-work-outstanding",
      "amountCents": 0,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "quote": {
      "status": "blocked-paint-work-outstanding",
      "amountCents": 0,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "recon-film-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

apply

ppfWrap.apply · POST /ppf-wraps/apply · gate offer · sandbox · answers PpfWrapApply@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) · /1GKS2VKL5TR118525 (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 — PpfWrap.applied@1 · PpfWrap.applyFailed@1 · PpfWrap.applyRequested@1.

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

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

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:15.670Z · HTTP 200
{
  "type": "OK",
  "answers": "PpfWrapApply@1",
  "value": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "work": {
      "operation": "apply",
      "status": "refused",
      "reason": "paint-work-outstanding"
    }
  },
  "evidence": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "work": {
      "operation": "apply",
      "status": "refused",
      "reason": "paint-work-outstanding"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "recon-film-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

order

ppfWrap.order · POST /ppf-wraps/order · gate offer · sandbox · answers PpfWrapOrder@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) · /1GKS2VKL5TR118525 (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 — PpfWrap.completed@1 · PpfWrap.dispatched@1 · PpfWrap.ordered@1 · ServiceOrder.settled@1.

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

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

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:15.682Z · HTTP 200
{
  "type": "OK",
  "answers": "PpfWrapOrder@1",
  "value": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "order": {
      "status": "blocked-paint-work-outstanding",
      "amountCents": 0,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "order": {
      "status": "blocked-paint-work-outstanding",
      "amountCents": 0,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "recon-film-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

schedule

ppfWrap.schedule · POST /ppf-wraps/schedule · gate offer · sandbox · answers PpfWrapSchedule@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) · /1GKS2VKL5TR118525 (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 — PpfWrap.scheduleRequested@1 · PpfWrap.scheduled@1.

the SDK — ppfWrap.schedule
import { ppfWrap } from 'apis.vin'

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

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:15.682Z · HTTP 200
{
  "type": "OK",
  "answers": "PpfWrapSchedule@1",
  "value": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "appointment": {
      "status": "refused",
      "reason": "paint-booth-first"
    }
  },
  "evidence": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "appointment": {
      "status": "refused",
      "reason": "paint-booth-first"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "recon-film-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

ppfWrap.pay · POST /ppf-wraps/pay · gate offer · sandbox · answers PpfWrapPay@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) · /1GKS2VKL5TR118525 (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 — PpfWrap.paid@1 · PpfWrap.payFailed@1 · PpfWrap.payRequested@1.

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

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

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:15.682Z · HTTP 200
{
  "type": "OK",
  "answers": "PpfWrapPay@1",
  "value": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "payment": {
      "status": "nothing-billed",
      "amountCents": 0,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "payment": {
      "status": "nothing-billed",
      "amountCents": 0,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "recon-film-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

remove

ppfWrap.remove · POST /ppf-wraps/remove · gate offer · sandbox · answers PpfWrapRemove@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) · /1GKS2VKL5TR118525 (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 — PpfWrap.removeRequested@1 · PpfWrap.removed@1.

the SDK — ppfWrap.remove
import { ppfWrap } from 'apis.vin'

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

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:15.682Z · HTTP 200
{
  "type": "OK",
  "answers": "PpfWrapRemove@1",
  "value": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "work": {
      "operation": "remove",
      "status": "no-film-on-file"
    }
  },
  "evidence": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "work": {
      "operation": "remove",
      "status": "no-film-on-file"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "recon-film-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

complete

ppfWrap.complete · POST /ppf-wraps/complete · gate offer · sandbox · answers PpfWrapComplete@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) · /1GKS2VKL5TR118525 (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 — PpfWrap.completeRequested@1 · PpfWrap.completed@1.

the SDK — ppfWrap.complete
import { ppfWrap } from 'apis.vin'

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

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:15.670Z · HTTP 200
{
  "type": "OK",
  "answers": "PpfWrapComplete@1",
  "value": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "completion": {
      "status": "refused",
      "reason": "paint-work-outstanding"
    }
  },
  "evidence": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "completion": {
      "status": "refused",
      "reason": "paint-work-outstanding"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "recon-film-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

materialId

ppfWrap.materialId · GET /ppf-wraps/material-id · gate none · sandbox · answers PpfWrapMaterialId@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await ppfWrap.materialId({"vin":"1GKS2VKL5TR118525"})
GET /ppf-wraps/material-id
curl 'https://apis.vin/ppf-wraps/material-id?vin=1GKS2VKL5TR118525'

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:15.682Z · HTTP 200
{
  "type": "OK",
  "answers": "PpfWrapMaterialId@1",
  "value": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "material": {
      "id": "PPF-1de27ed0",
      "class": "matte",
      "candidates": [
        "gloss",
        "matte",
        "ceramic-topcoat"
      ]
    }
  },
  "evidence": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "material": {
      "id": "PPF-1de27ed0",
      "class": "matte",
      "candidates": [
        "gloss",
        "matte",
        "ceramic-topcoat"
      ]
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "recon-film-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

template

ppfWrap.template · POST /ppf-wraps/template · gate offer · sandbox · answers PpfWrapTemplate@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) · /1GKS2VKL5TR118525 (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 — PpfWrap.templateRequested@1 · PpfWrap.templated@1.

the SDK — ppfWrap.template
import { ppfWrap } from 'apis.vin'

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

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:15.685Z · HTTP 200
{
  "type": "OK",
  "answers": "PpfWrapTemplate@1",
  "value": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "template": {
      "id": "PPT-083a661b",
      "tier": "full-body",
      "panels": 14,
      "filmClass": "matte",
      "status": "cut"
    }
  },
  "evidence": {
    "vin": "1GKS2VKL5TR118525",
    "noun": "ppfWrap",
    "asOf": "2026-08-10",
    "paintWork": "spot-repair",
    "template": {
      "id": "PPT-083a661b",
      "tier": "full-body",
      "panels": 14,
      "filmClass": "matte",
      "status": "cut"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "recon-film-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.

port

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

preApproval

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

On this page

Identity
Events
Discover & read
spec
coverageLookup
Quote & price
quote
Apply & book
apply
order
schedule
Pay & settle
pay
Fulfill & operate
remove
complete
More actions
materialId
template
Data model
Reconditioning