psi
The psi noun — identity, lifecycle, events, and every capability as an anchored section: 13 capabilities, 0 live, 13 sandbox, 0 declared.
psi is one of the estate's 317 automotive nouns — a job a car needs done. It carries 13 capabilities: 0 live, 13 sandbox, 0 declared · doors aggregator.vin.
Identity
| Noun | psi |
| Pillar | Services (facets: 4 data · 6 services · 3 commerce) |
| Capabilities | 13 — 0 live · 13 sandbox · 0 declared |
| Entities | Inspection |
| Doors | aggregator.vin |
| SDK | Vin.psi.* from apis.vin |
| Address | /catalog/psi#{action} — the anchor IS the wire name minus psi. |
Events
The vocabulary this noun can append to the record — 9 past-tense, versioned event types, each linked to the capability that emits it:
Psi.disputed@1— emitted bydisputePsi.failed@1— emitted byfailInsp·pay·quote·refundPsi.paid@1— emitted bypayPsi.passed@1— emitted bypassInspPsi.performed@1— emitted byperformPsi.quoted@1— emitted byquotePsi.refunded@1— emitted byrefundPsi.requested@1— emitted byperform·request·schedulePsi.scheduled@1— emitted byschedule
Discover & read
read
psi.read · GET /psis/read · gate none · sandbox · answers PsiRead@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1HGCV1F16NA044706 (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.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.read({"vin":"1HGCV1F16NA044706"})curl 'https://apis.vin/psis/read?vin=1HGCV1F16NA044706'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.
{
"type": "OK",
"answers": "PsiRead@1",
"value": {
"id": "psi_5a5d699e",
"vin": "vin-22b23d64",
"type": "option-2",
"location": "location-4b15a624",
"inspectorId": "provider_16a2b061",
"grade": "grade-43a2babe",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_5a5d699e",
"vin": "vin-22b23d64",
"type": "option-2",
"location": "location-4b15a624",
"inspectorId": "provider_16a2b061",
"grade": "grade-43a2babe",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}result
psi.result · GET /psis/result · gate none · sandbox · answers PsiResult@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1HGCV1F16NA044706 (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.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.result({"vin":"1HGCV1F16NA044706"})curl 'https://apis.vin/psis/result?vin=1HGCV1F16NA044706'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.
{
"type": "OK",
"answers": "PsiResult@1",
"value": {
"id": "psi_92b8d9b6",
"vin": "vin-affa0a3c",
"type": "option-1",
"location": "location-ac0f53dc",
"inspectorId": "provider_82fc6159",
"grade": "grade-aa363976",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_92b8d9b6",
"vin": "vin-affa0a3c",
"type": "option-1",
"location": "location-ac0f53dc",
"inspectorId": "provider_82fc6159",
"grade": "grade-aa363976",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}report
psi.report · GET /psis/report · gate key · sandbox · answers PsiReport@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1HGCV1F16NA044706 (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.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.report({"vin":"1HGCV1F16NA044706"})curl 'https://apis.vin/psis/report?vin=1HGCV1F16NA044706'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.
{
"type": "OK",
"answers": "PsiReport@1",
"value": {
"id": "psi_8252e1c7",
"vin": "vin-7231b96b",
"type": "option-1",
"location": "location-865ec519",
"inspectorId": "provider_cee32c7e",
"grade": "grade-0f98168d",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_8252e1c7",
"vin": "vin-7231b96b",
"type": "option-1",
"location": "location-865ec519",
"inspectorId": "provider_cee32c7e",
"grade": "grade-0f98168d",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}checklist
psi.checklist · GET /psis/checklist · gate none · sandbox · answers PsiChecklist@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1HGCV1F16NA044706 (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.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.checklist({"vin":"1HGCV1F16NA044706"})curl 'https://apis.vin/psis/checklist?vin=1HGCV1F16NA044706'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.
{
"type": "OK",
"answers": "PsiChecklist@1",
"value": {
"id": "psi_30d629f5",
"vin": "vin-b18c49e5",
"type": "option-1",
"location": "location-480b1f7f",
"inspectorId": "provider_ae6adb44",
"grade": "grade-808763cf",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_30d629f5",
"vin": "vin-b18c49e5",
"type": "option-1",
"location": "location-480b1f7f",
"inspectorId": "provider_ae6adb44",
"grade": "grade-808763cf",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Quote & price
quote
psi.quote · POST /psis/quote · gate offer · sandbox · answers PsiQuote@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
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) · /1HGCV1F16NA044706 (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 — Psi.failed@1 · Psi.quoted@1.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.quote({"vin":"1HGCV1F16NA044706"})curl -X POST https://apis.vin/psis/quote \
-H 'content-type: application/json' \
-d '{"vin":"1HGCV1F16NA044706"}'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.
{
"type": "OK",
"answers": "PsiQuote@1",
"value": {
"id": "psi_ff292260",
"vin": "vin-b6031f0a",
"type": "option-3",
"location": "location-b3a4a526",
"inspectorId": "provider_67f24f13",
"grade": "grade-7d1ab0b4",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_ff292260",
"vin": "vin-b6031f0a",
"type": "option-3",
"location": "location-b3a4a526",
"inspectorId": "provider_67f24f13",
"grade": "grade-7d1ab0b4",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Apply & book
request
psi.request · POST /psis/request · gate offer · sandbox · answers PsiRequest@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
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) · /1HGCV1F16NA044706 (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 — Psi.requested@1.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.request({"vin":"1HGCV1F16NA044706"})curl -X POST https://apis.vin/psis/request \
-H 'content-type: application/json' \
-d '{"vin":"1HGCV1F16NA044706"}'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.
{
"type": "OK",
"answers": "PsiRequest@1",
"value": {
"id": "psi_a2b72365",
"vin": "vin-0bba5a95",
"type": "option-1",
"location": "location-c7b49d4f",
"inspectorId": "provider_bfb47f94",
"grade": "grade-e6eb4c3f",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_a2b72365",
"vin": "vin-0bba5a95",
"type": "option-1",
"location": "location-c7b49d4f",
"inspectorId": "provider_bfb47f94",
"grade": "grade-e6eb4c3f",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}schedule
psi.schedule · POST /psis/schedule · gate offer · sandbox · answers PsiSchedule@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
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) · /1HGCV1F16NA044706 (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 — Psi.requested@1 · Psi.scheduled@1.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.schedule({"vin":"1HGCV1F16NA044706"})curl -X POST https://apis.vin/psis/schedule \
-H 'content-type: application/json' \
-d '{"vin":"1HGCV1F16NA044706"}'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.
{
"type": "OK",
"answers": "PsiSchedule@1",
"value": {
"id": "psi_03658fa6",
"vin": "vin-9d51db6c",
"type": "option-3",
"location": "location-45f2f1ec",
"inspectorId": "provider_e637ece9",
"grade": "grade-9d87f826",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_03658fa6",
"vin": "vin-9d51db6c",
"type": "option-3",
"location": "location-45f2f1ec",
"inspectorId": "provider_e637ece9",
"grade": "grade-9d87f826",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Pay & settle
pay
psi.pay · POST /psis/pay · gate offer · sandbox · answers PsiPay@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
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) · /1HGCV1F16NA044706 (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 — Psi.failed@1 · Psi.paid@1.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.pay({"vin":"1HGCV1F16NA044706"})curl -X POST https://apis.vin/psis/pay \
-H 'content-type: application/json' \
-d '{"vin":"1HGCV1F16NA044706"}'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.
{
"type": "OK",
"answers": "PsiPay@1",
"value": {
"id": "psi_8aa854ad",
"vin": "vin-f44c74bd",
"type": "option-2",
"location": "location-10585197",
"inspectorId": "provider_42a7cf1c",
"grade": "grade-1820a787",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_8aa854ad",
"vin": "vin-f44c74bd",
"type": "option-2",
"location": "location-10585197",
"inspectorId": "provider_42a7cf1c",
"grade": "grade-1820a787",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}refund
psi.refund · POST /psis/refund · gate offer · sandbox · answers PsiRefund@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
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) · /1HGCV1F16NA044706 (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 — Psi.failed@1 · Psi.refunded@1.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.refund({"vin":"1HGCV1F16NA044706"})curl -X POST https://apis.vin/psis/refund \
-H 'content-type: application/json' \
-d '{"vin":"1HGCV1F16NA044706"}'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.
{
"type": "OK",
"answers": "PsiRefund@1",
"value": {
"id": "psi_85a46a73",
"vin": "vin-bb5b8267",
"type": "option-3",
"location": "location-b17ebbe5",
"inspectorId": "provider_4a29adc2",
"grade": "grade-a9311221",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_85a46a73",
"vin": "vin-bb5b8267",
"type": "option-3",
"location": "location-b17ebbe5",
"inspectorId": "provider_4a29adc2",
"grade": "grade-a9311221",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Fulfill & operate
perform
psi.perform · POST /psis/perform · gate offer · sandbox · answers PsiPerform@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
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) · /1HGCV1F16NA044706 (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 — Psi.performed@1 · Psi.requested@1.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.perform({"vin":"1HGCV1F16NA044706"})curl -X POST https://apis.vin/psis/perform \
-H 'content-type: application/json' \
-d '{"vin":"1HGCV1F16NA044706"}'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.
{
"type": "OK",
"answers": "PsiPerform@1",
"value": {
"id": "psi_5b2d53c1",
"vin": "vin-25a0f6d1",
"type": "option-3",
"location": "location-8159b00b",
"inspectorId": "provider_055715c8",
"grade": "grade-cabf2a73",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_5b2d53c1",
"vin": "vin-25a0f6d1",
"type": "option-3",
"location": "location-8159b00b",
"inspectorId": "provider_055715c8",
"grade": "grade-cabf2a73",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Authorize & resolve
dispute
psi.dispute · POST /psis/dispute · gate offer · sandbox · answers PsiDispute@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
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) · /1HGCV1F16NA044706 (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 — Psi.disputed@1.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.dispute({"vin":"1HGCV1F16NA044706"})curl -X POST https://apis.vin/psis/dispute \
-H 'content-type: application/json' \
-d '{"vin":"1HGCV1F16NA044706"}'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.
{
"type": "OK",
"answers": "PsiDispute@1",
"value": {
"id": "psi_4aa9060f",
"vin": "vin-bef17fd3",
"type": "option-1",
"location": "location-8c1a0ae1",
"inspectorId": "provider_54c21786",
"grade": "grade-3e71aaf5",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_4aa9060f",
"vin": "vin-bef17fd3",
"type": "option-1",
"location": "location-8c1a0ae1",
"inspectorId": "provider_54c21786",
"grade": "grade-3e71aaf5",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}More actions
failInsp
psi.failInsp · POST /psis/fail-insp · gate offer · sandbox · answers PsiFailInsp@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
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) · /1HGCV1F16NA044706 (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 — Psi.failed@1.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.failInsp({"vin":"1HGCV1F16NA044706"})curl -X POST https://apis.vin/psis/fail-insp \
-H 'content-type: application/json' \
-d '{"vin":"1HGCV1F16NA044706"}'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.
{
"type": "OK",
"answers": "PsiFailInsp@1",
"value": {
"id": "psi_be7239a4",
"vin": "vin-5b48823e",
"type": "option-1",
"location": "location-ce6e1e4a",
"inspectorId": "provider_2ba5a91f",
"grade": "grade-600180e0",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_be7239a4",
"vin": "vin-5b48823e",
"type": "option-1",
"location": "location-ce6e1e4a",
"inspectorId": "provider_2ba5a91f",
"grade": "grade-600180e0",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}passInsp
psi.passInsp · POST /psis/pass-insp · gate offer · sandbox · answers PsiPassInsp@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
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) · /1HGCV1F16NA044706 (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 — Psi.passed@1.
import { psi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await psi.passInsp({"vin":"1HGCV1F16NA044706"})curl -X POST https://apis.vin/psis/pass-insp \
-H 'content-type: application/json' \
-d '{"vin":"1HGCV1F16NA044706"}'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.
{
"type": "OK",
"answers": "PsiPassInsp@1",
"value": {
"id": "psi_d1f760de",
"vin": "vin-2798d7a4",
"type": "option-3",
"location": "location-66ac0364",
"inspectorId": "provider_6816e9a1",
"grade": "grade-8db78dfe",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "psi_d1f760de",
"vin": "vin-2798d7a4",
"type": "option-3",
"location": "location-66ac0364",
"inspectorId": "provider_6816e9a1",
"grade": "grade-8db78dfe",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "psi-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.
provider
The provider noun — identity, lifecycle, events, and every capability as an anchored section: 34 capabilities, 0 live, 34 sandbox, 0 declared.
qualityCheck
The qualityCheck noun — identity, lifecycle, events, and every capability as an anchored section: 11 capabilities, 0 live, 11 sandbox, 0 declared.