docs.vin

fiReserve

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

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

Identity

NounfiReserve
PillarCommerce (facets: 2 data · 3 commerce)
Capabilities5 — 0 live · 5 sandbox · 0 declared
EntitiesPayout
Doorsaggregator.vin
SDKVin.fiReserve.* from apis.vin
Address/catalog/fiReserve#{action} — the anchor IS the wire name minus fiReserve.

Events

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

Quote & price

compute

fiReserve.compute · GET /fi-reserves/compute · gate key · sandbox · answers FiReserveCompute@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fiReserve.compute({"vin":"2C4RC1N74LR102440"})
GET /fi-reserves/compute
curl 'https://apis.vin/fi-reserves/compute?vin=2C4RC1N74LR102440'

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:11.607Z · HTTP 200
{
  "type": "OK",
  "answers": "FiReserveCompute@1",
  "value": {
    "vin": "2C4RC1N74LR102440",
    "noun": "fiReserve",
    "asOf": "2026-08-10",
    "id": "PYO-3c60a035",
    "payeeId": "DLR-b9066ade",
    "amount": {
      "amountCents": 150270,
      "currency": "USD",
      "basis": "holdback-plus-fi-reserve",
      "items": [
        {
          "kind": "holdback",
          "amountCents": 115770,
          "basis": "msrp-holdback"
        },
        {
          "kind": "fi-reserve",
          "amountCents": 34500,
          "basis": "rate-spread"
        }
      ]
    },
    "reserve": {
      "amountCents": 34500,
      "currency": "USD",
      "basis": "rate-spread",
      "basisPoints": 150
    }
  },
  "evidence": {
    "vin": "2C4RC1N74LR102440",
    "noun": "fiReserve",
    "asOf": "2026-08-10",
    "id": "PYO-3c60a035",
    "payeeId": "DLR-b9066ade",
    "amount": {
      "amountCents": 150270,
      "currency": "USD",
      "basis": "holdback-plus-fi-reserve",
      "items": [
        {
          "kind": "holdback",
          "amountCents": 115770,
          "basis": "msrp-holdback"
        },
        {
          "kind": "fi-reserve",
          "amountCents": 34500,
          "basis": "rate-spread"
        }
      ]
    },
    "reserve": {
      "amountCents": 34500,
      "currency": "USD",
      "basis": "rate-spread",
      "basisPoints": 150
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "treasury-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

chargeback

fiReserve.chargeback · POST /fi-reserves/chargeback · gate offer · sandbox · answers FiReserveChargeback@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) · /2C4RC1N74LR102440 (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 — FiReserve.chargedBack@1 · FiReserve.failed@1.

the SDK — fiReserve.chargeback
import { fiReserve } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fiReserve.chargeback({"vin":"2C4RC1N74LR102440"})
POST /fi-reserves/chargeback
curl -X POST https://apis.vin/fi-reserves/chargeback \
  -H 'content-type: application/json' \
  -d '{"vin":"2C4RC1N74LR102440"}'

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:11.607Z · HTTP 200
{
  "type": "OK",
  "answers": "FiReserveChargeback@1",
  "value": {
    "vin": "2C4RC1N74LR102440",
    "noun": "fiReserve",
    "asOf": "2026-08-10",
    "id": "PYO-3c60a035",
    "payeeId": "DLR-b9066ade",
    "amount": {
      "amountCents": 150270,
      "currency": "USD",
      "basis": "holdback-plus-fi-reserve",
      "items": [
        {
          "kind": "holdback",
          "amountCents": 115770,
          "basis": "msrp-holdback"
        },
        {
          "kind": "fi-reserve",
          "amountCents": 34500,
          "basis": "rate-spread"
        }
      ]
    },
    "chargeback": {
      "status": "no-grounds"
    }
  },
  "evidence": {
    "vin": "2C4RC1N74LR102440",
    "noun": "fiReserve",
    "asOf": "2026-08-10",
    "id": "PYO-3c60a035",
    "payeeId": "DLR-b9066ade",
    "amount": {
      "amountCents": 150270,
      "currency": "USD",
      "basis": "holdback-plus-fi-reserve",
      "items": [
        {
          "kind": "holdback",
          "amountCents": 115770,
          "basis": "msrp-holdback"
        },
        {
          "kind": "fi-reserve",
          "amountCents": 34500,
          "basis": "rate-spread"
        }
      ]
    },
    "chargeback": {
      "status": "no-grounds"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "treasury-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

split

fiReserve.split · POST /fi-reserves/split · gate offer · sandbox · answers FiReserveSplit@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) · /2C4RC1N74LR102440 (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 — FiReserve.failed@1 · FiReserve.split@1.

the SDK — fiReserve.split
import { fiReserve } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fiReserve.split({"vin":"2C4RC1N74LR102440"})
POST /fi-reserves/split
curl -X POST https://apis.vin/fi-reserves/split \
  -H 'content-type: application/json' \
  -d '{"vin":"2C4RC1N74LR102440"}'

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:11.608Z · HTTP 200
{
  "type": "OK",
  "answers": "FiReserveSplit@1",
  "value": {
    "vin": "2C4RC1N74LR102440",
    "noun": "fiReserve",
    "asOf": "2026-08-10",
    "id": "PYO-3c60a035",
    "payeeId": "DLR-b9066ade",
    "amount": {
      "amountCents": 150270,
      "currency": "USD",
      "basis": "holdback-plus-fi-reserve",
      "items": [
        {
          "kind": "holdback",
          "amountCents": 115770,
          "basis": "msrp-holdback"
        },
        {
          "kind": "fi-reserve",
          "amountCents": 34500,
          "basis": "rate-spread"
        }
      ]
    },
    "split": {
      "participation": "rate-spread",
      "basisPoints": 150,
      "dealerCents": 34500,
      "currency": "USD",
      "flat": {
        "offered": false,
        "participation": "rate-spread",
        "reason": "no-flat-schedule-posted"
      }
    }
  },
  "evidence": {
    "vin": "2C4RC1N74LR102440",
    "noun": "fiReserve",
    "asOf": "2026-08-10",
    "id": "PYO-3c60a035",
    "payeeId": "DLR-b9066ade",
    "amount": {
      "amountCents": 150270,
      "currency": "USD",
      "basis": "holdback-plus-fi-reserve",
      "items": [
        {
          "kind": "holdback",
          "amountCents": 115770,
          "basis": "msrp-holdback"
        },
        {
          "kind": "fi-reserve",
          "amountCents": 34500,
          "basis": "rate-spread"
        }
      ]
    },
    "split": {
      "participation": "rate-spread",
      "basisPoints": 150,
      "dealerCents": 34500,
      "currency": "USD",
      "flat": {
        "offered": false,
        "participation": "rate-spread",
        "reason": "no-flat-schedule-posted"
      }
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "treasury-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

reinsurance

fiReserve.reinsurance · POST /fi-reserves/reinsurance · gate offer · sandbox · answers FiReserveReinsurance@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) · /2C4RC1N74LR102440 (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 — FiReserve.failed@1 · FiReserve.reinsuranceCeded@1.

the SDK — fiReserve.reinsurance
import { fiReserve } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fiReserve.reinsurance({"vin":"2C4RC1N74LR102440"})
POST /fi-reserves/reinsurance
curl -X POST https://apis.vin/fi-reserves/reinsurance \
  -H 'content-type: application/json' \
  -d '{"vin":"2C4RC1N74LR102440"}'

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:11.607Z · HTTP 200
{
  "type": "OK",
  "answers": "FiReserveReinsurance@1",
  "value": {
    "vin": "2C4RC1N74LR102440",
    "noun": "fiReserve",
    "asOf": "2026-08-10",
    "id": "PYO-3c60a035",
    "payeeId": "DLR-b9066ade",
    "amount": {
      "amountCents": 150270,
      "currency": "USD",
      "basis": "holdback-plus-fi-reserve",
      "items": [
        {
          "kind": "holdback",
          "amountCents": 115770,
          "basis": "msrp-holdback"
        },
        {
          "kind": "fi-reserve",
          "amountCents": 34500,
          "basis": "rate-spread"
        }
      ]
    },
    "reinsurance": {
      "status": "not-posted",
      "basis": "no-reinsurance-treaty-anchor"
    }
  },
  "evidence": {
    "vin": "2C4RC1N74LR102440",
    "noun": "fiReserve",
    "asOf": "2026-08-10",
    "id": "PYO-3c60a035",
    "payeeId": "DLR-b9066ade",
    "amount": {
      "amountCents": 150270,
      "currency": "USD",
      "basis": "holdback-plus-fi-reserve",
      "items": [
        {
          "kind": "holdback",
          "amountCents": 115770,
          "basis": "msrp-holdback"
        },
        {
          "kind": "fi-reserve",
          "amountCents": 34500,
          "basis": "rate-spread"
        }
      ]
    },
    "reinsurance": {
      "status": "not-posted",
      "basis": "no-reinsurance-treaty-anchor"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "treasury-desk-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

statement

fiReserve.statement · GET /fi-reserves/statement · gate key · sandbox · answers FiReserveStatement@1

FieldTypeRequiredNotes
vinstringno—

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

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fiReserve.statement({"vin":"2C4RC1N74LR102440"})
GET /fi-reserves/statement
curl 'https://apis.vin/fi-reserves/statement?vin=2C4RC1N74LR102440'

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:11.612Z · HTTP 200
{
  "type": "OK",
  "answers": "FiReserveStatement@1",
  "value": {
    "vin": "2C4RC1N74LR102440",
    "noun": "fiReserve",
    "asOf": "2026-08-10",
    "id": "PYO-3c60a035",
    "payeeId": "DLR-b9066ade",
    "amount": {
      "amountCents": 150270,
      "currency": "USD",
      "basis": "holdback-plus-fi-reserve",
      "items": [
        {
          "kind": "holdback",
          "amountCents": 115770,
          "basis": "msrp-holdback"
        },
        {
          "kind": "fi-reserve",
          "amountCents": 34500,
          "basis": "rate-spread"
        }
      ]
    },
    "statement": {
      "id": "FRS-ae6f6602",
      "amountCents": 34500,
      "currency": "USD",
      "basis": "rate-spread",
      "payeeId": "DLR-b9066ade",
      "status": "stated"
    }
  },
  "evidence": {
    "vin": "2C4RC1N74LR102440",
    "noun": "fiReserve",
    "asOf": "2026-08-10",
    "id": "PYO-3c60a035",
    "payeeId": "DLR-b9066ade",
    "amount": {
      "amountCents": 150270,
      "currency": "USD",
      "basis": "holdback-plus-fi-reserve",
      "items": [
        {
          "kind": "holdback",
          "amountCents": 115770,
          "basis": "msrp-holdback"
        },
        {
          "kind": "fi-reserve",
          "amountCents": 34500,
          "basis": "rate-spread"
        }
      ]
    },
    "statement": {
      "id": "FRS-ae6f6602",
      "amountCents": 34500,
      "currency": "USD",
      "basis": "rate-spread",
      "payeeId": "DLR-b9066ade",
      "status": "stated"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "treasury-desk-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.

Payout

Modeled

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

FiReserve · Class model

FiReserve · State machine

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

escrow

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

floorplan

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

On this page

Identity
Events
Quote & price
compute
Pay & settle
chargeback
Fulfill & operate
split
More actions
reinsurance
statement
Data model
Payout
Modeled