drayage
The drayage noun — identity, lifecycle, events, and every capability as an anchored section: 14 capabilities, 0 live, 14 sandbox, 0 declared.
drayage 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 | drayage |
| Pillar | Data (facets: 5 data · 5 services · 4 commerce) |
| Capabilities | 14 — 0 live · 14 sandbox · 0 declared |
| Entities | Transport |
| Doors | aggregator.vin |
| SDK | Vin.drayage.* from apis.vin |
| Address | /catalog/drayage#{action} — the anchor IS the wire name minus drayage. |
Events
The vocabulary this noun can append to the record — 26 past-tense, versioned event types, each linked to the capability that emits it:
Drayage.completed@1— emitted byorderDrayage.deliverFailed@1— emitted bydeliverDrayage.deliverRequested@1— emitted bydeliverDrayage.delivered@1— emitted bydeliverDrayage.dispatchFailed@1— emitted bydispatchDrayage.dispatchRequested@1— emitted bydispatchDrayage.dispatched@1— emitted bydispatch·orderDrayage.emptyReturned@1— emitted byreturnEmptyDrayage.etaUpdated@1— emitted byetaDrayage.ordered@1— emitted byorderDrayage.paid@1— emitted bypayDrayage.payFailed@1— emitted bypayDrayage.payRequested@1— emitted bypayDrayage.perDiemBillRequested@1— emitted byperDiemBillDrayage.perDiemBilled@1— emitted byperDiemBillDrayage.pullRequested@1— emitted bypullDrayage.pulled@1— emitted bypullDrayage.quoted@1— emitted byquoteDrayage.rated@1— emitted byrateDrayage.returnEmptyRequested@1— emitted byreturnEmptyDrayage.scheduleRequested@1— emitted byscheduleDrayage.scheduled@1— emitted byscheduleDrayage.settleFailed@1— emitted bysettleDrayage.settleRequested@1— emitted bysettleDrayage.settled@1— emitted bysettleServiceOrder.settled@1— emitted byorder
Discover & read
track
drayage.track · GET /drayages/track · gate none · sandbox · answers DrayageTrack@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /5XYP64GC1PG351010 (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 { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.track({"vin":"5XYP64GC1PG351010"})curl 'https://apis.vin/drayages/track?vin=5XYP64GC1PG351010'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": "DrayageTrack@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"tracking": {
"moveId": "DY-1296bd73",
"standing": "discharged",
"milesRemaining": 0
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"tracking": {
"moveId": "DY-1296bd73",
"standing": "discharged",
"milesRemaining": 0
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}eta
drayage.eta · GET /drayages/eta · gate key · sandbox · answers DrayageEta@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /5XYP64GC1PG351010 (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 — Drayage.etaUpdated@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.eta({"vin":"5XYP64GC1PG351010"})curl 'https://apis.vin/drayages/eta?vin=5XYP64GC1PG351010'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": "DrayageEta@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"eta": {
"status": "arrived",
"etaDays": 0,
"etaDate": "2026-08-10"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"eta": {
"status": "arrived",
"etaDays": 0,
"etaDate": "2026-08-10"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}chassisAvailability
drayage.chassisAvailability · GET /drayages/chassis-availability · gate none · sandbox · answers DrayageChassisAvailability@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /5XYP64GC1PG351010 (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 { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.chassisAvailability({"vin":"5XYP64GC1PG351010"})curl 'https://apis.vin/drayages/chassis-availability?vin=5XYP64GC1PG351010'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": "DrayageChassisAvailability@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"chassis": {
"poolAvailable": 10,
"available": true
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"chassis": {
"poolAvailable": 10,
"available": true
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Quote & price
quote
drayage.quote · GET /drayages/quote · gate key · sandbox · answers DrayageQuote@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /5XYP64GC1PG351010 (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 — Drayage.quoted@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.quote({"vin":"5XYP64GC1PG351010"})curl 'https://apis.vin/drayages/quote?vin=5XYP64GC1PG351010'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": "DrayageQuote@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"quote": {
"id": "DQ-7003c80a",
"rateCents": 25731,
"currency": "USD",
"status": "extended"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"quote": {
"id": "DQ-7003c80a",
"rateCents": 25731,
"currency": "USD",
"status": "extended"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}rate
drayage.rate · GET /drayages/rate · gate key · sandbox · answers DrayageRate@1
| Field | Type | Required | Notes |
|---|---|---|---|
vin | string | no | — |
Door — aggregator.vin serves this noun on its two routes: / (the landing) · /5XYP64GC1PG351010 (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 — Drayage.rated@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.rate({"vin":"5XYP64GC1PG351010"})curl 'https://apis.vin/drayages/rate?vin=5XYP64GC1PG351010'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": "DrayageRate@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"quote": {
"id": "DQ-7003c80a",
"rateCents": 25731,
"currency": "USD",
"status": "tariff"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"quote": {
"id": "DQ-7003c80a",
"rateCents": 25731,
"currency": "USD",
"status": "tariff"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Apply & book
order
drayage.order · POST /drayages/order · gate offer · sandbox · answers DrayageOrder@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) · /5XYP64GC1PG351010 (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 — Drayage.completed@1 · Drayage.dispatched@1 · Drayage.ordered@1 · ServiceOrder.settled@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.order({"vin":"5XYP64GC1PG351010"})curl -X POST https://apis.vin/drayages/order \
-H 'content-type: application/json' \
-d '{"vin":"5XYP64GC1PG351010"}'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": "DrayageOrder@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"order": {
"id": "ORD-cacc971e",
"service": "drayage-move",
"status": "placed",
"amountCents": 25731,
"currency": "USD"
},
"payer": {
"name": "Ava Good",
"castRow": "super-prime",
"creditTier": "super-prime"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"order": {
"id": "ORD-cacc971e",
"service": "drayage-move",
"status": "placed",
"amountCents": 25731,
"currency": "USD"
},
"payer": {
"name": "Ava Good",
"castRow": "super-prime",
"creditTier": "super-prime"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}schedule
drayage.schedule · POST /drayages/schedule · gate offer · sandbox · answers DrayageSchedule@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) · /5XYP64GC1PG351010 (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 — Drayage.scheduleRequested@1 · Drayage.scheduled@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.schedule({"vin":"5XYP64GC1PG351010"})curl -X POST https://apis.vin/drayages/schedule \
-H 'content-type: application/json' \
-d '{"vin":"5XYP64GC1PG351010"}'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": "DrayageSchedule@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"schedule": {
"moveId": "DY-1296bd73",
"date": "2026-08-13",
"status": "scheduled"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"schedule": {
"moveId": "DY-1296bd73",
"date": "2026-08-13",
"status": "scheduled"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}dispatch
drayage.dispatch · POST /drayages/dispatch · gate offer · sandbox · answers DrayageDispatch@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) · /5XYP64GC1PG351010 (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 — Drayage.dispatchFailed@1 · Drayage.dispatchRequested@1 · Drayage.dispatched@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.dispatch({"vin":"5XYP64GC1PG351010"})curl -X POST https://apis.vin/drayages/dispatch \
-H 'content-type: application/json' \
-d '{"vin":"5XYP64GC1PG351010"}'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": "DrayageDispatch@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"dispatch": {
"moveId": "DY-1296bd73",
"status": "dispatched",
"driver": "DRV-777e9358"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"dispatch": {
"moveId": "DY-1296bd73",
"status": "dispatched",
"driver": "DRV-777e9358"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Pay & settle
pay
drayage.pay · POST /drayages/pay · gate offer · sandbox · answers DrayagePay@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) · /5XYP64GC1PG351010 (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 — Drayage.paid@1 · Drayage.payFailed@1 · Drayage.payRequested@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.pay({"vin":"5XYP64GC1PG351010"})curl -X POST https://apis.vin/drayages/pay \
-H 'content-type: application/json' \
-d '{"vin":"5XYP64GC1PG351010"}'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": "DrayagePay@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"payment": {
"id": "PAY-2b9bbcc0",
"status": "settled",
"amountCents": 25731,
"currency": "USD"
},
"payer": {
"name": "Ava Good",
"castRow": "super-prime",
"creditTier": "super-prime"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"payment": {
"id": "PAY-2b9bbcc0",
"status": "settled",
"amountCents": 25731,
"currency": "USD"
},
"payer": {
"name": "Ava Good",
"castRow": "super-prime",
"creditTier": "super-prime"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}settle
drayage.settle · POST /drayages/settle · gate offer · sandbox · answers DrayageSettle@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) · /5XYP64GC1PG351010 (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 — Drayage.settleFailed@1 · Drayage.settleRequested@1 · Drayage.settled@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.settle({"vin":"5XYP64GC1PG351010"})curl -X POST https://apis.vin/drayages/settle \
-H 'content-type: application/json' \
-d '{"vin":"5XYP64GC1PG351010"}'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": "DrayageSettle@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"payment": {
"id": "PAY-b08af969",
"status": "settled",
"amountCents": 25731,
"currency": "USD"
},
"payer": {
"name": "Ava Good",
"castRow": "super-prime",
"creditTier": "super-prime"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"payment": {
"id": "PAY-b08af969",
"status": "settled",
"amountCents": 25731,
"currency": "USD"
},
"payer": {
"name": "Ava Good",
"castRow": "super-prime",
"creditTier": "super-prime"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}perDiemBill
drayage.perDiemBill · POST /drayages/per-diem-bill · gate offer · sandbox · answers DrayagePerDiemBill@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) · /5XYP64GC1PG351010 (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 — Drayage.perDiemBillRequested@1 · Drayage.perDiemBilled@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.perDiemBill({"vin":"5XYP64GC1PG351010"})curl -X POST https://apis.vin/drayages/per-diem-bill \
-H 'content-type: application/json' \
-d '{"vin":"5XYP64GC1PG351010"}'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": "DrayagePerDiemBill@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"bill": {
"status": "no-per-diem",
"amountCents": 0,
"currency": "USD"
},
"payer": {
"name": "Ava Good",
"castRow": "super-prime",
"creditTier": "super-prime"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"bill": {
"status": "no-per-diem",
"amountCents": 0,
"currency": "USD"
},
"payer": {
"name": "Ava Good",
"castRow": "super-prime",
"creditTier": "super-prime"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}Fulfill & operate
deliver
drayage.deliver · POST /drayages/deliver · gate offer · sandbox · answers DrayageDeliver@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) · /5XYP64GC1PG351010 (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 — Drayage.deliverFailed@1 · Drayage.deliverRequested@1 · Drayage.delivered@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.deliver({"vin":"5XYP64GC1PG351010"})curl -X POST https://apis.vin/drayages/deliver \
-H 'content-type: application/json' \
-d '{"vin":"5XYP64GC1PG351010"}'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": "DrayageDeliver@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"delivery": {
"moveId": "DY-1296bd73",
"status": "delivered"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"delivery": {
"moveId": "DY-1296bd73",
"status": "delivered"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}More actions
pull
drayage.pull · POST /drayages/pull · gate offer · sandbox · answers DrayagePull@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) · /5XYP64GC1PG351010 (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 — Drayage.pullRequested@1 · Drayage.pulled@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.pull({"vin":"5XYP64GC1PG351010"})curl -X POST https://apis.vin/drayages/pull \
-H 'content-type: application/json' \
-d '{"vin":"5XYP64GC1PG351010"}'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": "DrayagePull@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"pull": {
"id": "PL-fa7892d5",
"status": "pulled",
"chassis": "CH-317e199e"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"pull": {
"id": "PL-fa7892d5",
"status": "pulled",
"chassis": "CH-317e199e"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-sandbox"
},
"events": [],
"meter": {
"charged": "0.00",
"posted": false
}
}returnEmpty
drayage.returnEmpty · POST /drayages/return-empty · gate offer · sandbox · answers DrayageReturnEmpty@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) · /5XYP64GC1PG351010 (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 — Drayage.emptyReturned@1 · Drayage.returnEmptyRequested@1.
import { drayage } from 'apis.vin'
// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await drayage.returnEmpty({"vin":"5XYP64GC1PG351010"})curl -X POST https://apis.vin/drayages/return-empty \
-H 'content-type: application/json' \
-d '{"vin":"5XYP64GC1PG351010"}'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": "DrayageReturnEmpty@1",
"value": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"return": {
"id": "RE-4f3c8d50",
"status": "returned"
}
},
"evidence": {
"vin": "5XYP64GC1PG351010",
"noun": "drayage",
"asOf": "2026-08-10",
"standing": "discharged",
"return": {
"id": "RE-4f3c8d50",
"status": "returned"
}
},
"provenance": {
"simulated": true,
"environment": "sandbox",
"source": "long-haul-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.
Transport
Generated from the catalog. Every capability, answer, gate, and entity on this page is a rendered descriptor — it cannot drift from the wire.