mpi
The mpi noun — identity, lifecycle, events, and every capability as an anchored section: 14 capabilities, 0 live, 14 sandbox, 0 declared.
mpi is one of the estate's 317 automotive nouns — a job a car needs done. It carries 14 capabilities: 0 live, 14 sandbox, 0 declared · doors aggregator.vin.
Identity
| Noun | mpi |
| Pillar | Data (facets: 5 data · 5 services · 4 commerce) |
| Capabilities | 14 — 0 live · 14 sandbox · 0 declared |
| Entities | Inspection |
| Doors | aggregator.vin |
| SDK | Vin.mpi.* from apis.vin |
| Address | /catalog/mpi#{action} — the anchor IS the wire name minus mpi. |
Events
The vocabulary this noun can append to the record — 22 past-tense, versioned event types, each linked to the capability that emits it:
Mpi.annotateRequested@1— emitted byannotateMpi.annotated@1— emitted byannotateMpi.approveRequested@1— emitted byapproveMpi.approved@1— emitted byapproveMpi.captureFailed@1— emitted bycaptureMpi.captureRequested@1— emitted bycaptureMpi.captured@1— emitted bycaptureMpi.completeRequested@1— emitted bycompleteMpi.completed@1— emitted bycompleteMpi.customerSent@1— emitted bysendToCustomerMpi.declineRequested@1— emitted bydeclineMpi.declined@1— emitted bydeclineMpi.paid@1— emitted bypayMpi.payFailed@1— emitted bypayMpi.payRequested@1— emitted bypayMpi.performFailed@1— emitted byperformMpi.performRequested@1— emitted byperformMpi.performed@1— emitted byperformMpi.resulted@1— emitted byresultMpi.sendToCustomerRequested@1— emitted bysendToCustomerMpi.upsellRequested@1— emitted byupsellMpi.upselled@1— emitted byupsell
Discover & read
history
mpi.history · GET /mpis/history · gate none · sandbox · answers MpiHistory@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /3C63R3AT5GG155606 (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 { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.history({"vin":"3C63R3AT5GG155606"})curl 'https://apis.vin/mpis/history?vin=3C63R3AT5GG155606'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": "MpiHistory@1",
"value": {
"id": "mpi_b4962180",
"vin": "vin-3099ecaa",
"type": "option-2",
"location": "location-9bbeb246",
"inspectorId": "provider_22c594f3",
"grade": "grade-56e0fd54",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_b4962180",
"vin": "vin-3099ecaa",
"type": "option-2",
"location": "location-9bbeb246",
"inspectorId": "provider_22c594f3",
"grade": "grade-56e0fd54",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}result
mpi.result · GET /mpis/result · gate key · sandbox · answers MpiResult@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /3C63R3AT5GG155606 (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 — Mpi.resulted@1.
import { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.result({"vin":"3C63R3AT5GG155606"})curl 'https://apis.vin/mpis/result?vin=3C63R3AT5GG155606'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": "MpiResult@1",
"value": {
"id": "mpi_0d9c0b13",
"vin": "vin-262cf987",
"type": "option-1",
"location": "location-c325cd85",
"inspectorId": "provider_3be41a22",
"grade": "grade-65c04041",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_0d9c0b13",
"vin": "vin-262cf987",
"type": "option-1",
"location": "location-c325cd85",
"inspectorId": "provider_3be41a22",
"grade": "grade-65c04041",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}photos
mpi.photos · GET /mpis/photos · gate none · sandbox · answers MpiPhotos@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /3C63R3AT5GG155606 (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 { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.photos({"vin":"3C63R3AT5GG155606"})curl 'https://apis.vin/mpis/photos?vin=3C63R3AT5GG155606'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": "MpiPhotos@1",
"value": {
"id": "mpi_95180d90",
"vin": "vin-0fab217a",
"type": "option-1",
"location": "location-10fd39f6",
"inspectorId": "provider_a9587423",
"grade": "grade-f27e04e4",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_95180d90",
"vin": "vin-0fab217a",
"type": "option-1",
"location": "location-10fd39f6",
"inspectorId": "provider_a9587423",
"grade": "grade-f27e04e4",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Pay & settle
pay
mpi.pay · POST /mpis/pay · gate offer · sandbox · answers MpiPay@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) · /3C63R3AT5GG155606 (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 — Mpi.paid@1 · Mpi.payFailed@1 · Mpi.payRequested@1.
import { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.pay({"vin":"3C63R3AT5GG155606"})curl -X POST https://apis.vin/mpis/pay \
-H 'content-type: application/json' \
-d '{"vin":"3C63R3AT5GG155606"}'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": "MpiPay@1",
"value": {
"id": "mpi_1649266d",
"vin": "vin-0275dc7d",
"type": "option-3",
"location": "location-5e2b9e57",
"inspectorId": "provider_92a881dc",
"grade": "grade-2b458447",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_1649266d",
"vin": "vin-0275dc7d",
"type": "option-3",
"location": "location-5e2b9e57",
"inspectorId": "provider_92a881dc",
"grade": "grade-2b458447",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}capture
mpi.capture · POST /mpis/capture · gate offer · sandbox · answers MpiCapture@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) · /3C63R3AT5GG155606 (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 — Mpi.captureFailed@1 · Mpi.captureRequested@1 · Mpi.captured@1.
import { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.capture({"vin":"3C63R3AT5GG155606"})curl -X POST https://apis.vin/mpis/capture \
-H 'content-type: application/json' \
-d '{"vin":"3C63R3AT5GG155606"}'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": "MpiCapture@1",
"value": {
"id": "mpi_2c908b18",
"vin": "vin-679d5402",
"type": "option-3",
"location": "location-e9a9265e",
"inspectorId": "provider_eebbe64b",
"grade": "grade-a51007ac",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_2c908b18",
"vin": "vin-679d5402",
"type": "option-3",
"location": "location-e9a9265e",
"inspectorId": "provider_eebbe64b",
"grade": "grade-a51007ac",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}upsell
mpi.upsell · POST /mpis/upsell · gate offer · sandbox · answers MpiUpsell@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) · /3C63R3AT5GG155606 (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 — Mpi.upsellRequested@1 · Mpi.upselled@1.
import { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.upsell({"vin":"3C63R3AT5GG155606"})curl -X POST https://apis.vin/mpis/upsell \
-H 'content-type: application/json' \
-d '{"vin":"3C63R3AT5GG155606"}'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": "MpiUpsell@1",
"value": {
"id": "mpi_dd990f57",
"vin": "vin-16b073bb",
"type": "option-2",
"location": "location-0e257089",
"inspectorId": "provider_9863bbae",
"grade": "grade-e0c7e39d",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_dd990f57",
"vin": "vin-16b073bb",
"type": "option-2",
"location": "location-0e257089",
"inspectorId": "provider_9863bbae",
"grade": "grade-e0c7e39d",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Fulfill & operate
perform
mpi.perform · POST /mpis/perform · gate offer · sandbox · answers MpiPerform@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) · /3C63R3AT5GG155606 (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 — Mpi.performFailed@1 · Mpi.performRequested@1 · Mpi.performed@1.
import { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.perform({"vin":"3C63R3AT5GG155606"})curl -X POST https://apis.vin/mpis/perform \
-H 'content-type: application/json' \
-d '{"vin":"3C63R3AT5GG155606"}'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": "MpiPerform@1",
"value": {
"id": "mpi_f62e6e10",
"vin": "vin-65e50afa",
"type": "option-1",
"location": "location-215c9676",
"inspectorId": "provider_3df60da3",
"grade": "grade-bc85ca64",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_f62e6e10",
"vin": "vin-65e50afa",
"type": "option-1",
"location": "location-215c9676",
"inspectorId": "provider_3df60da3",
"grade": "grade-bc85ca64",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}complete
mpi.complete · POST /mpis/complete · gate offer · sandbox · answers MpiComplete@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) · /3C63R3AT5GG155606 (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 — Mpi.completeRequested@1 · Mpi.completed@1.
import { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.complete({"vin":"3C63R3AT5GG155606"})curl -X POST https://apis.vin/mpis/complete \
-H 'content-type: application/json' \
-d '{"vin":"3C63R3AT5GG155606"}'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": "MpiComplete@1",
"value": {
"id": "mpi_9d5a6bfb",
"vin": "vin-b6c0da2f",
"type": "option-2",
"location": "location-525a53ad",
"inspectorId": "provider_0ccead8a",
"grade": "grade-c4c1dbe9",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_9d5a6bfb",
"vin": "vin-b6c0da2f",
"type": "option-2",
"location": "location-525a53ad",
"inspectorId": "provider_0ccead8a",
"grade": "grade-c4c1dbe9",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}annotate
mpi.annotate · POST /mpis/annotate · gate offer · sandbox · answers MpiAnnotate@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) · /3C63R3AT5GG155606 (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 — Mpi.annotateRequested@1 · Mpi.annotated@1.
import { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.annotate({"vin":"3C63R3AT5GG155606"})curl -X POST https://apis.vin/mpis/annotate \
-H 'content-type: application/json' \
-d '{"vin":"3C63R3AT5GG155606"}'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": "MpiAnnotate@1",
"value": {
"id": "mpi_a120053d",
"vin": "vin-802b3ccd",
"type": "option-3",
"location": "location-512235c7",
"inspectorId": "provider_1ff5554c",
"grade": "grade-f1fc7f17",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_a120053d",
"vin": "vin-802b3ccd",
"type": "option-3",
"location": "location-512235c7",
"inspectorId": "provider_1ff5554c",
"grade": "grade-f1fc7f17",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Authorize & resolve
approve
mpi.approve · POST /mpis/approve · gate offer · sandbox · answers MpiApprove@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) · /3C63R3AT5GG155606 (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 — Mpi.approveRequested@1 · Mpi.approved@1.
import { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.approve({"vin":"3C63R3AT5GG155606"})curl -X POST https://apis.vin/mpis/approve \
-H 'content-type: application/json' \
-d '{"vin":"3C63R3AT5GG155606"}'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": "MpiApprove@1",
"value": {
"id": "mpi_71d818a2",
"vin": "vin-38ccae08",
"type": "option-2",
"location": "location-9eef8e08",
"inspectorId": "provider_db0b64bd",
"grade": "grade-09cb058a",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_71d818a2",
"vin": "vin-38ccae08",
"type": "option-2",
"location": "location-9eef8e08",
"inspectorId": "provider_db0b64bd",
"grade": "grade-09cb058a",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}decline
mpi.decline · POST /mpis/decline · gate offer · sandbox · answers MpiDecline@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) · /3C63R3AT5GG155606 (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 — Mpi.declineRequested@1 · Mpi.declined@1.
import { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.decline({"vin":"3C63R3AT5GG155606"})curl -X POST https://apis.vin/mpis/decline \
-H 'content-type: application/json' \
-d '{"vin":"3C63R3AT5GG155606"}'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": "MpiDecline@1",
"value": {
"id": "mpi_4b2e6bff",
"vin": "vin-21018c03",
"type": "option-3",
"location": "location-f7c46cf1",
"inspectorId": "provider_d24fca96",
"grade": "grade-e003d7a5",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_4b2e6bff",
"vin": "vin-21018c03",
"type": "option-3",
"location": "location-f7c46cf1",
"inspectorId": "provider_d24fca96",
"grade": "grade-e003d7a5",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}More actions
recommendation
mpi.recommendation · GET /mpis/recommendation · gate none · sandbox · answers MpiRecommendation@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /3C63R3AT5GG155606 (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 { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.recommendation({"vin":"3C63R3AT5GG155606"})curl 'https://apis.vin/mpis/recommendation?vin=3C63R3AT5GG155606'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": "MpiRecommendation@1",
"value": {
"id": "mpi_2fa53783",
"vin": "vin-8d288577",
"type": "option-3",
"location": "location-b176a715",
"inspectorId": "provider_edb68db2",
"grade": "grade-11004fb1",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_2fa53783",
"vin": "vin-8d288577",
"type": "option-3",
"location": "location-b176a715",
"inspectorId": "provider_edb68db2",
"grade": "grade-11004fb1",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}sendToCustomer
mpi.sendToCustomer · POST /mpis/send-to-customer · gate offer · sandbox · answers MpiSendToCustomer@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) · /3C63R3AT5GG155606 (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 — Mpi.sendToCustomerRequested@1 · Mpi.customerSent@1.
import { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.sendToCustomer({"vin":"3C63R3AT5GG155606"})curl -X POST https://apis.vin/mpis/send-to-customer \
-H 'content-type: application/json' \
-d '{"vin":"3C63R3AT5GG155606"}'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": "MpiSendToCustomer@1",
"value": {
"id": "mpi_fa711f9e",
"vin": "vin-21b9bf64",
"type": "option-1",
"location": "location-70dbac24",
"inspectorId": "provider_01d87261",
"grade": "grade-75ab0cbe",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_fa711f9e",
"vin": "vin-21b9bf64",
"type": "option-1",
"location": "location-70dbac24",
"inspectorId": "provider_01d87261",
"grade": "grade-75ab0cbe",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}video
mpi.video · GET /mpis/video · gate none · sandbox · answers MpiVideo@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /3C63R3AT5GG155606 (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 { mpi } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await mpi.video({"vin":"3C63R3AT5GG155606"})curl 'https://apis.vin/mpis/video?vin=3C63R3AT5GG155606'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": "MpiVideo@1",
"value": {
"id": "mpi_2db4c24b",
"vin": "vin-e781b67f",
"type": "option-3",
"location": "location-7955649d",
"inspectorId": "provider_41be22ba",
"grade": "grade-3702b7b9",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"evidence": {
"id": "mpi_2db4c24b",
"vin": "vin-e781b67f",
"type": "option-3",
"location": "location-7955649d",
"inspectorId": "provider_41be22ba",
"grade": "grade-3702b7b9",
"damages": [],
"photos": [],
"status": "Inspection-01"
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "mpi-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.
moneyInstrument
The moneyInstrument noun — identity, lifecycle, events, and every capability as an anchored section: 3 capabilities, 0 live, 3 sandbox, 0 declared.
nmvtis
The nmvtis noun — identity, lifecycle, events, and every capability as an anchored section: 8 capabilities, 0 live, 8 sandbox, 0 declared.