docs.vin

pdi

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

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

Identity

Nounpdi
PillarServices (facets: 5 data · 8 services · 3 commerce)
Capabilities16 — 0 live · 16 sandbox · 0 declared
EntitiesInspection
Doorsaggregator.vin
SDKVin.pdi.* from apis.vin
Address/catalog/pdi#{action} — the anchor IS the wire name minus pdi.

Events

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

Discover & read

history

pdi.history · GET /pdis/history · gate none · sandbox · answers PdiHistory@1

FieldTypeRequiredNotes
vinstringno—

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

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

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.174Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiHistory@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "events": [
      {
        "date": "2026-08-07",
        "kind": "unit-received",
        "id": "PDI-d55842b7"
      },
      {
        "date": "2026-08-08",
        "kind": "pdi-completed",
        "id": "PDI-d55842b7"
      }
    ]
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "events": [
      {
        "date": "2026-08-07",
        "kind": "unit-received",
        "id": "PDI-d55842b7"
      },
      {
        "date": "2026-08-08",
        "kind": "pdi-completed",
        "id": "PDI-d55842b7"
      }
    ]
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

status

pdi.status · GET /pdis/status · gate none · sandbox · answers PdiStatus@1

FieldTypeRequiredNotes
vinstringno—

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

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

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.261Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiStatus@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "pdi": {
      "id": "PDI-d55842b7",
      "standing": "completed",
      "dealerId": "DLR-b9066ade"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "pdi": {
      "id": "PDI-d55842b7",
      "standing": "completed",
      "dealerId": "DLR-b9066ade"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

result

pdi.result · GET /pdis/result · gate key · sandbox · answers PdiResult@1

FieldTypeRequiredNotes
vinstringno—

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

the SDK — pdi.result
import { pdi } from 'apis.vin'

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

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.176Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiResult@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "result": {
      "id": "PDI-d55842b7",
      "outcome": "pass",
      "items": 8
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "result": {
      "id": "PDI-d55842b7",
      "outcome": "pass",
      "items": 8
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

specLookup

pdi.specLookup · GET /pdis/spec-lookup · gate none · sandbox · answers PdiSpecLookup@1

FieldTypeRequiredNotes
vinstringno—

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

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

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.261Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiSpecLookup@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "spec": {
      "configId": "CFG-da1f6b08",
      "modelYear": 2025,
      "body": "truck",
      "drivetrain": "fwd",
      "msrpCents": 4854900,
      "destinationCents": 176000,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "spec": {
      "configId": "CFG-da1f6b08",
      "modelYear": 2025,
      "body": "truck",
      "drivetrain": "fwd",
      "msrpCents": 4854900,
      "destinationCents": 176000,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

checklist

pdi.checklist · GET /pdis/checklist · gate none · sandbox · answers PdiChecklist@1

FieldTypeRequiredNotes
vinstringno—

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

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

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.174Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiChecklist@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "checklist": {
      "id": "PDI-d55842b7",
      "items": [
        {
          "item": "transit-protection-removal",
          "status": "completed"
        },
        {
          "item": "fluid-levels",
          "status": "completed"
        },
        {
          "item": "battery-charge",
          "status": "completed"
        },
        {
          "item": "software-current",
          "status": "completed"
        },
        {
          "item": "lights-and-safety",
          "status": "completed"
        },
        {
          "item": "road-test",
          "status": "completed"
        },
        {
          "item": "fuel-fill",
          "status": "completed"
        },
        {
          "item": "final-wash",
          "status": "completed"
        }
      ]
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "checklist": {
      "id": "PDI-d55842b7",
      "items": [
        {
          "item": "transit-protection-removal",
          "status": "completed"
        },
        {
          "item": "fluid-levels",
          "status": "completed"
        },
        {
          "item": "battery-charge",
          "status": "completed"
        },
        {
          "item": "software-current",
          "status": "completed"
        },
        {
          "item": "lights-and-safety",
          "status": "completed"
        },
        {
          "item": "road-test",
          "status": "completed"
        },
        {
          "item": "fuel-fill",
          "status": "completed"
        },
        {
          "item": "final-wash",
          "status": "completed"
        }
      ]
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

schedule

pdi.schedule · POST /pdis/schedule · gate offer · sandbox · answers PdiSchedule@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) · /1GC1YNEY4PF220886 (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 — Pdi.scheduleRequested@1 · Pdi.scheduled@1.

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

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

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.232Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiSchedule@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "appointment": {
      "status": "already-prepped",
      "id": "PDI-d55842b7"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "appointment": {
      "status": "already-prepped",
      "id": "PDI-d55842b7"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

pdi.pay · POST /pdis/pay · gate offer · sandbox · answers PdiPay@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) · /1GC1YNEY4PF220886 (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 — Pdi.paid@1 · Pdi.payFailed@1 · Pdi.payRequested@1.

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

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

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.174Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiPay@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "payment": {
      "id": "PAY-fc3e5ed5",
      "amountCents": 17500,
      "currency": "USD",
      "status": "settled"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "payment": {
      "id": "PAY-fc3e5ed5",
      "amountCents": 17500,
      "currency": "USD",
      "status": "settled"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

warrantyBill

pdi.warrantyBill · POST /pdis/warranty-bill · gate offer · sandbox · answers PdiWarrantyBill@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) · /1GC1YNEY4PF220886 (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 — Pdi.warrantyBillRequested@1 · Pdi.warrantyBilled@1.

the SDK — pdi.warrantyBill
import { pdi } from 'apis.vin'

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

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.262Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiWarrantyBill@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "claim": {
      "id": "PC-d8fd6b1b",
      "status": "submitted",
      "amountCents": 17500,
      "currency": "USD",
      "billTo": "pty_0UQK1EO"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "claim": {
      "id": "PC-d8fd6b1b",
      "status": "submitted",
      "amountCents": 17500,
      "currency": "USD",
      "billTo": "pty_0UQK1EO"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

perform

pdi.perform · POST /pdis/perform · gate offer · sandbox · answers PdiPerform@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) · /1GC1YNEY4PF220886 (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 — Pdi.performFailed@1 · Pdi.performRequested@1 · Pdi.performed@1.

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

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

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.174Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiPerform@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "work": {
      "status": "already-prepped",
      "id": "PDI-d55842b7"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "work": {
      "status": "already-prepped",
      "id": "PDI-d55842b7"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

complete

pdi.complete · POST /pdis/complete · gate offer · sandbox · answers PdiComplete@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) · /1GC1YNEY4PF220886 (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 — Pdi.completeRequested@1 · Pdi.completed@1.

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

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

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.174Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiComplete@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "work": {
      "status": "already-prepped",
      "id": "PDI-d55842b7"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "work": {
      "status": "already-prepped",
      "id": "PDI-d55842b7"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

protectRemove

pdi.protectRemove · POST /pdis/protect-remove · gate offer · sandbox · answers PdiProtectRemove@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) · /1GC1YNEY4PF220886 (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 — Pdi.protectRemoveRequested@1 · Pdi.protectRemoved@1.

the SDK — pdi.protectRemove
import { pdi } from 'apis.vin'

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

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.176Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiProtectRemove@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "step": {
      "item": "transit-protection-removal",
      "status": "already-completed",
      "id": "PDI-d55842b7"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "step": {
      "item": "transit-protection-removal",
      "status": "already-completed",
      "id": "PDI-d55842b7"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Authorize & resolve

claim

pdi.claim · POST /pdis/claim · gate offer · sandbox · answers PdiClaim@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) · /1GC1YNEY4PF220886 (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 — Pdi.claimFailed@1 · Pdi.claimRequested@1 · Pdi.claimed@1.

the SDK — pdi.claim
import { pdi } from 'apis.vin'

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

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.174Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiClaim@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "claim": {
      "id": "PC-d8fd6b1b",
      "status": "submitted",
      "amountCents": 17500,
      "currency": "USD",
      "billTo": "pty_0UQK1EO"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "claim": {
      "id": "PC-d8fd6b1b",
      "status": "submitted",
      "amountCents": 17500,
      "currency": "USD",
      "billTo": "pty_0UQK1EO"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

activateSystems

pdi.activateSystems · POST /pdis/activate-systems · gate offer · sandbox · answers PdiActivateSystems@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) · /1GC1YNEY4PF220886 (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 — Pdi.activateSystemsRequested@1 · Pdi.systemsActivated@1.

the SDK — pdi.activateSystems
import { pdi } from 'apis.vin'

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

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.174Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiActivateSystems@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "activation": {
      "status": "already-active",
      "connection": "active"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "activation": {
      "status": "already-active",
      "connection": "active"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

dealerPrep

pdi.dealerPrep · POST /pdis/dealer-prep · gate offer · sandbox · answers PdiDealerPrep@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) · /1GC1YNEY4PF220886 (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 — Pdi.dealerPrepRequested@1 · Pdi.dealerPrepped@1.

the SDK — pdi.dealerPrep
import { pdi } from 'apis.vin'

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

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.174Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiDealerPrep@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "work": {
      "status": "already-prepped",
      "id": "PDI-d55842b7"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "work": {
      "status": "already-prepped",
      "id": "PDI-d55842b7"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

fuel

pdi.fuel · POST /pdis/fuel · gate offer · sandbox · answers PdiFuel@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) · /1GC1YNEY4PF220886 (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 — Pdi.fuelRequested@1 · Pdi.fueled@1.

the SDK — pdi.fuel
import { pdi } from 'apis.vin'

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

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.174Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiFuel@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "fuel": {
      "item": "fuel-fill",
      "amountCents": 6000,
      "currency": "USD",
      "status": "already-filled"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "fuel": {
      "item": "fuel-fill",
      "amountCents": 6000,
      "currency": "USD",
      "status": "already-filled"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

wash

pdi.wash · POST /pdis/wash · gate offer · sandbox · answers PdiWash@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) · /1GC1YNEY4PF220886 (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 — Pdi.washRequested@1 · Pdi.washed@1.

the SDK — pdi.wash
import { pdi } from 'apis.vin'

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

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.262Z · HTTP 200
{
  "type": "OK",
  "answers": "PdiWash@1",
  "value": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "step": {
      "item": "final-wash",
      "status": "already-completed",
      "id": "PDI-d55842b7"
    }
  },
  "evidence": {
    "vin": "1GC1YNEY4PF220886",
    "noun": "pdi",
    "asOf": "2026-08-10",
    "standing": "completed",
    "step": {
      "item": "final-wash",
      "status": "already-completed",
      "id": "PDI-d55842b7"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "oem-factory-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.

Inspection

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

paint

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

pdr

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

On this page

Identity
Events
Discover & read
history
status
result
specLookup
checklist
Apply & book
schedule
Pay & settle
pay
warrantyBill
Fulfill & operate
perform
complete
protectRemove
Authorize & resolve
claim
More actions
activateSystems
dealerPrep
fuel
wash
Data model
Inspection