docs.vin

longhaul

The longhaul noun — identity, lifecycle, events, and every capability as an anchored section: 15 capabilities, 0 live, 15 sandbox, 0 declared.

longhaul is one of the estate's 317 automotive nouns — a job a car needs done. It carries 15 capabilities: 0 live, 15 sandbox, 0 declared · doors aggregator.vin.

Identity

Nounlonghaul
PillarData (facets: 6 data · 5 services · 4 commerce)
Capabilities15 — 0 live · 15 sandbox · 0 declared
EntitiesTransport
Doorsaggregator.vin
SDKVin.longhaul.* from apis.vin
Address/catalog/longhaul#{action} — the anchor IS the wire name minus longhaul.

Events

The vocabulary this noun can append to the record — 26 past-tense, versioned event types, each linked to the capability that emits it:

Discover & read

status

longhaul.status · GET /longhauls/status · gate none · sandbox · answers LonghaulStatus@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — longhaul.status
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.status({"vin":"1N6ED1EK5RN672093"})
GET /longhauls/status
curl 'https://apis.vin/longhauls/status?vin=1N6ED1EK5RN672093'

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:14.001Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulStatus@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "tracking": {
      "loadId": "LD-b99c406a",
      "status": "dispatched",
      "milesRemaining": 0
    },
    "carrierId": "CARR-a3b07d5f"
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "tracking": {
      "loadId": "LD-b99c406a",
      "status": "dispatched",
      "milesRemaining": 0
    },
    "carrierId": "CARR-a3b07d5f"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "long-haul-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

track

longhaul.track · GET /longhauls/track · gate none · sandbox · answers LonghaulTrack@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — longhaul.track
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.track({"vin":"1N6ED1EK5RN672093"})
GET /longhauls/track
curl 'https://apis.vin/longhauls/track?vin=1N6ED1EK5RN672093'

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:14.005Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulTrack@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "tracking": {
      "loadId": "LD-b99c406a",
      "status": "dispatched",
      "milesRemaining": 0
    },
    "carrierId": "CARR-a3b07d5f"
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "tracking": {
      "loadId": "LD-b99c406a",
      "status": "dispatched",
      "milesRemaining": 0
    },
    "carrierId": "CARR-a3b07d5f"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "long-haul-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

eta

longhaul.eta · GET /longhauls/eta · gate key · sandbox · answers LonghaulEta@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.etaUpdated@1.

