docs.vin

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

Nounpsi
PillarServices (facets: 4 data · 6 services · 3 commerce)
Capabilities13 — 0 live · 13 sandbox · 0 declared
EntitiesInspection
Doorsaggregator.vin
SDKVin.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:

Discover & read

read

psi.read · GET /psis/read · gate none · sandbox · answers PsiRead@1

FieldTypeRequiredNotes
vinstringno

Dooraggregator.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.

the SDK — psi.read
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"})
GET /psis/read
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.

receipt · executed 2026-08-17T12:42:16.066Z · HTTP 200
{
  "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

FieldTypeRequiredNotes
vinstringno

Dooraggregator.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.

the SDK — psi.result
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"})
GET /psis/result
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.

receipt · executed 2026-08-17T12:42:16.067Z · HTTP 200
{
  "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

FieldTypeRequiredNotes
vinstringno

Dooraggregator.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.

the SDK — psi.report
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"})
GET /psis/report
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.

receipt · executed 2026-08-17T12:42:16.066Z · HTTP 200
{
  "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

FieldTypeRequiredNotes
vinstringno

Dooraggregator.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.

the SDK — psi.checklist
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"})
GET /psis/checklist
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.

receipt · executed 2026-08-17T12:42:16.016Z · HTTP 200
{
  "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

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.

Dooraggregator.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.

EmitsPsi.failed@1 · Psi.quoted@1.

the SDK — psi.quote
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"})
POST /psis/quote
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.

receipt · executed 2026-08-17T12:42:16.066Z · HTTP 200
{
  "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

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.

Dooraggregator.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.

EmitsPsi.requested@1.

the SDK — psi.request
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"})
POST /psis/request
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.

receipt · executed 2026-08-17T12:42:16.066Z · HTTP 200
{
  "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

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.

Dooraggregator.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.

EmitsPsi.requested@1 · Psi.scheduled@1.

the SDK — psi.schedule
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"})
POST /psis/schedule
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.

receipt · executed 2026-08-17T12:42:16.067Z · HTTP 200
{
  "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

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.

Dooraggregator.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.

EmitsPsi.failed@1 · Psi.paid@1.

the SDK — psi.pay
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"})
POST /psis/pay
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.

receipt · executed 2026-08-17T12:42:16.066Z · HTTP 200
{
  "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

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.

Dooraggregator.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.

EmitsPsi.failed@1 · Psi.refunded@1.

the SDK — psi.refund
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"})
POST /psis/refund
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.

receipt · executed 2026-08-17T12:42:16.066Z · HTTP 200
{
  "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

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.

Dooraggregator.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.

EmitsPsi.performed@1 · Psi.requested@1.

the SDK — psi.perform
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"})
POST /psis/perform
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.

receipt · executed 2026-08-17T12:42:16.066Z · HTTP 200
{
  "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

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.

Dooraggregator.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.

EmitsPsi.disputed@1.

the SDK — psi.dispute
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"})
POST /psis/dispute
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.

receipt · executed 2026-08-17T12:42:16.016Z · HTTP 200
{
  "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

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.

Dooraggregator.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.

EmitsPsi.failed@1.

the SDK — psi.failInsp
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"})
POST /psis/fail-insp
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.

receipt · executed 2026-08-17T12:42:16.016Z · HTTP 200
{
  "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

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.

Dooraggregator.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.

EmitsPsi.passed@1.

the SDK — psi.passInsp
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"})
POST /psis/pass-insp
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.

receipt · executed 2026-08-17T12:42:16.065Z · HTTP 200
{
  "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.