otd
The otd noun — identity, lifecycle, events, and every capability as an anchored section: 5 capabilities, 0 live, 5 sandbox, 0 declared.
otd is one of the estate's 317 automotive nouns — a job a car needs done. It carries 5 capabilities: 0 live, 5 sandbox, 0 declared · doors taxes.vin.
Identity
| Noun | otd |
| Pillar | Data (facets: 2 data · 2 services · 1 commerce) |
| Capabilities | 5 — 0 live · 5 sandbox · 0 declared |
| Entities | Deal |
| Doors | taxes.vin |
| SDK | Vin.otd.* from apis.vin |
| Address | /catalog/otd#{action} — the anchor IS the wire name minus otd. |
Events
The vocabulary this noun can append to the record — 7 past-tense, versioned event types, each linked to the capability that emits it:
DMVFee.flagged@1— emitted byreconcileDMVFee.reconciled@1— emitted byreconcileOTD.posted@1— emitted byreconcileOtd.buyersOrderIssued@1— emitted bybuyersOrderOtd.failed@1— emitted byquoteOtd.quoted@1— emitted byquoteOtd.reconciled@1— emitted byreconcile
Quote & price
quote
otd.quote · POST /otds/quote · gate offer · sandbox · answers OtdQuote@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 — taxes.vin serves this noun on its two routes: / (the landing) · /3GKALVEVXML396352 (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 — Otd.failed@1 · Otd.quoted@1.
import { otd } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await otd.quote({"vin":"3GKALVEVXML396352"})curl -X POST https://apis.vin/otds/quote \
-H 'content-type: application/json' \
-d '{"vin":"3GKALVEVXML396352"}'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": "OtdQuote@1",
"value": {
"dealId": "otd_a3e74ec6",
"workflow": "workflow-e680ed0c",
"dealType": "Deal-01",
"vehicleId": "vehicle_09e47096",
"buyerId": "party_10bf4319",
"sellerId": "party_280f4f97",
"dealerOfRecordId": "dealer_4eb9c6b5",
"authority": "mandate_d7a3c9e2",
"structure": "Deal-01",
"state": "Deal-01",
"correlationId": "W0-EVT-01",
"dependsOn": []
},
"evidence": {
"dealId": "otd_a3e74ec6",
"workflow": "workflow-e680ed0c",
"dealType": "Deal-01",
"vehicleId": "vehicle_09e47096",
"buyerId": "party_10bf4319",
"sellerId": "party_280f4f97",
"dealerOfRecordId": "dealer_4eb9c6b5",
"authority": "mandate_d7a3c9e2",
"structure": "Deal-01",
"state": "Deal-01",
"correlationId": "W0-EVT-01",
"dependsOn": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "otd-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}compute
otd.compute · GET /otds/compute · gate key · sandbox · answers OtdCompute@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — taxes.vin serves this noun on its two routes: / (the landing) · /3GKALVEVXML396352 (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 { otd } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await otd.compute({"vin":"3GKALVEVXML396352"})curl 'https://apis.vin/otds/compute?vin=3GKALVEVXML396352'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": "OtdCompute@1",
"value": {
"dealId": "otd_4cb54b84",
"workflow": "workflow-b488b216",
"dealType": "Deal-01",
"vehicleId": "vehicle_9af492d0",
"buyerId": "party_3892ab43",
"sellerId": "party_f4f5e17d",
"dealerOfRecordId": "dealer_e8b8cb57",
"authority": "mandate_6f01b8bc",
"structure": "Deal-01",
"state": "Deal-01",
"correlationId": "W0-EVT-01",
"dependsOn": []
},
"evidence": {
"dealId": "otd_4cb54b84",
"workflow": "workflow-b488b216",
"dealType": "Deal-01",
"vehicleId": "vehicle_9af492d0",
"buyerId": "party_3892ab43",
"sellerId": "party_f4f5e17d",
"dealerOfRecordId": "dealer_e8b8cb57",
"authority": "mandate_6f01b8bc",
"structure": "Deal-01",
"state": "Deal-01",
"correlationId": "W0-EVT-01",
"dependsOn": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "otd-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Apply & book
buyersOrder
otd.buyersOrder · POST /otds/buyers-order · gate offer · sandbox · answers OtdBuyersOrder@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 — taxes.vin serves this noun on its two routes: / (the landing) · /3GKALVEVXML396352 (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 — Otd.buyersOrderIssued@1.
import { otd } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await otd.buyersOrder({"vin":"3GKALVEVXML396352"})curl -X POST https://apis.vin/otds/buyers-order \
-H 'content-type: application/json' \
-d '{"vin":"3GKALVEVXML396352"}'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": "OtdBuyersOrder@1",
"value": {
"dealId": "otd_7c2fa5e0",
"workflow": "workflow-f5ef0712",
"dealType": "Deal-01",
"vehicleId": "vehicle_a6cd401c",
"buyerId": "party_15276cdf",
"sellerId": "party_4ca53961",
"dealerOfRecordId": "dealer_89464d33",
"authority": "mandate_95cecdf0",
"structure": "Deal-01",
"state": "Deal-01",
"correlationId": "W0-EVT-01",
"dependsOn": []
},
"evidence": {
"dealId": "otd_7c2fa5e0",
"workflow": "workflow-f5ef0712",
"dealType": "Deal-01",
"vehicleId": "vehicle_a6cd401c",
"buyerId": "party_15276cdf",
"sellerId": "party_4ca53961",
"dealerOfRecordId": "dealer_89464d33",
"authority": "mandate_95cecdf0",
"structure": "Deal-01",
"state": "Deal-01",
"correlationId": "W0-EVT-01",
"dependsOn": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "otd-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Pay & settle
reconcile
otd.reconcile · POST /otds/reconcile · gate offer · sandbox · answers OtdReconcile@1
| Field | Type | Required | Notes |
|---|---|---|---|
subject | string | yes | — |
zip | string | no | — |
itemized | array<object> | 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.
Delegated calls require a typed Mandate — { ceiling, perAction, expires, tripwires }; the ceiling is a field, not a conversation.
Door — taxes.vin serves this noun on its two routes: / (the landing) · /3GKALVEVXML396352 (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 — DMVFee.flagged@1 · DMVFee.reconciled@1 · OTD.posted@1 · Otd.reconciled@1.
import { otd } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await otd.reconcile({"subject":"subject"})curl -X POST https://apis.vin/otds/reconcile \
-H 'content-type: application/json' \
-d '{"subject":"subject"}'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": "OtdReconcile@1",
"value": {
"dealId": "otd_5830eda3",
"workflow": "workflow-f94ad675",
"dealType": "Deal-01",
"vehicleId": "vehicle_e0f369b5",
"buyerId": "party_dc824172",
"sellerId": "party_d098ecce",
"dealerOfRecordId": "dealer_3fdb999c",
"authority": "mandate_2631713d",
"structure": "Deal-01",
"state": "Deal-01",
"correlationId": "W0-EVT-01",
"dependsOn": []
},
"evidence": {
"dealId": "otd_5830eda3",
"workflow": "workflow-f94ad675",
"dealType": "Deal-01",
"vehicleId": "vehicle_e0f369b5",
"buyerId": "party_dc824172",
"sellerId": "party_d098ecce",
"dealerOfRecordId": "dealer_3fdb999c",
"authority": "mandate_2631713d",
"structure": "Deal-01",
"state": "Deal-01",
"correlationId": "W0-EVT-01",
"dependsOn": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "otd-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}More actions
recap
otd.recap · GET /otds/recap · gate key · sandbox · answers OtdRecap@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — taxes.vin serves this noun on its two routes: / (the landing) · /3GKALVEVXML396352 (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 { otd } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await otd.recap({"vin":"3GKALVEVXML396352"})curl 'https://apis.vin/otds/recap?vin=3GKALVEVXML396352'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": "OtdRecap@1",
"value": {
"dealId": "otd_e622a1f0",
"workflow": "workflow-6b6295c2",
"dealType": "Deal-01",
"vehicleId": "vehicle_369ef66c",
"buyerId": "party_c56684ef",
"sellerId": "party_2ba50c71",
"dealerOfRecordId": "dealer_1c1676e3",
"authority": "mandate_6f622500",
"structure": "Deal-01",
"state": "Deal-01",
"correlationId": "W0-EVT-01",
"dependsOn": []
},
"evidence": {
"dealId": "otd_e622a1f0",
"workflow": "workflow-6b6295c2",
"dealType": "Deal-01",
"vehicleId": "vehicle_369ef66c",
"buyerId": "party_c56684ef",
"sellerId": "party_2ba50c71",
"dealerOfRecordId": "dealer_1c1676e3",
"authority": "mandate_6f622500",
"structure": "Deal-01",
"state": "Deal-01",
"correlationId": "W0-EVT-01",
"dependsOn": []
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "otd-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.
Deal
Generated from the catalog. Every capability, answer, gate, and entity on this page is a rendered descriptor — it cannot drift from the wire.