the SDK — longhaul.eta
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.eta({"vin":"1N6ED1EK5RN672093"})
GET /longhauls/eta
curl 'https://apis.vin/longhauls/eta?vin=1N6ED1EK5RN672093'

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:13.966Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulEta@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "eta": {
      "status": "projected",
      "etaDays": 8,
      "etaDate": "2026-08-18"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "eta": {
      "status": "projected",
      "etaDays": 8,
      "etaDate": "2026-08-18"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "long-haul-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

capacity

longhaul.capacity · GET /longhauls/capacity · gate none · sandbox · answers LonghaulCapacity@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — longhaul.capacity
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.capacity({"vin":"1N6ED1EK5RN672093"})
GET /longhauls/capacity
curl 'https://apis.vin/longhauls/capacity?vin=1N6ED1EK5RN672093'

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:13.966Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulCapacity@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "trucksPerWeek": 17,
    "available": true
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "trucksPerWeek": 17,
    "available": true
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "long-haul-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Quote & price

quote

longhaul.quote · GET /longhauls/quote · gate key · sandbox · answers LonghaulQuote@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.quoted@1.

the SDK — longhaul.quote
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.quote({"vin":"1N6ED1EK5RN672093"})
GET /longhauls/quote
curl 'https://apis.vin/longhauls/quote?vin=1N6ED1EK5RN672093'

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:13.990Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulQuote@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "quote": {
      "id": "LQ-ae63beca",
      "rateCents": 89500,
      "currency": "USD",
      "status": "extended"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "quote": {
      "id": "LQ-ae63beca",
      "rateCents": 89500,
      "currency": "USD",
      "status": "extended"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "long-haul-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

laneRate

longhaul.laneRate · GET /longhauls/lane-rate · gate key · sandbox · answers LonghaulLaneRate@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.laneRated@1.

the SDK — longhaul.laneRate
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.laneRate({"vin":"1N6ED1EK5RN672093"})
GET /longhauls/lane-rate
curl 'https://apis.vin/longhauls/lane-rate?vin=1N6ED1EK5RN672093'

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:13.968Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulLaneRate@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "quote": {
      "id": "LQ-ae63beca",
      "rateCents": 89500,
      "currency": "USD",
      "status": "lane-tariff"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "quote": {
      "id": "LQ-ae63beca",
      "rateCents": 89500,
      "currency": "USD",
      "status": "lane-tariff"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "long-haul-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

order

longhaul.order · POST /longhauls/order · gate offer · sandbox · answers LonghaulOrder@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.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.completed@1 · Longhaul.dispatched@1 · Longhaul.ordered@1 · ServiceOrder.settled@1.

the SDK — longhaul.order
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.order({"vin":"1N6ED1EK5RN672093"})
POST /longhauls/order
curl -X POST https://apis.vin/longhauls/order \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK5RN672093"}'

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:13.971Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulOrder@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "order": {
      "id": "ORD-efdfd8de",
      "service": "long-haul-move",
      "status": "placed",
      "amountCents": 89500,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "order": {
      "id": "ORD-efdfd8de",
      "service": "long-haul-move",
      "status": "placed",
      "amountCents": 89500,
      "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

longhaul.schedule · POST /longhauls/schedule · gate offer · sandbox · answers LonghaulSchedule@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.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.scheduleRequested@1 · Longhaul.scheduled@1.

the SDK — longhaul.schedule
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.schedule({"vin":"1N6ED1EK5RN672093"})
POST /longhauls/schedule
curl -X POST https://apis.vin/longhauls/schedule \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK5RN672093"}'

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:13.997Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulSchedule@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "schedule": {
      "loadId": "LD-b99c406a",
      "pickupDate": "2026-08-11",
      "status": "scheduled"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "schedule": {
      "loadId": "LD-b99c406a",
      "pickupDate": "2026-08-11",
      "status": "scheduled"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "long-haul-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

dispatch

longhaul.dispatch · POST /longhauls/dispatch · gate offer · sandbox · answers LonghaulDispatch@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.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.dispatchFailed@1 · Longhaul.dispatchRequested@1 · Longhaul.dispatched@1.

the SDK — longhaul.dispatch
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.dispatch({"vin":"1N6ED1EK5RN672093"})
POST /longhauls/dispatch
curl -X POST https://apis.vin/longhauls/dispatch \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK5RN672093"}'

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:13.966Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulDispatch@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "dispatch": {
      "status": "already-dispatched"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "dispatch": {
      "status": "already-dispatched"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "long-haul-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

longhaul.pay · POST /longhauls/pay · gate offer · sandbox · answers LonghaulPay@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.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.paid@1 · Longhaul.payFailed@1 · Longhaul.payRequested@1.

the SDK — longhaul.pay
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.pay({"vin":"1N6ED1EK5RN672093"})
POST /longhauls/pay
curl -X POST https://apis.vin/longhauls/pay \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK5RN672093"}'

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:13.971Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulPay@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "payment": {
      "id": "PAY-29c75880",
      "status": "settled",
      "amountCents": 89500,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "payment": {
      "id": "PAY-29c75880",
      "status": "settled",
      "amountCents": 89500,
      "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

longhaul.settle · POST /longhauls/settle · gate offer · sandbox · answers LonghaulSettle@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.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.settleFailed@1 · Longhaul.settleRequested@1 · Longhaul.settled@1.

the SDK — longhaul.settle
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.settle({"vin":"1N6ED1EK5RN672093"})
POST /longhauls/settle
curl -X POST https://apis.vin/longhauls/settle \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK5RN672093"}'

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:13.998Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulSettle@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "payment": {
      "id": "PAY-05d61529",
      "status": "settled",
      "amountCents": 89500,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "payment": {
      "id": "PAY-05d61529",
      "status": "settled",
      "amountCents": 89500,
      "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
  }
}

fuelSurcharge

longhaul.fuelSurcharge · POST /longhauls/fuel-surcharge · gate offer · sandbox · answers LonghaulFuelSurcharge@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.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.fuelSurchargeRequested@1 · Longhaul.fuelSurcharged@1.

the SDK — longhaul.fuelSurcharge
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.fuelSurcharge({"vin":"1N6ED1EK5RN672093"})
POST /longhauls/fuel-surcharge
curl -X POST https://apis.vin/longhauls/fuel-surcharge \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK5RN672093"}'

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:13.966Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulFuelSurcharge@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "surcharge": {
      "kind": "fuel",
      "pct": 14,
      "amountCents": 12530,
      "basisCents": 89500,
      "currency": "USD"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "surcharge": {
      "kind": "fuel",
      "pct": 14,
      "amountCents": 12530,
      "basisCents": 89500,
      "currency": "USD"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "long-haul-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

deliver

longhaul.deliver · POST /longhauls/deliver · gate offer · sandbox · answers LonghaulDeliver@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.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.deliverFailed@1 · Longhaul.deliverRequested@1 · Longhaul.delivered@1.

the SDK — longhaul.deliver
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.deliver({"vin":"1N6ED1EK5RN672093"})
POST /longhauls/deliver
curl -X POST https://apis.vin/longhauls/deliver \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK5RN672093"}'

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:13.966Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulDeliver@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "delivery": {
      "loadId": "LD-b99c406a",
      "status": "delivery-pending"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "delivery": {
      "loadId": "LD-b99c406a",
      "status": "delivery-pending"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "long-haul-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

linehaul

longhaul.linehaul · POST /longhauls/linehaul · gate offer · sandbox · answers LonghaulLinehaul@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.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.linehaulRequested@1 · Longhaul.linehauled@1.

the SDK — longhaul.linehaul
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.linehaul({"vin":"1N6ED1EK5RN672093"})
POST /longhauls/linehaul
curl -X POST https://apis.vin/longhauls/linehaul \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK5RN672093"}'

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:13.968Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulLinehaul@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "linehaul": {
      "loadId": "LD-b99c406a",
      "carrierId": "CARR-a3b07d5f",
      "rateCents": 89500,
      "currency": "USD",
      "status": "dispatched"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "linehaul": {
      "loadId": "LD-b99c406a",
      "carrierId": "CARR-a3b07d5f",
      "rateCents": 89500,
      "currency": "USD",
      "status": "dispatched"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "long-haul-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

relay

longhaul.relay · POST /longhauls/relay · gate offer · sandbox · answers LonghaulRelay@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.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1N6ED1EK5RN672093 (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 — Longhaul.relayRequested@1 · Longhaul.relayed@1.

the SDK — longhaul.relay
import { longhaul } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await longhaul.relay({"vin":"1N6ED1EK5RN672093"})
POST /longhauls/relay
curl -X POST https://apis.vin/longhauls/relay \
  -H 'content-type: application/json' \
  -d '{"vin":"1N6ED1EK5RN672093"}'

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:13.991Z · HTTP 200
{
  "type": "OK",
  "answers": "LonghaulRelay@1",
  "value": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "relay": {
      "status": "not-underway"
    }
  },
  "evidence": {
    "vin": "1N6ED1EK5RN672093",
    "noun": "longhaul",
    "asOf": "2026-08-10",
    "phase": "Dispatched",
    "relay": {
      "status": "not-underway"
    }
  },
  "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.

load

The load noun — identity, lifecycle, events, and every capability as an anchored section: 21 capabilities, 0 live, 21 sandbox, 0 declared.

maintenance

The maintenance noun — identity, lifecycle, events, and every capability as an anchored section: 24 capabilities, 0 live, 24 sandbox, 0 declared.

On this page

Identity
Events
Discover & read
status
track
eta
capacity
Quote & price
quote
laneRate
Apply & book
order
schedule
dispatch
Pay & settle
pay
settle
fuelSurcharge
Fulfill & operate
deliver
More actions
linehaul
relay
Data model
Transport