docs.vin

carrierFeed

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

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

Identity

NouncarrierFeed
PillarData (facets: 5 data · 5 services · 3 commerce)
Capabilities13 — 0 live · 13 sandbox · 0 declared
EntitiesCarrier
Doorsaggregator.vin
SDKVin.carrierFeed.* from apis.vin
Address/catalog/carrierFeed#{action} — the anchor IS the wire name minus carrierFeed.

Events

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

Discover & read

read

carrierFeed.read · GET /carrier-feeds/read · gate none · sandbox · answers CarrierFeedRead@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await carrierFeed.read({"vin":"LRBFZSR45PD062769"})
GET /carrier-feeds/read
curl 'https://apis.vin/carrier-feeds/read?vin=LRBFZSR45PD062769'

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:08.855Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedRead@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "feed": {
      "id": "FEED-a94dc39f",
      "stream": "move-status",
      "status": "active"
    },
    "carrier": {
      "id": "CARR-c24360fe",
      "class": "auto-transport",
      "equipment": "open",
      "standing": "good"
    }
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "feed": {
      "id": "FEED-a94dc39f",
      "stream": "move-status",
      "status": "active"
    },
    "carrier": {
      "id": "CARR-c24360fe",
      "class": "auto-transport",
      "equipment": "open",
      "standing": "good"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

track

carrierFeed.track · GET /carrier-feeds/track · gate key · sandbox · answers CarrierFeedTrack@1

FieldTypeRequiredNotes
vinstringno—

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

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

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:08.858Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedTrack@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "tracking": {
      "status": "dispatched",
      "milesRemaining": 0
    }
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "tracking": {
      "status": "dispatched",
      "milesRemaining": 0
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

eta

carrierFeed.eta · GET /carrier-feeds/eta · gate key · sandbox · answers CarrierFeedEta@1

FieldTypeRequiredNotes
vinstringno—

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

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

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:08.853Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedEta@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "eta": {
      "loadId": "LD-d3c58b13",
      "etaDays": 6,
      "status": "dispatched"
    }
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "eta": {
      "loadId": "LD-d3c58b13",
      "etaDays": 6,
      "status": "dispatched"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

coverage

carrierFeed.coverage · GET /carrier-feeds/coverage · gate key · sandbox · answers CarrierFeedCoverage@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await carrierFeed.coverage({"vin":"LRBFZSR45PD062769"})
GET /carrier-feeds/coverage
curl 'https://apis.vin/carrier-feeds/coverage?vin=LRBFZSR45PD062769'

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:08.852Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedCoverage@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "coverage": {
      "coveredLanes": 9,
      "regions": [
        "west",
        "mountain",
        "central"
      ]
    }
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "coverage": {
      "coveredLanes": 9,
      "regions": [
        "west",
        "mountain",
        "central"
      ]
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

pullStatus

carrierFeed.pullStatus · POST /carrier-feeds/pull-status · gate offer · sandbox · answers CarrierFeedPullStatus@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) · /LRBFZSR45PD062769 (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 — CarrierFeed.statusPulled@1.

the SDK — carrierFeed.pullStatus
import { carrierFeed } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await carrierFeed.pullStatus({"vin":"LRBFZSR45PD062769"})
POST /carrier-feeds/pull-status
curl -X POST https://apis.vin/carrier-feeds/pull-status \
  -H 'content-type: application/json' \
  -d '{"vin":"LRBFZSR45PD062769"}'

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:08.854Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedPullStatus@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "pull": {
      "loadId": "LD-d3c58b13",
      "status": "dispatched",
      "lastEvent": {
        "at": "2026-08-03",
        "on": "Transport.dispatched@1",
        "from": "Booked",
        "to": "Dispatched",
        "status": "dispatched"
      }
    }
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "pull": {
      "loadId": "LD-d3c58b13",
      "status": "dispatched",
      "lastEvent": {
        "at": "2026-08-03",
        "on": "Transport.dispatched@1",
        "from": "Booked",
        "to": "Dispatched",
        "status": "dispatched"
      }
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

book

carrierFeed.book · POST /carrier-feeds/book · gate offer · sandbox · answers CarrierFeedBook@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) · /LRBFZSR45PD062769 (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 — CarrierFeed.booked@1 · CarrierFeed.failed@1.

the SDK — carrierFeed.book
import { carrierFeed } from 'apis.vin'

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

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:08.852Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedBook@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "load": {
      "id": "LD-d3c58b13",
      "action": "book",
      "status": "booked"
    }
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "load": {
      "id": "LD-d3c58b13",
      "action": "book",
      "status": "booked"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

subscribe

carrierFeed.subscribe · POST /carrier-feeds/subscribe · gate offer · sandbox · answers CarrierFeedSubscribe@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) · /LRBFZSR45PD062769 (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 — CarrierFeed.subscribed@1.

the SDK — carrierFeed.subscribe
import { carrierFeed } from 'apis.vin'

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

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:08.857Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedSubscribe@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "subscription": {
      "id": "FEED-a94dc39f",
      "carrierId": "CARR-c24360fe",
      "status": "active",
      "events": [
        "Transport.dispatched@1",
        "Transport.pickuped@1",
        "Transport.delivered@1",
        "Transport.podCaptured@1",
        "Transport.held@1"
      ]
    }
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "subscription": {
      "id": "FEED-a94dc39f",
      "carrierId": "CARR-c24360fe",
      "status": "active",
      "events": [
        "Transport.dispatched@1",
        "Transport.pickuped@1",
        "Transport.delivered@1",
        "Transport.podCaptured@1",
        "Transport.held@1"
      ]
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

carrierFeed.pay · POST /carrier-feeds/pay · gate offer · sandbox · answers CarrierFeedPay@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) · /LRBFZSR45PD062769 (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 — CarrierFeed.failed@1 · CarrierFeed.paid@1.

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

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

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:08.854Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedPay@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "payment": {
      "id": "PAY-8121aaa3",
      "status": "settled",
      "amountCents": 89500,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "payment": {
      "id": "PAY-8121aaa3",
      "status": "settled",
      "amountCents": 89500,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

reconcile

carrierFeed.reconcile · POST /carrier-feeds/reconcile · gate offer · sandbox · answers CarrierFeedReconcile@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) · /LRBFZSR45PD062769 (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 — CarrierFeed.reconciled@1.

the SDK — carrierFeed.reconcile
import { carrierFeed } from 'apis.vin'

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

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:08.856Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedReconcile@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "reconciliation": {
      "loadId": "LD-d3c58b13",
      "billedCents": 89500,
      "settledCents": 89500,
      "varianceCents": 0,
      "currency": "USD",
      "status": "matched",
      "basis": "one-move-rate"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "reconciliation": {
      "loadId": "LD-d3c58b13",
      "billedCents": 89500,
      "settledCents": 89500,
      "varianceCents": 0,
      "currency": "USD",
      "status": "matched",
      "basis": "one-move-rate"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

carrierFeed.link · POST /carrier-feeds/link · gate offer · sandbox · answers CarrierFeedLink@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) · /LRBFZSR45PD062769 (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 — CarrierFeed.linked@1.

the SDK — carrierFeed.link
import { carrierFeed } from 'apis.vin'

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

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:08.853Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedLink@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "link": {
      "id": "FEED-a94dc39f",
      "carrierId": "CARR-c24360fe",
      "status": "linked"
    }
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "link": {
      "id": "FEED-a94dc39f",
      "carrierId": "CARR-c24360fe",
      "status": "linked"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

pushTender

carrierFeed.pushTender · POST /carrier-feeds/push-tender · gate offer · sandbox · answers CarrierFeedPushTender@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) · /LRBFZSR45PD062769 (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 — CarrierFeed.tenderPushed@1.

the SDK — carrierFeed.pushTender
import { carrierFeed } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await carrierFeed.pushTender({"vin":"LRBFZSR45PD062769"})
POST /carrier-feeds/push-tender
curl -X POST https://apis.vin/carrier-feeds/push-tender \
  -H 'content-type: application/json' \
  -d '{"vin":"LRBFZSR45PD062769"}'

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:08.854Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedPushTender@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "load": {
      "id": "LD-d3c58b13",
      "action": "tender",
      "status": "tendered"
    }
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "load": {
      "id": "LD-d3c58b13",
      "action": "tender",
      "status": "tendered"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

rateShop

carrierFeed.rateShop · POST /carrier-feeds/rate-shop · gate offer · sandbox · answers CarrierFeedRateShop@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) · /LRBFZSR45PD062769 (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 — CarrierFeed.failed@1 · CarrierFeed.rateShopped@1.

the SDK — carrierFeed.rateShop
import { carrierFeed } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await carrierFeed.rateShop({"vin":"LRBFZSR45PD062769"})
POST /carrier-feeds/rate-shop
curl -X POST https://apis.vin/carrier-feeds/rate-shop \
  -H 'content-type: application/json' \
  -d '{"vin":"LRBFZSR45PD062769"}'

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:08.855Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedRateShop@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "quotes": [
      {
        "mode": "rail",
        "rateCents": 53700,
        "currency": "USD"
      },
      {
        "mode": "ocean",
        "rateCents": 71600,
        "currency": "USD"
      },
      {
        "mode": "road",
        "rateCents": 89500,
        "currency": "USD"
      }
    ]
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "quotes": [
      {
        "mode": "rail",
        "rateCents": 53700,
        "currency": "USD"
      },
      {
        "mode": "ocean",
        "rateCents": 71600,
        "currency": "USD"
      },
      {
        "mode": "road",
        "rateCents": 89500,
        "currency": "USD"
      }
    ]
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

statusEvents

carrierFeed.statusEvents · GET /carrier-feeds/status-events · gate key · sandbox · answers CarrierFeedStatusEvents@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await carrierFeed.statusEvents({"vin":"LRBFZSR45PD062769"})
GET /carrier-feeds/status-events
curl 'https://apis.vin/carrier-feeds/status-events?vin=LRBFZSR45PD062769'

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:08.857Z · HTTP 200
{
  "type": "OK",
  "answers": "CarrierFeedStatusEvents@1",
  "value": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "loadId": "LD-d3c58b13",
    "events": [
      {
        "at": "2026-08-03",
        "on": "Transport.dispatched@1",
        "from": "Booked",
        "to": "Dispatched",
        "status": "dispatched"
      }
    ]
  },
  "evidence": {
    "vin": "LRBFZSR45PD062769",
    "noun": "carrierFeed",
    "asOf": "2026-08-10",
    "carrierId": "CARR-c24360fe",
    "phase": "Dispatched",
    "loadId": "LD-d3c58b13",
    "events": [
      {
        "at": "2026-08-03",
        "on": "Transport.dispatched@1",
        "from": "Booked",
        "to": "Dispatched",
        "status": "dispatched"
      }
    ]
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "paper-trail-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.

Carrier

Modeled

The noun drawn out — its record shape, its lifecycle, and how it is exercised end to end. 3 diagrams, rendered from the estate model.

CarrierFeed · Class model

CarrierFeed · State machine

CarrierFeed · Sequence

Generated from the catalog. Every capability, answer, gate, and entity on this page is a rendered descriptor — it cannot drift from the wire.

carrier

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

cashPayment

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

On this page

Identity
Events
Discover & read
read
track
eta
coverage
pullStatus
Apply & book
book
subscribe
Pay & settle
pay
reconcile
More actions
link
pushTender
rateShop
statusEvents
Data model
Carrier
Modeled